Skip to main content

/plan Command

This command invokes the planner agent to create a comprehensive implementation plan before writing any code.

What This Command Does

  1. Restate Requirements - Clarify what needs to be built
  2. Identify Risks - Surface potential issues and blockers
  3. Create Step Plan - Break down implementation into phases
  4. Wait for Confirmation - MUST receive user approval before proceeding

When to Use

Use /plan when:
  • Starting a new feature
  • Making significant architectural changes
  • Working on complex refactoring
  • Multiple files/components will be affected
  • Requirements are unclear or ambiguous

How It Works

The planner agent will:
  1. Analyze the request and restate requirements in clear terms
  2. Break down into phases with specific, actionable steps
  3. Identify dependencies between components
  4. Assess risks and potential blockers
  5. Estimate complexity (High/Medium/Low)
  6. Present the plan and WAIT for your explicit confirmation

Command Syntax

string
required
Natural language description of what needs to be implemented

Examples

Basic Usage

Example Output

Important Notes

CRITICAL: The planner agent will NOT write any code until you explicitly confirm the plan with “yes” or “proceed” or similar affirmative response.
If you want changes, respond with:
  • “modify: [your changes]”
  • “different approach: [alternative]”
  • “skip phase 2 and do phase 3 first”

Integration with Other Commands

After planning:
  • Use /tdd to implement with test-driven development
  • Use /build-fix if build errors occur
  • Use /code-review to review completed implementation
  • Agent: ~/.claude/agents/planner.md
  • Skills: Planning and architecture skills
  • Commands: /orchestrate, /tdd, /code-review