| name | planner |
| description | Interactive planning and execution for complex tasks. Use when user asks to use or invoke planner skill. |
Planner Skill
Two workflows: planning (13-step plan creation + review) and execution
(implement plans).
Activation
When this skill activates, IMMEDIATELY invoke the corresponding script. The
script IS the workflow.
| Mode | Intent | Command |
|---|
| planning | "plan", "design", "architect" | <invoke working-dir=".claude/skills/scripts" cmd="python3 -m skills.planner.planner --step 1 --total-steps 13" /> |
| execution | "execute", "implement", "run plan" | <invoke working-dir=".claude/skills/scripts" cmd="python3 -m skills.planner.executor --step 1 --total-steps 9" /> |
When to Use
Use when task has:
- Multiple milestones with dependencies
- Architectural decisions requiring documentation
- Complexity benefiting from forced reflection pauses
Skip when task is:
- Single-step with obvious implementation
- Quick fix or minor change
- Already well-specified by user
Resources
| Resource | Contents | Read When |
|---|
.claude/conventions/diff-format.md | Unified diff specification | Writing code changes in milestones |
resources/plan-format.md | Plan template structure | Completing planning phase (injected by script) |
.claude/conventions/temporal.md | Comment hygiene heuristics | Writing comments in code snippets |
.claude/conventions/structural.md | Structural conventions | Making decisions without explicit user guidance |
Planning Workflow (13 steps)
Steps 1-5: Planning
- Context Discovery - explore, gather requirements
- Testing Strategy Discovery - identify test patterns
- Approach Generation - generate options with tradeoffs
- Assumption Surfacing - user confirmation of choices
- Approach Selection & Milestones - decide, write milestones + Code Intent
Steps 6-13: Review
- QR-Completeness - validate plan structure
- Gate - route based on QR result
- Developer Fills Diffs - convert Code Intent to diffs
- QR-Code - validate diffs and code quality
- Gate - route based on QR result
- TW Documentation Scrub - clean comments, inject WHY
- QR-Docs - validate comment hygiene
- Gate - PLAN APPROVED
Execution Workflow (9 steps)
- Execution planning - wave analysis
- Reconciliation (conditional) - validate existing code
- Implementation - wave-aware parallel dispatch to developers
- Code QR - verify code quality (RULE 0/1/2)
- Code QR Gate - route to step 3 on fail
- Documentation - create CLAUDE.md/README.md
- Doc QR - verify documentation quality
- Doc QR Gate - route to step 6 on fail
- Retrospective - summary presentation
Scripts inject step-specific guidance. Invoke and follow output.
