Fast Spec (Plan)
Structure: Milestones → User Stories A high-level spec that gives agents the big picture without granular subtask breakdowns. Agents figure out implementation details autonomously. Best for:- MVPs and prototypes
- Personal/side projects
- Rapid iteration workflows
- Solo developers
- Projects where speed matters more than detailed planning
- High-level milestones with complexity estimates
- User stories for each feature
- Basic acceptance criteria
- Technical architecture overview
Deep Spec
Structure: Milestones → User Stories → Granular Subtasks A comprehensive spec with implementation-level detail. Every task is broken down into specific, actionable subtasks with their own acceptance criteria. Best for:- Production applications
- Complex architectures
- Team coordination
- Mission-critical systems
- When you want maximum control over what agents build
- Detailed milestones with phased delivery
- User stories with comprehensive acceptance criteria
- Granular implementation subtasks
- Task-level complexity estimates
- Detailed technical architecture with schema designs
Comparison
Decision Framework
Use Fast Spec if:- You’re validating an idea quickly
- The project is straightforward (CRUD apps, simple tools)
- You trust agents to make implementation decisions
- You want to iterate on the spec after seeing initial output
- You’re building something you’ll ship to real users
- The project has complex business logic
- You want precise control over each implementation step
- You’re working in a regulated domain (healthcare, finance)
- Multiple people need to understand the build plan
Combining Both
You can also generate a Fast Spec and selectively request deep breakdowns for only the complex milestones — keeping simple features at the story level while getting granular subtasks for the tricky parts.What’s next?
Understanding Specs
What’s actually inside a pre.dev spec.
Build Modes & Effort
Turn the spec into working code.
Plans & Credits
What specs cost and what each plan includes.
Architect API
Generate the same specs programmatically.

