plan-review

# 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

```bash
# 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 |
|----------|-------------|
| `PLAN_REVIEW_STRICT` | If `true`, require all Critical issues resolved before approval |
| `PLAN_REVIEW_AUTO_APPROVE` | If `true`, auto-approve Low severity changes |

Custom VP prompts via `.claude/plan-review-config.json` in your project root.

## Integration

Works with other Claude Code skills:

| Skill | Integration |
|-------|-------------|
| `wave-planner` | Review wave plans before execution |
| `launchpad` | Integrated as Stage 2 of the end-to-end pipeline |
| `governance` | Standards audit runs after plan approval |
| `hive-mind-execution` | Review phase integrates plan-review |