skills.rest
krzyssikora
krzyssikoraCOMMUNITY
Explore all skills by this author →
GitHub

plan-review

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
One-click install
npx skills add https://github.com/krzyssikora/claude-personal-plugin --skill plan-review-krzyssikora
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Product & Management Skills→
krzyssikorakrzyssikora

spec-review

Review technical specification markdown files for missing requirements, contradictions, and edge-case ambiguities.

Community
Advanced
simon-downessimon-downes
1

workflow-implement

Execute approved implementation plans through milestone-based workflows with progress tracking.

Community
Advanced
ReinaMacCredyReinaMacCredy

maestro:plan-review-loop

Validate and refine plans through iterative subagent review cycles.

Community
Advanced
kk20300113-pngkk20300113-png

subagent-driven-development

Dispatch subagents to execute implementation plan tasks with two-stage reviews.

Community
Advanced