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.