Small phases, not a big upfront plan
Software rarely moves in a straight line. Each phase is scoped, reviewed, and corrected before the next one starts, so a wrong turn costs one phase instead of a rewrite.
Plan in small phases and validate each assumption before it becomes code. Correct course at the brief — not after dozens of tasks have already shipped.
Mano gives your coding agent a repeatable way to plan and implement small pieces of work. Describe a change, review the proposed scope, and let the agent build against the decisions you approved. The plans and progress stay in your repository as readable files.
In a terminal, from your project's root directory:
npx mano-plan installThen open your coding agent's chat in the same project and describe your first change:
mano start
I want to add a contact form. Keep the first phase small.Mano proposes a scope and waits for your approval. Installation runs in the terminal; mano commands go in chat.
Follow the setup guide → · See a real phase →
mano start → scope a phase, and approve it yourself
mano spec → settle the technical decisions
mano rules → pin the conventions so stories stay consistent
mano stories → decompose into self-contained units
mano dev → implement the next story
mano review → record what held, what didn't, and close the phaseNothing forces that order. Every action checks its own inputs and tells you when it would be guessing.
For a phase that doesn't need story files, mano build implements the brief's approved scope items directly, tracked in a ledger on disk.
Optional, none of it on by default:
| Build mode | Implement a phase straight from its approved brief, no story files |
| Auto mode | Chain the commands you'd otherwise type — armed only by your scope approval |
| Import | Turn an existing PRD or document into a backlog, then stop |
| Team owners | Namespaced phases per person, so two people don't both scope "phase 7" |
| Tracks & filters | Narrow what a phase is allowed to contain |
| Hooks | Wire your own review checklist into any skill |
Mano is not a demo. These are real projects, and their planning artifacts are public:
| Project | What it is | Phases |
|---|---|---|
| react-native-ama | React Native accessibility library | 14 |
| anima | Godot animation add-on, GDScript | 20 |
Two unrelated stacks, one loop. Read the actual artifacts →