Deepen Plan Skill
Purpose: Enhance existing plans with parallel research agents for maximum depth and grounding.
Plan to Deepen
Deepen target: ${ARGUMENTS}
Deepening Methodology
Phase 1: Plan Analysis
- Read and Understand Plan
- Read the entire plan document (expected location: docs/plans/) - If the plan frontmatter contains source-spec:, read the referenced spec file for additional context - Identify key sections and requirements - Note areas that need additional depth or clarification
- Scope Definition
- Determine which sections benefit most from deepening - Identify knowledge gaps or uncertainties - Prioritize based on impact and complexity
Phase 2: Parallel Research Agents
Launch specialized research agents in parallel based on plan needs:
Architecture & Design Agents:
- System Architecture Researcher - Overall system design and integration
- Domain Model Researcher - Business logic and data relationships
- API Design Researcher - Endpoint specifications and contracts
Implementation & Quality Agents: 4. Best Practices Researcher - Industry standards and conventions 5. Performance Researcher - Optimization strategies and patterns 6. Security Researcher - Security considerations and mitigations 7. Testing Strategy Researcher - Comprehensive testing approaches
Language & Framework Agents: 8. Language-Specific Researcher - Language idioms and patterns 9. Framework Researcher - Framework capabilities and constraints
Integration & Operations Agents: 10. Integration Researcher - External dependencies and APIs 11. Database Researcher - Data modeling and query patterns 12. UI/UX Researcher - User interface patterns and best practices
Phase 3: Knowledge Integration
- Collect Research Findings
- Gather insights from all research agents - Identify patterns and common themes - Evaluate conflicting recommendations
- Update Plan Sections
- Enhance existing sections with new insights - Add new sections for uncovered aspects - Include references and citations
- Create Deepened Plan
- Integrate research findings into coherent plan - Highlight key decisions and trade-offs - Provide implementation guidance
Phase 4: Validation and Refinement
- Review Deepened Plan
- Check for consistency and completeness - Validate technical feasibility - Assess alignment with project goals
- Present Enhancements
- Summarize key additions and improvements - Highlight critical insights and recommendations - Explain rationale for changes
- Next Steps
- Option to further refine specific sections - Run adr docs/plans/<feature-name>.md — capture key architectural decisions as permanent ADRs - Start /core:work docs/plans/<feature-name>.md — begin implementation
Output Features
Enhanced Plan Sections:
- Expanded technical specifications
- Detailed implementation strategies
- Comprehensive testing approaches
- Performance and security considerations
Supporting Materials:
- Reference links and documentation
- Code examples and patterns
- Architecture diagrams and flowcharts
- Risk assessment and mitigation strategies
Key Benefits
- Depth: Uncover hidden complexities and edge cases
- Breadth: Consider multiple perspectives and approaches
- Validation: Ground decisions in research and best practices
- Actionability: Provide concrete implementation guidance
Use Cases
Best for:
- Complex feature implementations
- Architectural changes or migrations
- Performance-critical optimizations
- Security-sensitive functionality
- Integration with external systems