UX
TL;DR
UX não é “a camada de tela” — é a disciplina de decidir o que construir, para quem, e por quê, antes de qualquer pixel. Este domínio existe para o fractional engineer full-cycle: quem colhe requisito com o cliente, define o problema, desenha a solução, constrói, mede e sustenta — sozinho. Não forma um especialista de UX; dá profundidade real do mínimo necessário para exercer bem o ofício sem um time de design ao lado, e para sustentar conversa de nível sênior/staff em entrevista internacional.
Dois recortes atravessam todo o domínio, porque definem o público-alvo:
- Cliente ≠ usuário. Em consultoria/B2B, quem paga e aprova quase nunca é quem usa o sistema. Otimizar para a satisfação de quem assina o contrato produz produto que os usuários reais rejeitam.
- Escala de um. Boa parte do cânone de UX pressupõe time, orçamento e tráfego. Cada nota separa o que é praticável sozinho do que exige estrutura — e nomeia honestamente o segundo grupo em vez de fingir que dá para fazer sem ele.
O domínio se organiza por disciplina de UX (pesquisa, arquitetura de informação, interação, linguagem visual, writing, métricas, ética) — não pelo ciclo do produto. A lente full-cycle entra dentro de cada nota: toda nota responde “o que eu, sozinho, faço com isso na segunda-feira”.
Política de mídia (M1 obrigatório)
Mídia verificada é obrigatória em toda nota (2026-07-28)
Diferente do padrão default de
verificar-nota— que isenta M1 (vídeo/podcast embutido) na fase Iniciado — este domínio segue o padrão de Acessibilidade (vídeo verificado em 21 de 21 notas): M1 é obrigatório em toda nota, de qualquer fase. Isso sobrepõe tanto a isenção de fase da skillverificar-notaquanto a regra dediagnosticar-galhoque fecharia uma nota em➖só por score alto sem mídia. Uma nota sem mídia verificada não fecha.“Verificada” significa que a URL foi de fato conferida (WebFetch ou
yt-dlp, lendo transcrição/descrição) e que o conteúdo corresponde ao que a nota afirma — nunca um link plausível, não conferido. Preferência por vídeo (YouTube); podcast/talk é aceitável quando não há vídeo bom e verificável para o tema. Ver a skill.claude/skills/adicionar-midia/SKILL.mdpara o formato do callout.Exceção deliberada: se, após busca extensiva, nenhuma mídia boa e verificável for encontrada, a nota fica sem mídia e o roadmap do sub-galho registra isso explicitamente como buraco honesto — nunca forçar um link fraco só para fechar o gate. Ver roadmap de SG2, nota 06, para um exemplo real dessa exceção.
Sub-galhos
| # | Sub-galho | O quê | Fase |
|---|---|---|---|
| 1 | SG1 — Fundamentos e Modelo Mental | affordances e signifiers, as 10 heurísticas de Nielsen, leis de UX, Gestalt aplicada a UI | Iniciado |
| 2 | SG2 — Descoberta e Pesquisa | generativa vs avaliativa, Mom Test, cliente ≠ usuário, JTBD, Opportunity Solution Tree, personas, teste de usabilidade guerrilha, personas sintéticas | Iniciado/Adepto |
| 3 | SG3 — Arquitetura de Informação | os 4 sistemas da AI, taxonomia vs navegação, card sorting e tree testing, wayfinding | Adepto |
| 4 | SG4 — Design de Interação | fluxo antes da tela, os 5 estados de tela, progressive disclosure, modal vs página vs drawer, undo vs confirmação, formulários, latência percebida | Adepto |
| 5 | SG5 — Linguagem Visual e Design System | hierarquia visual, escalas de tipografia/espaçamento, cor em OKLCH, design tokens, Atomic Design, component API design, adotar vs construir | Adepto/Magus |
| 6 | SG6 — UX Writing e Content Design | voz e tom, microcopy, erros e recuperação, estados vazios como conteúdo, i18n quebrando layout | Adepto |
| 7 | SG7 — Medir, Validar e Sustentar | HEART/GSM, SUS/UMUX-Lite/SUPR-Q/SEQ, NPS e North Star, event taxonomy, quando A/B não se aplica, session replay, UX debt, defender decisão com número | Magus |
| 8 | SG8 — Ética e Ofício | dark patterns e regulação, UX no ciclo de dev, UX em entrevista sênior/staff | Magus |
| — | Capstone — Do requisito ao produto validado | ciclo completo: descobrir com o cliente, definir, desenhar, construir, instrumentar, medir, priorizar a dívida | Magus |
Estado (2026-07-29): domínio COMPLETO. 8/8 sub-galhos ✅ + capstone escrito, 49/49 notas. Junto com o galho-irmão Ferramentas de Design (9/9), o par fecha em 58 notas. Ver design do domínio, o plano em
.superpowers/sdd/2026-07-28-dominio-ux-plano/e o roadmap.
Roster agrupado por fase
SG1 — Fundamentos e modelo mental · Iniciado (5)
- UX não é tela — o ofício e seus limites
- Affordances e signifiers
- As 10 heurísticas de Nielsen
- Leis de UX
- Gestalt aplicada a UI
SG2 — Descoberta e pesquisa · Iniciado/Adepto (9)
- Generativa vs avaliativa
- Entrevista de descoberta — as regras do Mom Test
- Cliente não é usuário — a armadilha do B2B/consultoria
- Jobs To Be Done — as duas escolas
- Opportunity Solution Tree de bolso
- Assumption mapping
- Proto-persona vs persona de verdade
- Teste de usabilidade guerrilha com 5 usuários
- Personas sintéticas e síntese por IA
SG3 — Arquitetura de informação · Adepto (4)
- Os 4 sistemas da AI
- Schema de banco não é estrutura de navegação
- Card sorting e tree testing de guerrilha
- Navegação e wayfinding
SG4 — Design de interação · Adepto (7)
- Do fluxo antes da tela
- Os 5 estados de tela
- Progressive disclosure
- Modal vs página vs drawer
- Undo vs confirmação
- Design de formulários — defaults
- Latência percebida e feedback
SG5 — Linguagem visual e design system · Adepto/Magus (7)
- Hierarquia visual
- Escalas de tipografia, espaçamento e densidade
- Cor de produto: OKLCH e paleta semântica
- Design tokens como sistema
- Atomic Design — o que ainda vale
- Component API design
- Adotar vs construir, e governança mínima para um time de um
SG6 — UX writing e content design · Adepto (5)
- Voz e tom
- Microcopy, labels de ação e jargão interno
- Erros: fluxo de recuperação e mensagem que não culpa
- Estados vazios como conteúdo
- i18n quebra layout
SG7 — Medir, validar e sustentar · Magus (8)
- HEART + Goals-Signals-Metrics
- SUS, UMUX-Lite, SUPR-Q, SEQ
- NPS e North Star — promessa, crítica e Goodhart
- Instrumentação: event taxonomy e tracking plan
- Quando A/B não se aplica
- Session replay e heatmap
- UX debt e matriz severidade × esforço
- Defender decisão de UX com número
SG8 — Ética e ofício · Magus (3)
- Dark patterns e regulação
- UX no ciclo de dev
- UX em entrevista sênior/staff
Capstone
- Do requisito ao produto validado
Fronteiras (linkar, nunca reescrever)
Fronteiras
Este domínio linka as notas abaixo como reforço, nunca as reescreve (redundância entre notas é reforço, não duplicação — mas reescrever uma fronteira inteira é duplicação). Regra: cada nova nota linka a fronteira em vez de reexplicá-la.
Fronteira existente O que já está lá O que é novo aqui Acessibilidade (21 notas) accessibility tree, WCAG 2.2, ARIA APG, foco em SPA, contraste, cor acessível a camada de decisão que precede a implementação acessível. “O botão tem contraste suficiente” é a11y; “por que existe um botão aqui e não um link, e por que ele domina a tela” é IxD. 07 e 06 custom properties, mecânica de tokens em CSS, responsivo tokens como sistema (hierarquia, governança, padrão DTCG), não a sintaxe CSS 03 comparação técnica MUI/Radix/shadcn/Mantine com código o quando adotar como decisão de produto 10, 11 tabelas, data grids, libs de gráficos nada — apenas linkar Web Performance INP, LCP, CLS, lab vs field, CrUX métrica de UX (satisfação, sucesso de tarefa, retenção). Performance é insumo de UX, não a mesma coisa; vale uma nota-ponte curta 14 Playwright além do básico Playwright como loop de feedback visual/de design skill datavizpaleta categórica/sequencial, heurística de forma paleta de produto/UI, não de dados Claude Code + skill handoff-designClaude Code, o fluxo de handoff Claude Design como produto; a nota linka a skill Tooling e Build pipeline de build Style Dictionary é candidato natural a nota lá, não aqui
Veja também
- Roadmap de Trilhas — UX entra como construção nova em andamento (Tier 1).
- Ferramentas de Design — a metade volátil/tecnológica deste mesmo domínio.
- Acessibilidade — o vizinho mais próximo: a camada técnica que precede este domínio.
- Design do domínio — decisões, roster completo e fronteiras.