uxaudit
UX Regression Testing For Apps
A skill for running UX regression testing on a running app through two reader-facing buckets — UX issues and UI risk signals. The dashboard is meant to be read through those two top-level buckets first; each check inside the ux band is also tagged with a subtype (understand / decide / act / recover) so reviewers can drill into where in the user's flow the failure happens. Every judgment-call check is anchored in published, publicly-verifiable research (NN/g, WCAG 2.2, ISO 9241-11/110, Krug, Norman, Cooper, Christensen, peer-reviewed studies). Self-evident anti-patterns (lorem ipsum, "Coming soon" stubs) ship without an academic anchor because they aren't judgment calls. The full allow-list and the "don't invent" rule live in references/knowledge/sources.md. Architecture, subagent isolation, and the L1→L4 evaluation model live in references/concepts/architecture.md.
What this is
Most testing tells you whether code works. uxaudit tells you whether the result is usable and wants-to-be-used.
Two layers run side by side:
- Catalog — universal craft floor: AI slop fingerprints, WCAG, Nielsen heuristics, generic taglines. Project-agnostic, mostly stable.
- Scenario — whether THIS app's actual user journeys complete with continuity. Discovered from the project's own files; differs per project.
The catalog covers the floor of craft. The scenario layer covers journey continuity. Neither pretends to predict whether the product is the right product to build — that's a human question.
The dashboard presents findings in two reader-facing buckets:
- UX issues — problems that make the user struggle to understand, decide, or complete the task
- UI risk signals — templated, sloppy, or risky interface patterns that are likely to degrade the experience