Spec-Tasks
Generate task list organized by user story for implementation.
Prerequisites: plan.md must exist (run /spec-plan first).
Workflow
- Setup - Run
.specify/scripts/bash/check-prerequisites.sh --json - Load documents - plan.md (required), spec.md, data-model.md, contracts/
- Generate tasks - Organized by user story priority
- Write tasks.md - Using
.specify/templates/tasks-template.md - Report - Task count, parallel opportunities, MVP scope
Task Format
- [ ] [TaskID] [P?] [Story?] Description with file path
| Component | Description |
|---|---|
- [ ] | Checkbox (required) |
[T001] | Sequential ID |
[P] | Parallelizable (optional) |
[US1] | User story label (for story phases) |
Examples
- [ ] T001 Create project structure per implementation plan
- [ ] T005 [P] Implement auth middleware in src/middleware/auth.py
- [ ] T012 [P] [US1] Create User model in src/models/user.py
Phase Structure
| Phase | Purpose |
|---|---|
| Phase 1: Setup | Project initialization |
| Phase 2: Foundational | Blocking prerequisites |
| Phase 3+: User Stories | One phase per story (P1, P2, P3...) |
| Final: Polish | Cross-cutting concerns |
Task Sources
- User Stories (spec.md) - Primary organization
- Contracts - Map endpoints to stories
- Data Model - Map entities to stories
- Infrastructure - Setup/foundational tasks
Parallel Rules
[P]= Different files, no dependencies- Models before services
- Services before endpoints
- Tests FAIL before implementation (if TDD)
Implementation Strategy
MVP First
- Setup → Foundational → User Story 1
- Test US1 independently
- Deploy/demo
Incremental
- Add each story independently
- Test and deploy each increment
Next Steps
After /spec-tasks:
/spec-analyze- Check consistency/spec-implement- Execute tasks