frontend-ui-reviewlisted
Install: claude install-skill vellus-tech/forge-harness
# Revisão de implementação de frontend/UI
## Princípio central (leia antes de qualquer checklist)
O design system é um **contrato**. Despadronização quase nunca é preguiça — é acoplamento a um
contrato que não existe, mascarado por um fallback. O caso arquetípico:
`background: var(--surface-1, #fff)` onde `--surface-1` **nunca foi definido**. O browser usa `#fff`
sempre; em light "funciona" por acidente, em dark vira buraco branco. **O fallback é o vilão:
transforma um contrato quebrado em "funciona na minha máquina".**
Regra de ouro: **o CSS/JS deve falhar barulhentamente quando o contrato é violado, não cair
silenciosamente num literal.** A convenção correspondente (não use fallback literal; referencie o
token nu) é `rules/frontend/design-system.md`. Esta skill audita; a rule previne.
Ordem de execução: **gates determinísticos primeiro** (scripts, custo zero, sem LLM), **revisão
semântica depois** (julgamento). O barato e infalível filtra antes do caro e opinativo.
---
## Fase A — Gates determinísticos (bloqueiam o merge)
> Rode sobre a **superfície inteira**, não só o diff (ver Gate A5). Emita **uma linha OK/FAIL por
> gate**. Qualquer FAIL bloqueia. Os scans usam `rg` (ripgrep); onde faltar, `grep -rn` equivalente.
### A0 — Estabeleça a fonte da verdade
Localize o arquivo de tokens (`tokens.css`/`colors-and-type.css` ou equivalente) e o catálogo de
componentes do DS. Sem a lista de tokens **definidos** e de componentes **existentes**, você não
julga nada — o token