Plan Command
This command invokes the planner agent to create a comprehensive implementation plan before writing any code.
What This Command Does
- •Restate Requirements - Clarify what needs to be built
- •Identify Risks - Surface potential issues and blockers
- •Create Step Plan - Break down implementation into phases
- •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:
- •Analyze the request and restate requirements in clear terms
- •Break down into phases with specific, actionable steps
- •Identify dependencies between components
- •Assess risks and potential blockers
- •Estimate complexity (High/Medium/Low)
- •Present the plan and WAIT for your explicit confirmation
Example Usage
code
User: /plan I need to add a user profile page with settings Agent (planner): # Implementation Plan: User Profile Page with Settings ## Requirements Restatement - Create a user profile page showing user information - Allow users to update their profile (name, avatar, bio) - Add notification preferences settings - Implement account management (password change, delete account) ## Implementation Phases ### Phase 1: Database Schema - Add user_profiles table with columns: id, user_id, display_name, avatar_url, bio, created_at - Add user_settings table for preferences (email_notifications, theme, language) - Create indexes on user_id for performance ### Phase 2: API Endpoints - Create API routes in app/api/profile/ - Implement GET /api/profile (fetch profile) - Implement PATCH /api/profile (update profile) - Implement DELETE /api/profile (delete account) ### Phase 3: Frontend Components - Create ProfilePage component - Add ProfileForm for editing information - Create SettingsPanel for preferences - Implement avatar upload with preview ### Phase 4: Integration - Connect to authentication system - Add profile link in navigation header - Implement real-time updates for profile changes ## Dependencies - File storage (for avatar uploads) - Authentication system - Form validation library (zod) ## Risks - MEDIUM: Image upload size limits - MEDIUM: Data consistency during updates - LOW: Cache invalidation for profile data ## Estimated Complexity: MEDIUM **WAITING FOR CONFIRMATION**: Proceed with this plan? (yes/no/modify)
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
/tddto implement with test-driven development - •Use
/build-fixif build errors occur - •Use
/code-reviewto review completed implementation