Plan Review Skill
Purpose: Get feedback from specialized reviewers on plans before implementation.
Plan for Review
Review target: ${ARGUMENTS}
Review Methodology
Phase 1: Plan Preparation
- Read and Analyze Plan
- Read the complete plan document - Identify core objectives and requirements - Note areas that may need reviewer attention
- Reviewer Selection
- Determine which specialized reviewers are most relevant - Consider plan type, complexity, and domain - Choose reviewers based on expertise match
Phase 2: Parallel Reviewer Agents
Launch specialized reviewer agents in parallel:
Architecture & Design Reviewers:
- System Architecture Reviewer - Overall system design and boundaries
- Domain Model Reviewer - Business logic and data relationships
- API Design Reviewer - Endpoint specifications and contracts
Implementation & Quality Reviewers: 4. Best Practices Reviewer - Industry standards and conventions 5. Performance Reviewer - Optimization strategies and efficiency 6. Security Reviewer - Security considerations and mitigations 7. Testing Strategy Reviewer - Comprehensive testing approaches
Language & Framework Reviewers: 8. Language-Specific Reviewer - Language idioms and patterns 9. Framework Reviewer - Framework capabilities and constraints
Project & Team Reviewers: 10. Project Conventions Reviewer - Team standards and patterns 11. Maintainability Reviewer - Code quality and long-term sustainability 12. Simplicity Reviewer - KISS principles and minimalism
Phase 3: Review Synthesis
- Collect Reviewer Feedback
- Gather insights and recommendations from all reviewers - Identify common themes and patterns - Note conflicting advice for resolution
- Categorize Feedback
- P1 (Critical): Must address before proceeding - P2 (Important): Should consider for improvement - P3 (Nice-to-have): Optional enhancements
- Create Review Summary
- Compile structured feedback report - Highlight key issues and recommendations - Provide actionable next steps
Phase 4: Plan Enhancement
- Update Plan Based on Feedback
- Incorporate reviewer recommendations - Address critical issues and concerns - Enhance clarity and completeness
- Create Revised Plan
- Generate updated version with improvements - Document changes and rationale - Highlight reviewer contributions
- Present Review Outcome
- Summarize key feedback and changes - Explain how plan was improved - Offer options for next steps
Reviewer Specializations
DHH Reviewer (Rails/DHH Principles):
- Convention over configuration
- RESTful design patterns
- Rails best practices and idioms
- Simple, maintainable solutions
Kieran Reviewer (Performance & Scalability):
- Query optimization and caching
- Background job patterns
- Performance testing strategies
- Scalability considerations
Simplicity Reviewer (KISS & Minimalism):
- Remove unnecessary complexity
- Focus on core functionality
- Avoid over-engineering
- Clear, straightforward solutions
Review Output
Structured Feedback Report:
- Executive summary of key findings
- Categorized feedback by section
- Priority classification (P1/P2/P3)
- Specific recommendations and examples
Enhanced Plan Features:
- Improved clarity and completeness
- Addressed architectural concerns
- Enhanced testing and validation strategies
- Better alignment with project standards
Review Benefits
- Quality Assurance: Catch issues before implementation
- Knowledge Sharing: Leverage specialized expertise
- Risk Mitigation: Identify potential problems early
- Team Alignment: Ensure consistency with project conventions
Next Steps Options
- Implement Revised Plan: Proceed with enhanced plan
- Further Refinement: Address specific feedback areas
- Review Summary Only: Use feedback without plan update
- Start Work: Begin implementation immediately