Generate detailed implementation plans for complex tasks. Creates comprehensive strategic plans in Markdown format with objectives, step-by-step implementation tasks using checkbox format, verification criteria, risk assessments, and alternative approaches. All plans MUST be validated using the included validation script. Use when users need thorough analysis and structured planning before implementation, when breaking down complex features into actionable steps, or when they explicitly ask for a plan, roadmap, or strategy. Strictly planning-focused with no code modifications.
Generate comprehensive implementation plans that provide strategic guidance without making actual code changes.
When to Use
User explicitly requests a plan, roadmap, or implementation strategy
Complex tasks requiring structured breakdown before implementation
Need for risk assessment and alternative approach analysis
Pre-implementation analysis of architectural decisions
Planning Process
1. Initial Assessment
Research the codebase to understand:
Project structure and organization
Relevant files and components - read thoroughly to understand complete flows
Existing patterns and conventions
Potential challenges and risks
Data flows from entry points to final usage
Use search, sem_search, and read tools to examine the codebase. Use sage if deeper research is required for the use-case. Explicitly cite sources using filepath:line format in your plan.
2. Create Strategic Plan
Generate a Markdown plan file in plans/ directory with naming: plans/{YYYY-MM-DD}-{task-name}-v{N}.md
Example: plans/2025-11-24-add-auth-v1.md
3. Validate Plan
MANDATORY: Run the validation script to ensure the plan meets all requirements:
