planner
Interactive planning and execution for complex tasks. Use when user asks to use or invoke planner skill.
$ Instalar
git clone https://github.com/solatis/claude-config /tmp/claude-config && cp -r /tmp/claude-config/skills/planner ~/.claude/skills/claude-config// tip: Run this command in your terminal to install the skill
SKILL.md
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 (12-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" | python3 scripts/planner.py --step 1 --total-steps 12 |
| execution | "execute", "implement", "run plan" | python3 scripts/executor.py --step 1 --total-steps 7 |
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 |
|---|---|---|
resources/diff-format.md | Unified diff specification | Writing code changes in milestones |
resources/temporal-contamination.md | Comment hygiene heuristics | Writing comments in code snippets |
resources/default-conventions.md | Structural conventions | Making decisions without explicit user guidance |
resources/plan-format.md | Plan template structure | Completing planning phase (injected by script) |
Planning Workflow (12 steps)
Steps 1-4: Planning
- Context Discovery - explore, gather requirements
- Approach Generation - generate options with tradeoffs
- Assumption Surfacing - user confirmation of choices
- Approach Selection & Milestones - decide, write milestones + Code Intent
Steps 5-12: 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 (7 steps)
- Execution planning - wave analysis
- Reconciliation (conditional) - validate existing code
- Milestone execution via wave-executor.py
- Post-implementation QR - holistic review
- QR Gate - route based on result
- Documentation - create CLAUDE.md/README.md
- Retrospective - summary presentation
Scripts inject step-specific guidance. Invoke and follow output.
