automagik-cli: Command for Claude Code

/planner

---

allowed-tools: mcp__zen__planner(), Read(), Write(), Bash(), Glob(), mcp__zen__docgen(), mcp__wait__wait_minutes(*) description: Interactive step-by-step planning for complex tasks with branching and revision capabilities

Transform vague requirements into concrete, actionable plans through iterative refinement and exploration of alternatives.

The Power of Interactive Planning

Unlike static planning, the Zen planner enables:

• Step-by-Step Thinking: Build plans incrementally with deep reflection
• Branching Exploration: Try different approaches without losing progress
• Dynamic Revision: Update earlier steps as understanding deepens
• Forced Reflection: Complex plans (≥5 steps) trigger deep thinking pauses
• Context Persistence: Plans survive across sessions via continuation IDs

Usage Examples

# Plan a new feature
/planner "Add real-time collaboration to agent system"

# Plan a complex refactoring
/planner "Refactor routing logic to support dynamic agent registration"

# Plan an investigation
/planner "Investigate and fix memory leak in long-running sessions"

# Plan with specific model
/planner "Design microservices architecture" model="gemini"

How It Works

Planning Flow

graph TD
    A[Initial Request] --> B[Step 1: High-level understanding]
    B --> C[Step 2: Break down components]
    C --> D[Step 3: Identify dependencies]
    D --> E{Need alternatives?}
    E -->|Yes| F[Branch: Explore approach B]
    E -->|No| G[Step 4: Detail implementation]
    F --> G
    G --> H[Step 5: Risk assessment]
    H --> I{Revisions needed?}
    I -->|Yes| J[Revise earlier steps]
    I -->|No| K[Final plan ready]
    J --> K

Deep Thinking Enforcement

For complex plans (≥5 steps), the first 3 steps enforce thinking pauses:

• Prevents surface-level planning
• Ensures thorough consideration of alternatives
• Identifies hidden dependencies early
• Avoids tactical details before strategic decisions