Browse / Software development / stepwise-dev

stepwise-dev

nikeyes

Dev workflow for Claude Code

Open nikeyes/stepwise-dev → Does not match the four rules.

Built for Claude Code

ships .claude CLAUDE.md and nothing for other agents.

In its own words

README.mdnikeyes/stepwise-dev

A modular development workflow suite for Claude Code inspired by Ashley Ha's workflow, adapted to work 100% locally with thoughts.

📖 Read more: Tu CLAUDE.md no funciona sin Context Engineering (Spanish article about Stepwise-dev)

🎯 What This Is

Solves the context management problem: LLMs lose attention after 60% context usage.

Implements Research → Plan → Implement → Validate with frequent /clear and persistent thoughts/ storage.

Philosophy
  • Keep context 60% (attention threshold)
  • Split work into phases
  • Clear between phases, save to thoughts/
  • Never lose research or decisions
Why This Workflow With AI

More generated code = more risk if you don't have a solid feedback loop.

The faster AI generates code, the more these practices matter:

  • Story Splitting — AI can produce a lot in little time. If scope isn't cut, chaos scales just as fast.
  • Hamburger Method — Deliver value end-to-end continuously by slicing features into thin vertical layers.
  • Small Safe Steps — Each step must be reversible. Speed of generation is not speed to production.
  • Advanced testing — Mutation, acceptance, and architectural testing. The feedback loop must be solid. No more excuses.

📦 Available Plugins

This repository contains 4 independent plugins that can be installed separately based on your needs:

1. stepwise-core (Core Workflow)

The foundation plugin with the complete Research → Plan → Implement → Validate cycle.

Quoting 22% of the README. Read the rest on GitHub ↗

Read from the repository's git tree on 2026-08-17.