Phase-based development workflow for Claude Code.
dev/what— figure out what to build and write.dev/<feature>/prd.mddev/how— turn a PRD into.dev/<feature>/tasks.ymldev/build— implement one task per invocationdev/systems— survey a repo and queue reverse-spec workdev/specs— write or refresh persistent domain specs
The workflow keeps planning, decomposition, implementation, and reverse-spec work in separate artifacts so each phase can run in a fresh context window.
Multiple planned features can coexist under .dev/ without forcing an immediate worktree per idea.
worktree-manager owns checkout safety and finish cleanup.
Use the slash commands for orchestration:
/dev:plan <idea>— start a new feature plan/dev:iterate <feature>— revise an existing PRD/dev:done <feature>— verify, spec, align, squash merge, and clean up/dev:reverse <target>— reverse-engineer persistent specs from existing code
Direct skill invocation still works when you want lower-level control.
Feature artifacts live in .dev/<feature>/ and are removed individually when the feature ships or is abandoned.
Reverse backlog planning lives in specs/systems.yml; specs/README.md remains the index of completed specs.