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 skill verificar-nota quanto a regra de diagnosticar-galho que 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.md para 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-galhoO quêFase
1SG1 — Fundamentos e Modelo Mentalaffordances e signifiers, as 10 heurísticas de Nielsen, leis de UX, Gestalt aplicada a UIIniciado
2SG2 — Descoberta e Pesquisagenerativa vs avaliativa, Mom Test, cliente ≠ usuário, JTBD, Opportunity Solution Tree, personas, teste de usabilidade guerrilha, personas sintéticasIniciado/Adepto
3SG3 — Arquitetura de Informaçãoos 4 sistemas da AI, taxonomia vs navegação, card sorting e tree testing, wayfindingAdepto
4SG4 — Design de Interaçãofluxo antes da tela, os 5 estados de tela, progressive disclosure, modal vs página vs drawer, undo vs confirmação, formulários, latência percebidaAdepto
5SG5 — Linguagem Visual e Design Systemhierarquia visual, escalas de tipografia/espaçamento, cor em OKLCH, design tokens, Atomic Design, component API design, adotar vs construirAdepto/Magus
6SG6 — UX Writing e Content Designvoz e tom, microcopy, erros e recuperação, estados vazios como conteúdo, i18n quebrando layoutAdepto
7SG7 — Medir, Validar e SustentarHEART/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úmeroMagus
8SG8 — Ética e Ofíciodark patterns e regulação, UX no ciclo de dev, UX em entrevista sênior/staffMagus
Capstone — Do requisito ao produto validadociclo completo: descobrir com o cliente, definir, desenhar, construir, instrumentar, medir, priorizar a dívidaMagus

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)

  1. UX não é tela — o ofício e seus limites
  2. Affordances e signifiers
  3. As 10 heurísticas de Nielsen
  4. Leis de UX
  5. Gestalt aplicada a UI

SG2 — Descoberta e pesquisa · Iniciado/Adepto (9)

  1. Generativa vs avaliativa
  2. Entrevista de descoberta — as regras do Mom Test
  3. Cliente não é usuário — a armadilha do B2B/consultoria
  4. Jobs To Be Done — as duas escolas
  5. Opportunity Solution Tree de bolso
  6. Assumption mapping
  7. Proto-persona vs persona de verdade
  8. Teste de usabilidade guerrilha com 5 usuários
  9. Personas sintéticas e síntese por IA

SG3 — Arquitetura de informação · Adepto (4)

  1. Os 4 sistemas da AI
  2. Schema de banco não é estrutura de navegação
  3. Card sorting e tree testing de guerrilha
  4. Navegação e wayfinding

SG4 — Design de interação · Adepto (7)

  1. Do fluxo antes da tela
  2. Os 5 estados de tela
  3. Progressive disclosure
  4. Modal vs página vs drawer
  5. Undo vs confirmação
  6. Design de formulários — defaults
  7. Latência percebida e feedback

SG5 — Linguagem visual e design system · Adepto/Magus (7)

  1. Hierarquia visual
  2. Escalas de tipografia, espaçamento e densidade
  3. Cor de produto: OKLCH e paleta semântica
  4. Design tokens como sistema
  5. Atomic Design — o que ainda vale
  6. Component API design
  7. Adotar vs construir, e governança mínima para um time de um

SG6 — UX writing e content design · Adepto (5)

  1. Voz e tom
  2. Microcopy, labels de ação e jargão interno
  3. Erros: fluxo de recuperação e mensagem que não culpa
  4. Estados vazios como conteúdo
  5. i18n quebra layout

SG7 — Medir, validar e sustentar · Magus (8)

  1. HEART + Goals-Signals-Metrics
  2. SUS, UMUX-Lite, SUPR-Q, SEQ
  3. NPS e North Star — promessa, crítica e Goodhart
  4. Instrumentação: event taxonomy e tracking plan
  5. Quando A/B não se aplica
  6. Session replay e heatmap
  7. UX debt e matriz severidade × esforço
  8. Defender decisão de UX com número

SG8 — Ética e ofício · Magus (3)

  1. Dark patterns e regulação
  2. UX no ciclo de dev
  3. UX em entrevista sênior/staff

Capstone

  1. 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 existenteO que já está láO que é novo aqui
Acessibilidade (21 notas)accessibility tree, WCAG 2.2, ARIA APG, foco em SPA, contraste, cor acessívela 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 06custom properties, mecânica de tokens em CSS, responsivotokens como sistema (hierarquia, governança, padrão DTCG), não a sintaxe CSS
03comparação técnica MUI/Radix/shadcn/Mantine com códigoo quando adotar como decisão de produto
10, 11tabelas, data grids, libs de gráficosnada — apenas linkar
Web PerformanceINP, LCP, CLS, lab vs field, CrUXmétrica de UX (satisfação, sucesso de tarefa, retenção). Performance é insumo de UX, não a mesma coisa; vale uma nota-ponte curta
14Playwright além do básicoPlaywright como loop de feedback visual/de design
skill datavizpaleta categórica/sequencial, heurística de formapaleta de produto/UI, não de dados
Claude Code + skill handoff-designClaude Code, o fluxo de handoffClaude Design como produto; a nota linka a skill
Tooling e Buildpipeline de buildStyle Dictionary é candidato natural a nota , não aqui

Veja também