Plan Review Skill

Plan Review Skill

A Claude Code skill that runs multi-perspective plan review using parallel VP agents to identify blockers, anti-patterns, conflicts, and regressions before execution.

Overview

Plan Review spawns three specialized AI agents — VP Product, VP Engineering, and VP Design — to simultaneously review implementation plans, design docs, architecture proposals, and wave plans. Each agent evaluates the plan through their domain lens. Findings are consolidated, ranked by severity, and presented for your approval before any changes are applied.

Features

• Parallel VP analysis — Three perspectives reviewed simultaneously
• Four issue categories — Blockers, Anti-patterns, Conflicts, Regressions
• Severity ranking — Critical, High, Medium, Low with action guidance
• Approval workflow — Review all findings before plan edits are applied
• Guided decision — Ask, then execute: never modifies files without consent

Usage

# Review a plan file
/plan-review-skill path/to/your-plan.md

Or trigger naturally:

"Review this plan for blockers and conflicts"
"Get VP feedback on the implementation plan"
"Run a stakeholder review on this design doc"

VP Perspectives

VP Role	Focus Areas
VP Product	User impact, scope creep, dependencies, timelines
VP Engineering	Technical debt, anti-patterns, architecture conflicts, regressions
VP Design	UX consistency, accessibility, design system alignment

Issue Severity Guide

Severity	Action
Critical	Must address before proceeding
High	Should address before proceeding
Medium	Address in this iteration
Low	Address if time permits

Installation

Via Skillsmith MCP:

install_skill smith-horn/plan-review-skill

Or manually copy this directory to `~/.claude/skills/plan-review-skill/`.

Configuration

Optional environment variables:

| Variable | Description | |-