plan-review

Review implementation plans across spec, scope, engineering, and operations.

Updated Apr 15, 2026
One-click install
npx skills add https://github.com/ToanPV90/dotfiles --skill plan-review-toanpv90
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plan-review
Source: https://github.com/ToanPV90/dotfiles/tree/main/claude/.claude/skills/plan-review
Command: npx skills add https://github.com/ToanPV90/dotfiles --skill plan-review-toanpv90

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Plan-review helps you prevent expensive implementation mistakes by critically evaluating an execution plan across spec quality, scope, engineering, and operations before any building starts.

Core Features & Use Cases

  • Multi-lens plan validation: Reviews plans with product, architecture, and SRE-style checks to find missing assumptions and risks early.
  • Spec quality and testing readiness: Flags weak or missing objectives, success criteria, boundaries, and test strategy when a spec/design doc is referenced.
  • Safety-first workflow control: Enforces “don’t approve blocked plans” and asks confirmation before appending reports to the plan file.
  • Clear verdicts and next actions: Produces a structured verdict (APPROVED, APPROVED_WITH_CONCERNS, or BLOCKED) and guides what to do next in the lifecycle.

Quick Start

Use plan-review to review your most recent plan by asking: Review my plan and append the full review report to the plan file.

Frequently Asked Questions about plan-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review an implementation plan before building starts?▼

A plan review evaluates spec quality, product scope, engineering design, and operational readiness before building starts. It records findings with BLOCKER, CONCERN, or SUGGESTION severity and produces a verdict that blocks execution when any BLOCKER exists.

What is operational readiness in lifecycle governance?▼

Operational readiness in lifecycle governance is an SRE-style engineering check that validates risks and assumptions in a plan. It flags missing operational criteria to ensure a plan is safe to execute before building begins.

How do I assess architecture risks and scope boundaries?▼

Assess architecture risks and scope boundaries by applying multi-lens validation to your plan. This architecture and scope review flags weak objectives, missing success criteria, and undefined boundaries referenced in your spec.

Can I append a review report directly to my plan file?▼

Yes, you can append a review report to your plan file, but the workflow enforces safety-first control by asking for confirmation first. It will not append the report if the plan review verdict is BLOCKED.

What are the limitations of automated plan review?▼

Automated plan review cannot approve blocked plans, as it enforces a strict safety-first workflow control. It also relies on locating the correct plan and reading relevant rule files, limiting results if project context is missing.