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.