plan-review

Validate milestone planning artifacts and mappings with parallel review agents.

Updated Jan 22, 2026
One-click install
npx skills add https://github.com/blake-goodwyn/sloppy-pancakes --skill plan-review-blake-goodwyn
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plan-review
Source: https://github.com/blake-goodwyn/sloppy-pancakes/tree/main/.claude/skills/plan-review
Command: npx skills add https://github.com/blake-goodwyn/sloppy-pancakes --skill plan-review-blake-goodwyn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a structured quality gate between planning and execution by validating milestone plans, epic mappings, and issue specs, ensuring readiness before running a milestone.

Core Features & Use Cases

  • Artifact validation: Verifies the presence and structure of IMPLEMENTATION_PLAN.md, epic, spec, and issue files.
  • Parallel reviews: Orchestrates five independent review agents to assess plan quality, dependencies, risk, and alignment.
  • Actionable reports: Produces a structured verdict and prioritized findings to guide remediation.
  • Use Case: Before initiating a milestone, run plan-review to catch gaps in planning documents and ensure traceability from epic to issues.
  • Optional: It can be integrated into a CI/CD gate to prevent progression until issues are resolved.

Quick Start

To perform a quick quality gate on a milestone, trigger the plan-review workflow with a milestone identifier, e.g. plan-review m4.1.

Frequently Asked Questions about plan-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate milestone planning artifacts before execution?▼

To validate milestone planning artifacts before execution, run a structured quality gate that loads your plan, epic, spec, and issue files to verify frontmatter, reference integrity, and acceptance criteria coverage.

What is a milestone plan quality gate and how does it work?▼

A milestone plan quality gate automates artifact validation by orchestrating five parallel review agents to assess plan completeness, dependencies, risk, and alignment, producing a structured verdict to guide remediation.

How do I check epic to issue traceability for a milestone?▼

You can check epic to issue traceability by triggering an automated review with a milestone identifier, which enforces reference integrity and maps acceptance criteria coverage across your planning documents.

Can I integrate milestone plan reviews into a CI/CD pipeline?▼

Yes, you can integrate milestone plan reviews into a CI/CD gate to prevent progression until planning gaps are resolved, ensuring full traceability from epic to issues before execution begins.

What do I need to run an automated milestone plan review?▼

You need to prepare IMPLEMENTATION_PLAN.md, epic, spec, and issue files with concrete frontmatter, then trigger the review workflow with a target milestone identifier to surface quality findings.

Why does my milestone execution fail due to missing acceptance criteria?▼

Milestone execution fails when planning documents lack sufficient acceptance criteria coverage, which an automated quality gate detects by validating frontmatter and reference integrity before execution begins.