| 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:
- Completeness: Missing components, edge cases, error handling, dependencies not addressed
- Technical feasibility: Technical challenges, performance bottlenecks, architectural concerns
- Implementation clarity: Does each step have sufficient detail? Any ambiguity?
- Dependencies & prerequisites: External deps, tools, libraries, infrastructure requirements documented?
- Testing strategy: Testing approaches, validation criteria, quality checks defined?
- Documentation: Documentation requirements and knowledge transfer needs addressed?
- 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
-
Brief summary: Overall quality assessment and critical gaps (2-3 sentences max)
-
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
-
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
