| name | project-planning |
| description | Converts a specification into a phased, dependency-ordered implementation plan. Use after specification is complete and before execution begins. |
| alwaysApply | false |
| model_preference | claude-sonnet-4-6 |
| category | workflow |
| tags | ["planning","architecture","task-breakdown","dependencies","estimation"] |
| complexity | intermediate |
| model_hint | standard |
| estimated_tokens | 900 |
| role | library |
Delegation
For detailed task planning workflows, this skill delegates to spec-kit:task-planning as the canonical implementation. Use this skill for quick planning needs; use spec-kit for thorough project plans.
When To Use
- After specification phase completes
- Need to design system architecture
- Need task breakdown for implementation
- Planning sprints and resource allocation
- Converting requirements into concrete tasks
- Defining component interfaces and dependencies
When NOT To Use
- No specification exists yet (use
Skill(attune:project-specification) first)
- Still exploring problem space (use
Skill(attune:project-brainstorming) instead)
- Ready to execute existing plan (use
Skill(attune:project-execution) instead)
- Need to adjust running project (update plan incrementally, don't restart)
Integration
With superpowers:
- Uses
Skill(superpowers:writing-plans) for structured planning
- Applies checkpoint-based execution patterns
- Uses dependency analysis framework
Without superpowers:
- Standalone planning methodology
- Task breakdown templates
- Dependency tracking patterns
Quality Checks
Before completing plan:
- ✅ All architecture components documented
- ✅ File Structure section present before tasks
- ✅ All task files appear in File Structure table
- ✅ All FRs mapped to tasks
- ✅ All tasks have acceptance criteria
- ✅ Dependencies are acyclic
- ✅ Effort estimates provided
- ✅ Critical path identified
- ✅ Risks assessed with mitigations
- ✅ Sprints balanced by capacity
Record the Tradeoff (decision journal)
Planning is where architecture and scope decisions get made: the pattern
chosen, the dependency accepted, the work deferred. Record each decision that
had real alternatives to docs/tradeoffs.md (draft and confirm):
- If leyline is installed, invoke
Skill(leyline:decision-journal) and append
a tradeoff entry (the decision, the options weighed, and what was
sacrificed; set phase to plan). Show the draft; append on confirmation.
