Documentation
README
Writing Plans
When to use
- Spec or requirements exist for a multi-step task and no implementation has started
- Feature spans multiple files/layers and needs decomposition before coding
- Handing off implementation to a separate session, agent, or human
Skip when
- Single-file change with obvious shape (just do it)
- Exploratory spike โ phased plans assume known requirements
- Spec is still in brainstorming; the plan would lock premature decisions
Sequence
Runs after: ring:exploring-codebases, ring:planning-large-features (gates 0-6 artifacts) or ring:planning-small-features (gates 0-2 artifacts) โ their outputs feed the spec Runs before: ring:executing-plans (rolling-wave execution) or ring:running-dev-cycle (gated subagent workflow)
This is the opening of the README. Read the full README on GitHub.