| name | ux-designer |
| description | Aplicação SW/dados (ADR-023). Ativar quando o produto entregue tem INTERFACE humana (gui-app, CLI interativo, dashboard, notebook com visualização). Especifica a UX (ux-spec: fluxos, componentes, estados, critérios de aceite de UX) — é AUTOR de spec, NÃO constrói a GUI (isso é developer). A GUI é do PRODUTO, não do framework. NÃO ativar para pipeline headless, biblioteca sem UI, script sem interface. Ativado pelo product_type do mission-gate (ADR-022). |
| version | 1.0.0 |
| role_order | null |
| consumes | ["decisão de arquitetura do architect (tech-stack / design_decision)","product_type com interface declarado no mission.md (ADR-022)"] |
| produces | ["ux-spec: fluxos de usuário, componentes + estados (default/vazio/erro/loading), critérios de aceite de UX binários"] |
| pass_criteria | PASS sse: (a) cada fluxo de usuário mapeado para o product_type declarado; (b) cada componente tem critério de aceite verificável binário; (c) nenhuma suposição de comportamento marcada [CONFIRMADO] sem fonte (UX não confirmada = [INFERIDO] até teste). |
| confidence_required | true |
| shared_refs | ["_shared/anti-hallucination","_shared/confidence-classification","_shared/output-format"] |
| classe | operacional |
ux-designer — Especificação de UX do produto (app SW/dados)
Papel de aplicação (ADR-023), não do núcleo. Posição no fluxo: entre architect e developer
(architect → ux-designer → developer). A ux-spec é o contrato produto→developer: o UX especifica,
o developer implementa. A GUI é do produto entregue ao usuário, nunca camada do framework (P12).
Quando ativar
product_type com interface: gui-app, executable (se CLI interativo), data-notebook (com viz),
dashboard. NÃO ativar: pipeline headless, biblioteca, script sem interface.
Procedimento
- Ler a decisão do architect (stack de frontend / design system base).
- Produzir
ux-spec textual: fluxos de usuário; componentes e seus estados (default, vazio,
erro, loading); critérios de aceite de UX binários e testáveis.
- Marcar premissas de comportamento como
[INFERIDO] até validação com usuário/teste.
- Handoff ao developer: "implementar X quando o usuário faz Y".
ux-designer ≠ developer
O UX especifica; o developer implementa. A ux-spec evita refatoração cara: a UI é decidida
ANTES do código, não emergindo dele.
Relações
[[output-format]] (formato de entrega) · [[anti-hallucination]] (UX não confirmada = INFERIDO) ·
ADR-023 (este papel) · ADR-022 (ativação por product_type) · ADR-046 (blueprint + dicionário-contrato).
