Implementation Planner
Create clear, actionable implementation plans through collaborative multi-agent discussion and refinement.
When to Activate
- User wants to implement a new feature
- User asks "how should I implement X?"
- User wants to add functionality
- User needs to refactor or migrate code
- Complex bug fixes requiring planning
- Architectural changes or design decisions
- Any task that benefits from structured planning
Quick Process
- Analyze Context: Understand the task, leverage any prior exploration
- Select Agents: Choose specialists for the dimensions the task actually raises, up to 10
- Collaborative Discussion: Multi-agent refinement, up to the round ceiling in the table below
- Synthesize Plan: Generate comprehensive implementation plan
- Output File: Write plan to
.claude-output/plan-[timestamp].md
Complexity-Based Planning
Agent and round counts are ceilings, not quotas. Staff only the dimensions the task actually raises, and do not spawn an agent for analysis that would finish in a handful of direct tool calls - plan the simple case yourself.
| Task Type | Agents (max) | Rounds (max) | Plan Length |
|---|---|---|---|
| Simple (bug fix, minor feature) | up to 2 | 1 | ~100-200 lines |
| Medium (features, refactors) | up to 5 | 2 | ~200-400 lines |
| Complex (architecture, major features) | up to 10 | 3 | ~400-600 lines |
Plan Structure
Generated plans include:
- Overview - High-level summary
- Scope - What will/won't be implemented
- Current State - Relevant architecture and files
- API Design (optional) - Interfaces and data structures
- Implementation Steps - Clear sequential steps (5-7 typical)
- Files Summary - Files to create/modify
- Critical Challenges (optional) - Risks and mitigations
- Agent Collaboration Summary - Consensus and trade-offs
Workflow Integration
This is Step 2 of the implementation workflow:
- Explore → 2. Plan (this) → 3. Review → 4. Execute
- Automatically uses context from prior exploration
- Output plan can be reviewed with
/review-plan - Approved plans execute with
execute-planskill
Detailed Reference
For agent selection, discussion protocols, and output formats, see planning-guide.md.