Back to the catalog

plan-review-skill

Multi-perspective plan review from VP Product, VP Engineering, and VP Design viewpoints. Identifies blockers, anti-patterns, conflicts, and

Open source Repository Open in the app JSON README (API)

About

Multi-perspective plan review from VP Product, VP Engineering, and VP Design viewpoints. Identifies blockers, anti-patterns, conflicts, and regressions before implementation starts.

Details

Kind
Plugins
Topic
No topic detected
Publisher
wrsmith108
Origin
marketplace
Category
ferramentas
Stars
13
Forks
2
Last push
2026-03-04T01:11:49Z
Repository state
ativo
Added
2026-08-30 01:48:58
Updated
2026-08-30 01:48:58
Origin id
wrsmith108/plan-review-skill/plan-review-skill

README

# 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 |

More