review-plan

Audit a development plan against the codebase to surface gaps and risks.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/vr000m/skills.md --skill review-plan-vr000m
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-plan
Source: https://github.com/vr000m/skills.md/tree/main/.claude/skills/review-plan
Command: npx skills add https://github.com/vr000m/skills.md --skill review-plan-vr000m

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audits a development plan by spawning a fresh-context reviewer to examine the plan against the codebase and surface gaps, ambiguities, and risks before implementation begins.

Core Features & Use Cases

  • Fresh-context review: launches a single, isolated subagent to read the plan cold and validate assumptions against the repository.
  • Gap discovery: identifies undocumented constraints, missing tasks, and potential misalignments between the plan and codebase.
  • Structured findings: returns categorized observations (assumptions, constraints, risks, sequencing, missing tasks, testing gaps) with concrete evidence and actionable suggestions.
  • Governance signal: produces a review marker workflow that helps ensure decisions are traceable and reproducible.

Quick Start

Run a /review-plan command with the path to the plan file you want audited to start the independent review.

Frequently Asked Questions about review-plan

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

FAQPage Schema
How do I audit a development plan against my codebase before implementation?

To audit a development plan, you can run a fresh-context review that validates plan assumptions against the repository. This process surfaces gaps, undocumented constraints, and potential misalignments before coding begins.

What is a fresh-context review for plan validation?

A fresh-context review is an independent plan audit that spawns an isolated subagent to read the development plan cold. It validates assumptions against the codebase to identify undocumented constraints, missing tasks, and integration risks.

How do I find missing tasks and risks in my software development plan?

Finding missing tasks and risks involves auditing the plan to discover undocumented constraints and testing gaps. A structured review returns categorized observations with concrete evidence and actionable suggestions for discussion.

When do I need to run a plan review for codebase validation?

You need a plan review after a development plan is created, or when validating integration points and sequencing assumptions. It ensures decisions are traceable and reproducible by producing a governance signal review marker.

Does independent plan review work without modifying the existing codebase?

Yes, independent plan review works by spawning an isolated subagent that reads the plan and validates references without modifying code. It solely produces categorized findings and actionable suggestions to surface gaps.

What are the limitations of using an isolated subagent for risk assessment?

The limitation of an isolated subagent for risk assessment is that it reads the plan cold without prior context. It returns categorized observations for discussion rather than automatically fixing sequencing or testing gaps.