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.