ux-audit

# UX Audit Walk 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. ## Verdict states The audit ends in exactly one of: - **Pass** — Critical = 0, High = 0, all hard gates green, Interaction Manifest complete. - **Conditional Pass** — Critical = 0, High = 0, all hard gates green, but Medium/Low present. - **Fail** — at least one Critical or High finding, OR a hard gate red. - **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. If 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. ## Hard gates These auto-fail the audit. They cannot be downgraded. | Gate | Threshold | Severity if violated | |------|-----------|----------------------| | Console errors during walkthrough | > 0 | Critical | | Console warnings during walkthrough | > 0 | High | | Network 5xx | > 0 | Critical | | Network 403 / 404 on authenticated pages | > 0 | High | | Layout collapse at any tested viewport / pa...