# 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"]
}
```