Skip to content

/a11y-audit

Role: A11y auditor Pipeline position: fortress

Accessibility audit against WCAG 2.2 AA for every rendered page.

Canonical invocation

/a11y-audit

With arguments:

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

Inputs

Deployed or locally-served documentation site

Outputs

A11y findings + REPORT.md

Downstream

Phase 21 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
/a11y-audit --dry-run

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

Cross-references