Task Planning
Overview
Transforms specifications and implementation plans into concrete, dependency-ordered tasks. Creates phased breakdowns that guide systematic implementation.
When To Use
- Converting specifications to implementation tasks
- Planning feature implementation order
- Identifying parallel execution opportunities
- Breaking down complex features into phases
When NOT To Use
- Writing specifications - use spec-writing
Task Phases
Tasks follow a 5-phase structure from setup through polish:
- Phase 0: Setup - Project initialization, dependencies, configuration
- Phase 1: Foundation - Data models, interfaces, test infrastructure
- Phase 2: Core Implementation - Business logic, APIs, services
- Phase 3: Integration - External services, middleware, logging
- Phase 4: Polish - Optimization, documentation, final testing
For detailed phase definitions, selection guidelines, and anti-patterns, see modules/phase-structure.md.
Task Format
Each task includes:
- ID: Unique identifier (TASK-001)
- Description: Clear action statement
- Phase: Which phase it belongs to
- Dependencies: Tasks that must complete first
- Parallel Marker: [P] if can run concurrently
- Files: Affected file paths
- Criteria: How to verify completion
Dependency Rules
Dependencies define execution order and identify parallelization opportunities:
- Sequential Tasks: Execute in strict order when dependencies exist
- Parallel Tasks [P]: Can run concurrently when ALL nonconflicting conditions are met
- File Coordination: Tasks affecting same files MUST run sequentially
Nonconflicting Criteria for Parallel Execution:
- ✅ Files: No file overlap between tasks
- ✅ State: No shared configuration or global state
- ✅ Dependencies: All prerequisites satisfied
- ✅ Code paths: No merge conflicts possible
- ✅ Outputs: Tasks don't need each other's results
Mark tasks with [P] ONLY if they pass ALL criteria above.
For fan-out/fan-in patterns, task ID conventions, and validation rules, see modules/dependency-patterns.md.
Example Task Entry
## Phase 2: Core Implementation
### TASK-007 - Implement user authentication service [P]
**Dependencies**: TASK-003, TASK-004
**Files**: src/services/auth.ts, src/types/user.ts
**Criteria**: All auth tests pass, tokens are valid JWT
Verification: Run pytest -v to verify tests pass.
Quality Checklist
- [ ] All requirements mapped to tasks
- [ ] Dependencies are explicit
- [ ] Parallel opportunities identified
- [ ] Tasks are right-sized (not too large/small)
- [ ] Each task has clear completion criteria
Related Skills
spec-writing: Creating source specificationsspeckit-orchestrator: Workflow coordination
Exit Criteria
- [ ] Every task has a unique ID in
TASK-NNNformat and includes Description, Phase (0-4), Dependencies list, Parallel marker ([P]or sequential), Files, and Criteria fields - [ ] Tasks marked
[P]pass all 5 nonconflicting criteria: no file overlap, no shared state, dependencies satisfied, no merge conflicts possible, no output dependency on each other - [ ] Every functional requirement from the source spec is mapped to at least one task; unmapped requirements are flagged
- [ ] Quality checklist passes all items before output is finalized
- [ ] Tasks within each phase are ordered so that no task depends on one with a higher task number within the same phase