Skip to content

/perf-audit

Role: Perf auditor Pipeline position: fortress

Audits against per-class performance budgets (Core Web Vitals, USE method).

Canonical invocation

/perf-audit

With arguments:

/perf-audit [path/to/plan-suite/] [phase-id] [--dry-run]

Inputs

Host repository at any lifecycle state

Outputs

Performance findings + REPORT.md

Downstream

Phase 18 of the review fortress

Workflow phases

The command follows the standard /plan-* pipeline workflow:

  1. Load context — Read plan suite, rules, and Resumption Contract.
  2. Verify prerequisites — Confirm dependency phases complete.
  3. Execute tasks — Perform the command mission.
  4. Verify outputs — Confirm all declared outputs exist and pass quality gates.
  5. Update PROGRESS.md — Record verified outputs in the Phase Output Registry.
  6. Emit REPORT.md — Pre-emission gate attestation recorded.

Failure modes

Symptom Cause Recovery
Prerequisite incomplete Dependent phase not finished Complete upstream phase first
Quality gate FAIL Output does not meet standards Fix the output and re-run
Missing input file Plan suite file absent Run /plan-generate to create it

Examples

# Dry-run to preview what would happen
/perf-audit --dry-run

# Execute against a named plan suite
/perf-audit path/to/plan-suite/

Cross-references