plan-audit

Stress-test implementation plans with parallel adversarial review agents before execution.

Updated Jul 28, 2026
One-click install
npx skills add https://github.com/christian-byrne/comfy-skills --skill plan-audit-christian-byrne
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plan-audit
Source: https://github.com/christian-byrne/comfy-skills/tree/main/skills/plan-audit
Command: npx skills add https://github.com/christian-byrne/comfy-skills --skill plan-audit-christian-byrne

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Implementation plans often contain hidden assumptions, scope creep, missing edge cases, and wasted effort that only surface during execution. This Skill audits a drafted plan from multiple adversarial perspectives before any code is written, catching fatal flaws early. ## Core Features & Use Cases - Multi-Agent Council Review: Dispatches parallel agents including a Skeptic, Pragmatist, Temporal analyst, Backward Inductor, Scope Creep Finder, Gap Finder, Library Awareness agent, Cost Auditor, and Non-Reliance Auditor to attack the plan from different angles. - Structured Synthesis: Resolves conflicts between agents, identifies consensus findings and blind spots, and produces a verdict of Proceed, Proceed with modifications, or Rethink. - Scope Governance: Applies a 48-hour rule and budget-based trade-offs so audit findings do not inflate scope. - Use Case: After drafting a plan.md for a new feature, run the audit to discover that task 4 assumes an API behavior task 2 never establishes, and that two tasks reimplement functionality an existing library already provides. ## Quick Start Ask the agent to audit the plan.md file in the current working directory using the plan audit council before implementation begins.

Frequently Asked Questions about plan-audit

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

FAQPage Schema
How do I review an implementation plan before coding?▼

Run a multi-perspective audit that dispatches parallel agents to attack the plan from different angles: skepticism, pragmatism, sequencing, scope creep, and gap analysis. The findings are synthesized into a verdict of proceed, modify, or rethink.

What is adversarial plan review with AI agents?▼

Adversarial plan review uses red-team agents that attack a plan from opposite directions, such as a Scope Creep Finder removing unnecessary tasks and a Gap Finder adding missing coverage. Where the two agree, confidence in the finding is highest.

When should I audit an implementation plan?▼

Audit after the plan is drafted and approved but before implementation begins, especially when the plan feels too clean or straightforward. The plan file and original ticket context must be available in the working directory.

Can plan audits detect scope creep automatically?▼

Yes, a dedicated Scope Creep Finder agent compares each task against the ticket acceptance criteria and flags premature abstractions, unnecessary refactors, and gold-plating. Findings are rated CRITICAL or MODERATE with concrete task citations.

What are the limitations of multi-agent plan review?▼

The council is capped at nine agents and each produces 300-500 words, so very large plans may need proportional scoping. The audit also requires an existing plan file and ticket context, and the human still makes the final decision.