From 0263ff17900ec0b162d18cc90d4be2fe25a1c534 Mon Sep 17 00:00:00 2001 From: Branimir Georgiev <66906831+braboj@users.noreply.github.com> Date: Thu, 22 Oct 2026 00:46:20 +0300 Subject: [PATCH] refactor(ux): one instruction per rule Principles written as labels, accessibility requirements written as noun phrases and the testing tools listed in bold become instructions. Every MUST and the SHOULD stay; the done checklist is unchanged. Co-Authored-By: Claude Opus 5.5 --- templates/frontend/ux.md | 107 +++++++++++++-------------- tests/baselines/template-quality.txt | 2 +- 2 files changed, 52 insertions(+), 57 deletions(-) diff --git a/templates/frontend/ux.md b/templates/frontend/ux.md index 153f515f..9a0f55d8 100644 --- a/templates/frontend/ux.md +++ b/templates/frontend/ux.md @@ -5,65 +5,59 @@ ## UX principles -- Mobile-first — design for small screens first, enhance for larger ones -- Progressive disclosure — show only what the user needs at each step -- No dark patterns — no misleading UI, no forced actions, no hidden costs -- Consistency — same interaction patterns throughout the product -- Performance is UX — slow interfaces are bad user experience -- **Least Surprise**: components and interactions should behave as users - expect; if a pattern looks like a button it must act like a button +- Design for small screens first, then enhance for larger ones +- Show only what the user needs at each step +- Never use a dark pattern: misleading UI, a forced action, a hidden cost +- Use the same interaction pattern for the same task throughout +- Treat a slow interface as a UX defect +- Make every component behave as it looks: what looks like a button acts + like one ## Accessibility — WCAG 2.1 AA -- Target standard: WCAG 2.1 AA -- Minimum text contrast ratio: 4.5:1 (normal text), 3:1 (large text) -- All interactive elements reachable and operable by keyboard -- Any non-focusable element (``, `
`, ``) with `onClick` MUST - contain a `