One-click install
npx skills add https://github.com/bdemarzo/ai-workflows --skill plan-review-bdemarzo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plan-review
Source: https://github.com/bdemarzo/ai-workflows/tree/main/skills/plan-review
Command: npx skills add https://github.com/bdemarzo/ai-workflows --skill plan-review-bdemarzo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

It prevents wasted engineering effort by rigorously reviewing a workflow plan for buildability, completeness, and simplicity before implementation begins.

Core Features & Use Cases

  • Two-subagent plan validation with a skeptic: Combines architecture, engineering, and adversarial realism to confirm readiness to advance.
  • Concise, findings-first review artifacts: Writes a new zero-padded round into the repository docs so later stages can proceed without chat history.
  • Clear go/no-go recommendation: Produces a final decision to either revise the stage or advance to implement-plan, aligned to required reviewer role bindings.

Quick Start

Use plan-review to assess ./docs/workflows/{slug}/plan.md and generate a new review-round artifact for deciding whether to proceed to implement-plan.

Frequently Asked Questions about plan-review

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

FAQPage Schema
How do I validate a workflow plan before implementation starts?▼

Plan validation involves reviewing a workflow plan artifact for architecture simplicity, sequencing, and build readiness before proceeding to implementation. Two substantive reviewers plus one skeptic assess the plan to produce a go/no-go decision.

What is a findings-first plan review artifact?▼

A findings-first plan review artifact is a concise markdown document written to a repository's docs folder. It captures review decisions and links to prior rounds, ensuring later implementation stages can proceed without relying on chat history.

How do I review a plan.md file for buildability and full-stack coverage?▼

Reviewing a plan.md file for buildability requires deriving the workflow slug from the dossier and validating full-stack coverage, restartability, and test readiness. The review outputs a zero-padded round artifact to the reviews directory with a clear advance or revise recommendation.

Does plan review require specific reviewer roles to work?▼

Plan review requires exactly two substantive reviewers plus one skeptic to validate readiness. It must verify reviewer role bindings to ensure proper architecture, engineering, and adversarial realism coverage before generating a recommendation to advance or revise.

When should I not use an automated workflow plan review?▼

You should not use automated workflow plan review when a plan.md artifact does not exist in the docs/workflows directory. The review process depends on reading this specific file and deriving a slug from the dossier to function correctly.