Last Update

2026-05-10 19:18:50 +03:00
parent b7936a0912
commit 1036cb5739
40 changed files with 2918 additions and 0 deletions
@@ -0,0 +1,22 @@
+# UX Research Policy
+
+Use a curated-first, live-web fallback policy.
+
+1. Search `.agents/skills/_shared/references/ux-research-registry.json` first.
+2. If no registry source supports the UX decision, search the web for authoritative sources.
+3. Prefer primary or recognized UX sources: W3C/WCAG, platform HIG/Material guidance, NN/g, Baymard, official product/design-system docs, peer-reviewed or well-scoped research.
+4. Add useful live-web findings back to the registry with `scripts/wireframe/update-research-registry.ps1`.
+5. Cite sources in `ux_spec.json` with `registry_id`, `url`, `claim`, and `used_for`.
+6. Do not write "research shows" unless the cited source directly supports the claim.
+
+## Citation Object
+
+```json
+{
+  "registry_id": "nng-heuristics",
+  "title": "10 Usability Heuristics for User Interface Design",
+  "url": "https://www.nngroup.com/articles/ten-usability-heuristics/",
+  "claim": "Systems should keep users informed about status through timely feedback.",
+  "used_for": ["loading-state-patterns", "action-feedback"]
+}
+```