plan-review_skill

Overview

This skill reviews, optimizes, and scores implementation plans with a confidence index and structured pros/cons analysis. It runs three built-in review passes, suggests optional targeted passes, and produces concrete, actionable recommendations and boost actions. Use it to decide whether to proceed with an approach before writing code.

How this skill works

Accept a plan or a high-level goal, draft a structured plan if needed, and run three mandatory passes: Feasibility, Optimality, and Risk Analysis. After the core passes, suggest optional passes (Incremental Delivery, Stakeholder Impact, Maintenance Burden, Team Coordination) when signals appear; each pass returns findings with severity, affected step, and concrete recommendations. Finally, compute a confidence index from five factors and present per-decision pros/cons and boost options.

When to use it

• Before writing code: evaluate an implementation plan for readiness
• Compare multiple approaches and surface trade-offs
• Get a quantified confidence score on a proposed plan
• Optimize or refine an existing plan to reduce risk
• Generate a plan from a goal and validate it before implementation

Best practices

• Provide a clear objective and numbered actionable steps for best results
• Include dependencies and known constraints up front to reduce clarifying questions
• Enable suggested passes when scope involves multiple teams or data migrations
• Approve any recommended diffs—never accept silent modifications
• Use boost actions (prototypes, reversible migrations, tests) to raise confidence

Example use cases

• Score a database migration plan and identify rollback gaps
• Compare JWT vs session auth with per-decision pros/cons and a recommendation
• Refine a multi-step deployment into incremental delivery with rollback points
• Draft an implementation plan from a feature goal and run all review passes
• Get prioritized, executable boost actions to move a plan from yellow to green