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