The create-spec command is the second step in the repeatable feature development cycle in the spec-driven development workflow with Agent OS.
Creation of your spec involves multiple steps:
- Writing a comprehensive specification document based on the requirements gathered during new-spec phase.
- Breaking down the work into a tasks.md file strategically ordered and organized into task groups by specialty.
- Assigning appropriate implementer roles (agents) to tasks.
- Verifying accuracy, completeness and alignment of the spec.
What gets created
The create-spec command creates three core documents in agent-os/specs/[this-spec]/:
- spec.md - Comprehensive specification with user stories, requirements, reusable components, technical approach, visual references, and scope boundaries
- tasks.md - Task breakdown with tasks grouped by specialty (database, API, UI, testing), assigned to implementer roles, typically following a test-driven development approach (TDD) to planning the sequence of sub-tasks.
- verification/spec-verification.md - Verification report checking requirements accuracy, visual references, code reusability, and alignment with your standards and goals.
How to run
Multi-Agent Mode
Run command, /create-spec
When you're running Agent OS in multi-agent mode (typically in Claude Code), you can initiate and run the entire create-spec phase with a single command:
/create-spec
Single-Agent Mode
Run these three prompts sequentially
Run each of the following prompts sequentially in your AI tool. You can simply @ reference the prompt markdown file and append "run this" (or similar) to your prompt to instruct your AI tool to read and run the instructions in that file.
@agent-os/commands/create-spec/1-create-spec.md run this@agent-os/commands/create-spec/2-create-tasks-list.md run this@agent-os/commands/create-spec/3-verify-spec.md run thisNext step
Now that you have your specification and task breakdown complete, you're ready to implement the feature.