controlflow-plan-audit

name	controlflow-plan-audit
description	Use when a saved implementation plan should be adversarially reviewed before coding, especially for small, medium, or large tasks that may contain architecture flaws, scope gaps, destructive risk, weak rollback, weak tests, or dependency conflicts.

ControlFlow Plan Audit

Overview

Adversarially review a saved implementation plan before coding. Look for architecture defects, dependency mistakes, missing rollback, scope gaps, weak tests, and first-phase executability problems.

Local Contract

• Read the actual plan artifact and cross-check it against repository files, tests, commands, architecture, and dependencies.
• Use references/audit-checklist.md for audit coverage and ../controlflow-planning/references/llm-behavior-guidelines.md for generic evidence discipline.
• Save the verdict to plans/artifacts/<task-slug>/plan-audit.md using ../../templates/plan-audit-report-template.md.
• Tie findings to plan sections or repository facts.

Workflow

1. Read the saved plan artifact first, not a summary.
2. Check file/path reality, available tests and validation commands, architecture/dependency surfaces, rollback, acceptance quality, contract completeness, and first-phase executability.
3. Return one verdict: APPROVED, NEEDS_REVISION, REJECTED, or ABSTAIN.
4. For non-approval, classify as fixable, needs_replan, or escalate.
5. Save and summarize evidence-backed findings.

Spec-Before-Plan Health Check

For non-trivial work, confirm the plan is anchored to explicit requirements, acceptance criteria, constraints, exclusions, and verification gates rather than inferred chat context.

Audit-Specific Failure Checks

• Do not approve a detailed plan that lacks a spec artifact or equivalent requirements section.
• Do not approve vague success criteria; require measurable acceptance and gates.
• Do not downplay rollback gaps; classify them by blast radius.
• Do not accept plausible repository claims without checking current paths and commands.

Output Shape

• Status
• Findings
• Risk Summary
• Recommendation
• Failure Classification when needed
• Confidence

References

• references/audit-checklist.md
• ../../templates/plan-audit-report-template.md
• ../controlflow-review/references/security-review-discipline.md
• ../controlflow-planning/references/llm-behavior-guidelines.md