Files
Vadim Flowed 1036cb5739 Last Update
2026-05-10 19:18:50 +03:00

1.0 KiB

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

{
  "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"]
}