ux-audit

1# UX Audit
2 
3Walk through a live web app AS a real user. The audit is **interaction-first** — typing, clicking, sending, watching, screenshotting. A static DOM sweep cannot produce a verdict.
4 
5## Verdict states
6 
7The audit ends in exactly one of:
8 
9- **Pass** — Critical = 0, High = 0, all hard gates green, Interaction Manifest complete.
10- **Conditional Pass** — Critical = 0, High = 0, all hard gates green, but Medium/Low present.
11- **Fail** — at least one Critical or High finding, OR a hard gate red.
12- **Incomplete** — Interaction Manifest missing required entries, a phase wasn't run, OR the audit-the-audit meta-check fires (manifest timestamps clustered < 0.5s apart, screenshots fewer than 2 × routes, console reads fewer than 1 × routes, Phase 3 took < 1m for an exhaustive audit). Not legal to upgrade to Pass even if everything observed looked fine.
13 
14If the work doesn't include a complete Interaction Manifest, the only legal verdict is **Incomplete**. "It looked OK" is not Pass. A clean Pass with implausible timings is rejected — the agent must redo the audit with real interaction.
15 
16## Hard gates
17 
18These auto-fail the audit. They cannot be downgraded.
19 
20| Gate | Threshold | Severity if violated |
21|------|-----------|----------------------|
22| Console errors during walkthrough | > 0 | Critical |
23| Console warnings during walkthrough | > 0 | High |
24| Network 5xx | > 0 | Critical |
25| Network 403 / 404 on authenticated pages | > 0 | High |
26…