plan-reviewer

Critique planning drafts and generate QA checklists from PLAN-XXX.md and KNOWLEDGE-XXX.md.

Updated Nov 26, 2025
One-click install
npx skills add https://github.com/neyrojasj/smart-agent --skill plan-reviewer-neyrojasj
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-reviewer
Source: https://github.com/neyrojasj/smart-agent/tree/main/.github/skills/plan-reviewer
Command: npx skills add https://github.com/neyrojasj/smart-agent --skill plan-reviewer-neyrojasj

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Streamlines pre-execution quality by performing adversarial critique on planning drafts and generating structured QA checklists.

Core Features & Use Cases

  • Critique plans for completeness, feasibility, risk coverage, and scope discipline
  • Generate actionable QA checklists aligned with project standards and plan content
  • Route through a planning → QA gating loop within orchestration to ensure readiness before execution

Quick Start

Review PLAN-XXX.md and KNOWLEDGE-XXX.md to trigger critique and QA generation.

Frequently Asked Questions about plan-reviewer

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

FAQPage Schema
What is adversarial plan review and how does it validate software development planning?

Adversarial plan review evaluates planning drafts for completeness, feasibility, risk coverage, and scope discipline. It generates actionable QA checklists and outputs PASS or REVISE verdicts to enforce pre-execution quality gates before development begins.

How do I generate a QA checklist from a project planning draft?

Provide your PLAN-XXX.md and KNOWLEDGE-XXX.md files as input. The review process reads these documents, performs adversarial critique, and outputs a structured QA-XXX.md checklist aligned with your project standards and plan content.

Can I use pre-execution quality gates for product initiatives outside of software engineering?

Yes, pre-execution quality gates apply to both software development and product initiatives. The plan review process supports configurable curation rounds and generates QA checklists for any planning workflow requiring validation before execution.

What is the best way to automate a planning and QA gating loop for workflow automation?

Route your workflow through a planning and QA gating loop within orchestration. The system reads PLAN-XXX.md files, performs adversarial critique, generates QA-XXX.md checklists, and outputs PASS or REVISE verdicts to ensure readiness before execution.

What file formats do I need for plan critique and QA checklist generation?

You need PLAN-XXX.md and KNOWLEDGE-XXX.md files as input for plan critique. The process reads these markdown documents, performs adversarial review, and outputs a QA-XXX.md file containing the generated quality assurance checklist.

Why does my plan review output a REVISE verdict instead of PASS?

A plan review outputs a REVISE verdict when the adversarial critique identifies gaps in completeness, feasibility, risk coverage, or scope discipline. You must address these issues in your planning draft and rerun the review to achieve a PASS verdict.