The workflow
A spec moves through four stages: written, broken into issues, implemented, and archived. Your agent does the creative writing; the CLI guarantees structure and tracking.
Write the spec
Describe the feature in plain words. The agent scaffolds the spec folder, asks clarifying questions, and writes SPEC.md following the project template.
draun-spec "payment flow"Analyze the specOptional
A read-only review of SPEC.md looking for ambiguities, missing edge cases, and scope risks, reported by severity. The spec is never edited.
draun-analyzeBreak it into issues
The spec becomes small, independently verifiable issues with a dependency graph. INDEX.md tracks state and blockers.
draun-breakImplement
The agent implements ready issues, tracking each one with start and done. Choose manual to review between issues, auto for sequential subagents, or ultracode for a parallel multi-agent run.
draun-implementTrack and archive
Follow progress at any time. When every issue is done, the spec is validated and moved to the archive.
draun statusdraun-archive