plan-review

Name: plan-review
Availability: InStock
Author: krzyssikora

Review implementation plan markdown for execution risks and ambiguities.

Updated May 17, 2026

Search Tags:#quality assurance #markdown #implementation #plan review #git commits #iteration loop #agent subagent

Ready to run

npx skills add https://github.com/krzyssikora/claude-personal-plugin --skill plan-review-krzyssikora

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: plan-review
Source: https://github.com/krzyssikora/claude-personal-plugin/tree/main/plugins/plan-review/skills/plan-review
Command: npx skills add https://github.com/krzyssikora/claude-personal-plugin --skill plan-review-krzyssikora

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

plan-review helps you validate and improve an implementation plan by running an independent, fresh-context reviewer loop that flags real execution risks and guides concrete edits until the plan is sound.

Core Features & Use Cases

Independent plan critique with structured catch severity: identifies gaps that block correct execution, would make work error-prone, or can be refined for clarity.
Round-based applied/disputed/stale loop: attempts targeted edits, discards weak or non-compelling rebuttals, and retries across multiple rounds with caps to avoid endless churn.
Git-guarded workflow: resolves the target plan file, derives a topic for commit messages, checks repository/branch/diff cleanliness, and commits successful rounds.

Quick Start

Run plan-review right after writing a fresh plan so it can review and iteratively improve docs/superpowers/plans/<...>.md.

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 to identify execution risks and ambiguities?▼

Plan review analyzes an implementation plan markdown file to flag actionable execution risks and ambiguities, then iteratively applies edits until the plan reaches a clean verdict.

How does iterative plan review work with structured feedback and git commits?▼

Iterative plan review parses structured reviewer output, applies targeted edits per catch, and commits successful rounds via git with soft and hard safety caps to prevent endless churn.

Can I review a specific markdown plan file if I have multiple drafts?▼

Yes, you can invoke the review with an optional explicit path to target a specific markdown file, otherwise it automatically resolves and reviews the newest plan in the plans directory.

What are the limitations of automated plan critique loops?▼

Automated plan critique loops are constrained by soft and hard safety caps on rounds to avoid endless churn, and they require a clean git repository, branch, and diff state before executing commits.

What is the best way to validate an implementation plan before starting development?▼

Running a fresh-context reviewer loop validates an implementation plan by identifying gaps that block correct execution, disputing weak rebuttals, and guiding concrete edits until the plan is sound.