deepen-plan（深化计划）

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

1. 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

1. 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:

1. System Architecture Researcher - Overall system design and integration
2. Domain Model Researcher - Business logic and data relationships
3. 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

1. Collect Research Findings

- Gather insights from all research agents - Identify patterns and common themes - Evaluate conflicting recommendations

1. Update Plan Sections

- Enhance existing sections with new insights - Add new sections for uncovered aspects - Include references and citations

1. Create Deepened Plan

- Integrate research findings into coherent plan - Highlight key decisions and trade-offs - Provide implementation guidance

Phase 4: Validation and Refinement

1. Review Deepened Plan

- Check for consistency and completeness - Validate technical feasibility - Assess alignment with project goals

1. Present Enhancements

- Summarize key additions and improvements - Highlight critical insights and recommendations - Explain rationale for changes

1. 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

1. Depth: Uncover hidden complexities and edge cases
2. Breadth: Consider multiple perspectives and approaches
3. Validation: Ground decisions in research and best practices
4. 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