ADR-051 — UX specification (Markdown)

Architecture decision record — status: Accepted.

Source: docs/adr/ADR-051-ux-specification.md

ADR-051: UX specification (Markdown)

Estado

Accepted — 2026-08-23
Amendment 2026-08-24: wireframe HTML P0 obligatorio; chrome admin = IVPrior (SLICE-001-00).

Contexto

Igual que IVPrior ADR-042: los agentes implementan mal desde Figma suelto. La UX vive en git. IVPrior reutiliza patrones IVPrior (list CRUD, wizard), no inventa chrome.

Decisión

CapaDónde
Productodocs/product/features/*/brief.md
Inventariodocs/ux/sitemap.md
Pantalladocs/ux/screens/S-xxx.md
Wireframe P0docs/ux/wireframes/
TokensADR-031 · packages/ui

Gates:

  • Feature con UI: screen spec antes de /opsx:apply de UI (DOC-012).
  • P0: wireframe HTML (/sd-wireframe) — no solo markdown de layout.
  • Chrome listas/wizards: docs/ux/patterns/platform-admin-crud.md + admin-wizard.md. Mirror = path en este repo (DOC-024).
  • Copy en en-US; tono DOC-022 / docs/product/tone-and-voice.md.
  • Estados empty/loading/error obligatorios (data-states.md · loading-states.md).
  • Slices solo-API: *-api / *-skeleton en el nombre.

No se exige Figma. Help MDX sí aplica en IVPrior (ADR-080) en el mismo slice que la pantalla.