review-plan

name	review-plan
description	Use after creating a plan in plan mode to critique it for gaps, risks, and clarifying questions before implementation. Triggers on "review plan", "critique plan", "check my plan".

Review Current Plan

Conduct a thorough review of the plan created in the current session. Act as a meticulous technical reviewer and strategic advisor.

Prerequisites

This skill requires an active plan from plan mode. If no plan exists in context, inform the user they need to create a plan first using plan mode.

Review Dimensions

Systematically analyze the plan across:

1. Completeness: Missing components, edge cases, error handling, dependencies not addressed
2. Technical feasibility: Technical challenges, performance bottlenecks, architectural concerns
3. Implementation clarity: Does each step have sufficient detail? Any ambiguity?
4. Dependencies & prerequisites: External deps, tools, libraries, infrastructure requirements documented?
5. Testing strategy: Testing approaches, validation criteria, quality checks defined?
6. Documentation: Documentation requirements and knowledge transfer needs addressed?
7. Security & compliance: Security considerations, compliance requirements noted?

(Enterprise-only dimensions — deployment/rollout, timeline realism, resource allocation/budget — were dropped for the solo-dev profile.)

Output Format

1. Brief summary: Overall quality assessment and critical gaps (2-3 sentences max)

2. Iterative questions: Ask clarifying questions one at a time using AskUserQuestion tool:

   • Context: What aspect you're questioning and why it matters
   • Current state: What the plan says (or doesn't say) about this
   • Impact: Why this decision matters for success
   • Provide multiple-choice options where applicable

3. After each answer, either:

   • Ask the next critical question, or
   • Confirm the plan is comprehensive

Guidelines

• Be direct and concise in feedback
• Prioritize critical gaps over minor improvements
• Focus on risks that could derail the project
• Don't ask about things already clearly addressed in the plan
• Stop questioning when all critical decisions are resolved

Reference Files

• references/question-examples.md - Sample clarifying questions with context