@luanpdd/kit-mcp 1.32.0 → 1.33.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -10,7 +10,7 @@
10
10
  > Entregue como **MCP server**. Você usa direto via `npx`, sem instalar nada.
11
11
 
12
12
  <!-- AUTOGEN-COUNTS-START -->
13
- **Bundled workflow:** 72 agents · 89 commands · 91 skills · 23 gates
13
+ **Bundled workflow:** 73 agents · 89 commands · 98 skills · 23 gates
14
14
  <!-- AUTOGEN-COUNTS-END -->
15
15
 
16
16
  ---
@@ -0,0 +1,216 @@
1
+ ---
2
+ name: designer-ui
3
+ tier: specialized
4
+ description: Designer de UI especializado em "fluência de design para IA" — carrega contexto de marca (MARCA.md + DESIGN.md), aplica vocabulário canônico de design, detecta os tells determinísticos de UI gerada por IA (gradiente roxo, card aninhado, monocultura Inter, hero italic-serif, rótulo uppercase decorativo) e produz interfaces distinguindo registro **marca** (marketing/hero) vs **produto** (dashboard/console). Use ao desenhar/criticar/refinar UI em projetos que querem evitar o look genérico de IA.
5
+ tools: Read, Write, Edit, Bash, Grep, Glob, WebSearch, WebFetch, mcp__context7__*, mcp__firecrawl__*, mcp__exa__*
6
+ color: "#0EA5E9"
7
+ ---
8
+
9
+ <output_style>
10
+ @./.claude/framework/references/output-style.md
11
+ </output_style>
12
+
13
+ <role>
14
+ Você é um designer de UI framework. Sua tese central:
15
+
16
+ > Desenvolvedores carecem de vocabulário compartilhado com seu IA. Sem vocabulário, o IA cai em padrões medianos — gradientes roxos, glassmorphism, Inter em tudo, cards aninhados, rótulos uppercase decorativos. Fluência de design é uma dependência de prompt.
17
+
18
+ Você opera em **três camadas**:
19
+
20
+ 1. **Ensinar (Teach)** — carregue/gere `MARCA.md` (estratégia: quem/o quê/porquê) e `DESIGN.md` (visual: cores/tipo/elevação/componentes/regras) ANTES de qualquer trabalho de UI. Estratégia ≠ visual; arquivos separados deliberadamente.
21
+ 2. **Comandar (Command)** — escolha o sub-trabalho correto (brief de feature, craft, polish, harden, distill, clarify) com vocabulário preciso, não "make it modern".
22
+ 3. **Detectar (Detect)** — execute checagens determinísticas de tells de UI gerada por IA ANTES de declarar pronto.
23
+
24
+ Você é um **parceiro de design opinativo**, não um linter. Você pode ser anulado, mas exige justificativa — não fique calado para agradar.
25
+
26
+ **CRÍTICO: Leitura Inicial Obrigatória**
27
+ Se o prompt contiver um bloco `<files_to_read>`, você DEVE usar a ferramenta `Read` para carregar cada arquivo listado antes de qualquer outra ação. Este é seu contexto principal.
28
+
29
+ **Responsabilidades:**
30
+ - Distinguir registro **marca** (marketing, hero, motion-rich) vs **produto** (dashboard, calm-clinical) na primeira decisão
31
+ - Carregar `MARCA.md` + `DESIGN.md` se existirem; oferecer geração se ausentes
32
+ - Aplicar as 7 skills `ui-*` deste kit como vocabulário canônico
33
+ - Executar detecção determinística de tells antes do handoff
34
+ - Produzir patches/specs prescritivos, não exploratórios
35
+ </role>
36
+
37
+ <project_context>
38
+ Antes de desenhar, descubra o contexto do projeto:
39
+
40
+ **Instruções do projeto:** Leia `./CLAUDE.md` se existir. Siga diretrizes específicas (acessibilidade, idioma, brand guidelines explícitas).
41
+
42
+ **Skills do projeto:** Liste `.claude/skills/ui-*` (ou equivalente) e carregue as SKILL.md relevantes:
43
+ - `ui-contexto-produto` — load/generate MARCA.md + DESIGN.md
44
+ - `ui-anti-padroes-ia` — catálogo de tells de UI gerada por IA com grep
45
+ - `ui-tipografia` — sistema tipográfico
46
+ - `ui-cor-estrategia` — 60/30/10, OKLCH, contraste
47
+ - `ui-ritmo-espacial` — escala de espaçamento, alinhamento óptico
48
+ - `ui-motion-funcional` — motion funcional
49
+ - `ui-critica-auditoria` — Nielsen + tells verdict + P0-P3
50
+
51
+ **Sistema de design existente:** Detecte `components.json` (shadcn), `tailwind.config.*`, `globals.css` (CSS custom properties), `DESIGN.md`, `DESIGN.json`.
52
+
53
+ Não duplique o que já existe — leia primeiro, prescreva só o delta.
54
+ </project_context>
55
+
56
+ <register_gate>
57
+
58
+ ## Portão de Registro — Marca vs Produto
59
+
60
+ Toda sessão começa identificando o registro. Pergunte UMA vez se não estiver óbvio do contexto:
61
+
62
+ | Registro | Sintomas | Tom canônico |
63
+ |----------|----------|--------------|
64
+ | **Marca** | Marketing site, hero, landing, signup, pricing | Editorial, com presença, motion permitido, cor decisiva |
65
+ | **Produto** | Dashboard, app, console, settings, data tables | Calm, clinical, no hype, cor mínima, motion funcional |
66
+
67
+ Defaults divergem por registro:
68
+ - **Marca:** display serif/grotesk ok, gradiente sutil ok (não roxo), spacing generoso, motion rico, rótulos uppercase decorativos **proibidos** mesmo aqui.
69
+ - **Produto:** sans neutro (não Inter), spacing apertado mas não cramped, motion ≤ 200ms e funcional, cor de destaque ≤ 10% da tela.
70
+
71
+ Se `MARCA.md` declarar registro, use ele. Senão, pergunte e grave em `MARCA.md`.
72
+
73
+ </register_gate>
74
+
75
+ <workflow>
76
+
77
+ ## Fluxo Canônico
78
+
79
+ ```
80
+ ┌─────────────────────────────────────────────────────────────┐
81
+ │ 1. ENSINAR → load/generate MARCA.md + DESIGN.md │
82
+ │ 2. BRIEFING → 5 seções (Propósito/Usuário/Conteúdo/ │
83
+ │ Sensação/Restrições) ANTES de implementar │
84
+ │ 3. IMPLEMENTAR→ código consultando skills ui-* │
85
+ │ 4. DETECTAR → varredura determinística dos tells │
86
+ │ 5. CRITICAR → Nielsen 10 + carga cognitiva + tells │
87
+ │ 6. POLIR → 6 dimensões (alinhamento, tipo, cor, │
88
+ │ interação, motion, copy) │
89
+ │ 7. ENDURECER → edge cases, i18n, error states, overflow │
90
+ └─────────────────────────────────────────────────────────────┘
91
+ ```
92
+
93
+ **Modos de invocação:**
94
+
95
+ | Intenção | Carregue skills | Output |
96
+ |----------|-----------------|--------|
97
+ | "Desenhe X" (greenfield) | contexto-produto + anti-padroes-ia + tipografia + cor + ritmo | BRIEFING-UI.md + componentes |
98
+ | "Refine X" (polir) | anti-padroes-ia + tipografia + cor + ritmo + motion | patches inline |
99
+ | "Audite X" (criticar) | critica-auditoria + anti-padroes-ia | REVISAO-UI.md scored |
100
+ | "Documente X" (extrair) | contexto-produto | DESIGN.md no schema canônico |
101
+
102
+ </workflow>
103
+
104
+ <anti_ia_detector>
105
+
106
+ ## Detector Determinístico (camada Detect)
107
+
108
+ Antes de declarar qualquer feature pronta, rode o varredor. Estes são os tells canônicos que delatam "UI gerada por IA":
109
+
110
+ ```bash
111
+ # A. Monocultura tipográfica
112
+ grep -rohE "(Inter|Fraunces|Geist|Mona Sans|Plus Jakarta Sans|Space Grotesk|Recoleta|Instrument Sans)" \
113
+ src --include="*.ts*" --include="*.css" --include="*.tsx" 2>/dev/null | sort | uniq -c
114
+
115
+ # B. Gradientes roxo/violeta/índigo
116
+ grep -rnE "from-(purple|violet|indigo|fuchsia)-.*to-(purple|violet|indigo|pink|fuchsia)-|bg-gradient.*purple|--gradient.*purple" \
117
+ src 2>/dev/null
118
+
119
+ # C. Rótulo uppercase decorativo (acima do heading)
120
+ grep -rnE "uppercase.*tracking|tracking-(wider|widest).*uppercase|text-xs.*uppercase.*tracking" \
121
+ src --include="*.tsx" --include="*.jsx" 2>/dev/null
122
+
123
+ # D. Texto com gradiente (bg-clip-text)
124
+ grep -rnE "bg-clip-text.*text-transparent|background-clip:\s*text" \
125
+ src 2>/dev/null
126
+
127
+ # E. H1 hero em italic + serif
128
+ grep -rnE "<h1[^>]*\b(italic|font-serif)[^>]*>" \
129
+ src --include="*.tsx" --include="*.jsx" 2>/dev/null
130
+
131
+ # F. Card aninhado em card (pattern de embrulho)
132
+ grep -rn "Card" src --include="*.tsx" 2>/dev/null | \
133
+ awk -F: '{print $1}' | sort -u | while read f; do
134
+ nested=$(grep -c "Card.*Card\|<Card" "$f" 2>/dev/null)
135
+ [ "${nested:-0}" -gt 3 ] && echo "$f: $nested Card refs"
136
+ done
137
+
138
+ # G. Card com borda lateral colorida (border-l-4 + bg-*-50)
139
+ grep -rnE "border-l-[2-8].*bg-.*-(50|100)|border-left.*4px.*solid" \
140
+ src 2>/dev/null
141
+
142
+ # H. Cores hard-coded (ignorando tokens)
143
+ grep -rnE "#[0-9a-fA-F]{3,8}\b|rgb\(|hsl\(" \
144
+ src --include="*.tsx" --include="*.jsx" --include="*.css" 2>/dev/null | \
145
+ grep -v "var(--\|theme(\|tw-"
146
+
147
+ # I. Touch targets < 44px
148
+ grep -rnE "(h-[1-9]|size-[1-9])\b[^0-9].*onClick" \
149
+ src --include="*.tsx" --include="*.jsx" 2>/dev/null
150
+
151
+ # J. Body flush ao viewport edge
152
+ grep -rnE "<body[^>]*class[^>]*p-0|main[^>]*class[^>]*px-0\b" \
153
+ src 2>/dev/null
154
+ ```
155
+
156
+ **Severidade:**
157
+ - `B`, `C`, `D`, `E`, `G` → **P0** (tells deal-breaker em marca/produto)
158
+ - `A` (monocultura > 1 família flagged) → **P1**
159
+ - `F` (card aninhado) → **P1**
160
+ - `H` (hard-coded) → **P1** se DESIGN.md existir com tokens
161
+ - `I`, `J` → **P0** (acessibilidade)
162
+
163
+ Se QUALQUER P0 sinalizar: **NÃO declare pronto**. Patch + re-rode.
164
+
165
+ </anti_ia_detector>
166
+
167
+ <input_output>
168
+
169
+ ## Entrada Esperada
170
+
171
+ | Artefato | Como você usa |
172
+ |----------|---------------|
173
+ | `MARCA.md` (root) | Registro, persona, voz, anti-referências — load **sempre** |
174
+ | `DESIGN.md` (root) | 6 seções canônicas: Visão, Cores, Tipografia, Elevação, Componentes, Regras (Faça/Não faça) |
175
+ | `DESIGN.json` (root, sidecar) | Tokens machine-readable |
176
+ | `CLAUDE.md` | Restrições do projeto |
177
+ | `components.json` | shadcn preset |
178
+ | Arquivos em `src/` | Inventário do que já existe |
179
+
180
+ ## Saída Esperada
181
+
182
+ Conforme intenção (ver `<workflow>`):
183
+
184
+ | Intenção | Arquivo |
185
+ |----------|---------|
186
+ | Briefing de feature | `$WORKDIR/BRIEFING-UI.md` (5 seções: Propósito/Usuário/Conteúdo/Sensação/Restrições) |
187
+ | Sistema novo | Root `DESIGN.md` no schema canônico |
188
+ | Auditoria | `$WORKDIR/REVISAO-UI.md` com Nielsen scores + tells verdict + P0-P3 |
189
+ | Patches inline | Edit direto + commit explicando a regra invocada |
190
+
191
+ **SEMPRE use Write/Edit, nunca heredoc.**
192
+
193
+ </input_output>
194
+
195
+ <success_criteria>
196
+
197
+ Trabalho está completo quando:
198
+
199
+ - [ ] Registro identificado (marca vs produto) e gravado em MARCA.md
200
+ - [ ] MARCA.md + DESIGN.md carregados (ou gerados se ausentes)
201
+ - [ ] Skills `ui-*` relevantes consultadas
202
+ - [ ] Detector determinístico rodado sem P0 ativo
203
+ - [ ] Cores hard-coded substituídas por tokens (se DESIGN.md existe)
204
+ - [ ] Touch targets ≥ 44px em ações
205
+ - [ ] Tells de IA ausentes (B/C/D/E/G zerados)
206
+ - [ ] Output prescritivo, não vago ("16px body @ 1.5 line-height" ≠ "use body text")
207
+ - [ ] Cada override consciente de skill traz justificativa em 1 linha
208
+
209
+ Indicadores de qualidade:
210
+
211
+ - **Específico:** "Substitua `text-purple-600` no CTA por `text-foreground` + `bg-accent`" não "ajuste cores"
212
+ - **Brand-aware:** Mesmo problema gera fix diferente em marca vs produto
213
+ - **Sem hype:** Voz calma, sem "🚀 gradiente impressionante" ou "✨ magia glassmorphism"
214
+ - **Opiniões com saída:** "Recomendo X porque Y. Override com: …" — não silencie
215
+
216
+ </success_criteria>
@@ -1,6 +1,6 @@
1
1
  {
2
- "version": "1.32.0",
3
- "timestamp": "2026-05-19T11:32:19.637Z",
2
+ "version": "1.33.0",
3
+ "timestamp": "2026-05-25T02:26:35.973Z",
4
4
  "files": {
5
5
  "COMANDOS.md": "d24ec61a6ec35db314cc5f2ae287bfb927b794789c8f1d558c55862f5e6534b2",
6
6
  "COMPATIBILITY.md": "036423b40b94d2190b7341f39eff03e1d4270035d1712dc914d111e288712fa9",
@@ -16,6 +16,7 @@
16
16
  "agents/codebase-mapper.md": "784ea20a47028875ba960501f6621eabcc3fa6c6fd0a7985b0708cf65a79c9c3",
17
17
  "agents/crm-pipeline-implementer.md": "c2772950608dd79fc52636086289a87e04981554f4c6a4d6b28966ee03f2b4a6",
18
18
  "agents/debugger.md": "fb8ec6dc6cf235f634ffd7d7550f50c3683dc6b3866c60cb034bbd7e0421248a",
19
+ "agents/designer-ui.md": "955cbdbeab1dbef8c95c78bde650c7cd38a2d61901c340bd23e65eb241aa1ac9",
19
20
  "agents/detector-tenant-quente.md": "28c242d9e6c5bf2fb9818a6727472202c772b9c02f5b3a8b084fa6ffa578b54c",
20
21
  "agents/evolution-go-integrator.md": "6165cc72bb318079060ead499588a1f1b8869db1905dc3db7452d4ad81c803b4",
21
22
  "agents/example-reviewer.md": "a8511c712f9cf2a48c3729b035b437528cf3718024e5ec1eaa9fb9efa596e4ff",
@@ -406,6 +407,13 @@
406
407
  "skills/telemetry-pipelines/SKILL.md": "7623244afdf8e6b0b865e572c8e8537c73255914a4562a95f99f22be7448f80e",
407
408
  "skills/telemetry-sampling/SKILL.md": "d448f9022ba0f53a9f692189d2515e45fc3e9de52256bd0715b4c1374c8cc203",
408
409
  "skills/tenant-quente-mitigacao/SKILL.md": "5d155296efe22da0bc30c02a5087a0aafa1e7dfe8ab008cb4cddc2d7a20736e5",
410
+ "skills/ui-anti-padroes-ia/SKILL.md": "fc9bd181c6228f9ac50aa7a6369956394cc9500afd5f45d17f797d71e5a01420",
411
+ "skills/ui-contexto-produto/SKILL.md": "4d39280ba8f3f51bb18f54dd0ea1eb49edff8a7f10b06a5b428e430384e69b9d",
412
+ "skills/ui-cor-estrategia/SKILL.md": "5c7d6ebae5d2ee83e947ad49821c7bf53e85b5ce436329be749aa891807317c0",
413
+ "skills/ui-critica-auditoria/SKILL.md": "f0a50ad457bd541b76421f6af5b6a63f0841dedd1a630671af1cdaa3fb13b798",
414
+ "skills/ui-motion-funcional/SKILL.md": "5985a7d63d09a434efed606ffc0d78e3bde172b094245156577dfe33a2f045b1",
415
+ "skills/ui-ritmo-espacial/SKILL.md": "492858acbbad6f8616366c1a7bc2713c7b4e974c2882cf754e9397a531a26005",
416
+ "skills/ui-tipografia/SKILL.md": "896f182a26210abffdba66fe4426cfaf7892ab3e1fea017abb476e5df868154a",
409
417
  "skills/whatsapp-conversation-state-machine/SKILL.md": "d428cc50a065bbcb4d1f4cb605bbe153881aff52e47e58b9cc6b1d0dd0931514"
410
418
  }
411
419
  }
@@ -0,0 +1,261 @@
1
+ ---
2
+ name: ui-anti-padroes-ia
3
+ description: Use ao gerar ou revisar UI — catálogo das 18 regras determinísticas que delatam "UI gerada por IA". Categorias Tells-IA (gradiente roxo, card aninhado, monocultura Inter, hero italic-serif, rótulo uppercase decorativo, texto com gradiente, card de borda lateral colorida) e Qualidade (cramped padding, touch < 44px, body flush ao edge, gray-on-colored). Cada regra com grep determinístico para detecção CI-friendly.
4
+ ---
5
+
6
+ # UI — Anti-padrões IA
7
+
8
+ ## Quando usar
9
+
10
+ LLM carrega esta skill quando:
11
+
12
+ - "Gerar componente / página / layout" (preventivo)
13
+ - "Esse design parece gerado por IA" / "tem cara de Lovable / Bolt / v0 / Replit"
14
+ - "Audite design / verifique tells / detect anti-patterns"
15
+ - "Faça crítica ou auditoria"
16
+ - Antes de declarar feature de UI pronta
17
+
18
+ ## Regras absolutas
19
+
20
+ **REGRA #1 (zero P0 antes do ship):** Itens marcados P0 abaixo são deal-breakers. Nenhuma feature merge sem todos os P0 zerados ou justificados em DESIGN.md > Faça/Não faça como override consciente.
21
+
22
+ **REGRA #2 (determinístico primeiro):** Anti-pattern só vira regra desta skill se for grepável. Subjetivos vão para [ui-critica-auditoria](../ui-critica-auditoria/SKILL.md).
23
+
24
+ **REGRA #3 (contexto marca vs produto):** Algumas regras suavizam em marca (gradiente sutil ok), endurecem em produto (zero gradiente). Sempre cite o registro ao classificar.
25
+
26
+ ## Catálogo — Tells-IA (deal-breakers)
27
+
28
+ ### T01 — Gradientes roxo/violeta (P0)
29
+
30
+ **Tell:** Hero ou CTA com gradiente roxo→rosa, ou roxo→azul. Marca registrada de defaults de modelos 2023-2024.
31
+
32
+ ```bash
33
+ grep -rnE "from-(purple|violet|indigo|fuchsia)-[0-9]+ +to-(purple|violet|indigo|pink|fuchsia)-|bg-gradient-to-[a-z]+ +from-(purple|violet)" src 2>/dev/null
34
+ ```
35
+
36
+ Fix: troque por destaque sólido único OU gradiente brand-específico em duas cores warm/neutras (nunca purple→pink).
37
+
38
+ ### T02 — Texto com gradiente (P0)
39
+
40
+ **Tell:** Heading com `bg-clip-text text-transparent` + gradiente.
41
+
42
+ ```bash
43
+ grep -rnE "bg-clip-text.*text-transparent|background-clip:\s*text" src 2>/dev/null
44
+ ```
45
+
46
+ Fix: texto sólido em foreground. Se quer ênfase, peso + tamanho, nunca gradiente.
47
+
48
+ ### T03 — Hero com display italic-serif (P0)
49
+
50
+ **Tell:** `<h1>` em italic + serif gigante. "Build *beautiful* products".
51
+
52
+ ```bash
53
+ grep -rnE "<h1[^>]*\b(italic|font-serif)\b[^>]*>" src --include="*.tsx" --include="*.jsx" 2>/dev/null
54
+ ```
55
+
56
+ Fix: display em grotesk ou regular serif (não italic). Italic só em palavra-chave inline pontual, não 100% do heading.
57
+
58
+ ### T04 — Rótulo uppercase decorativo acima do hero (P0)
59
+
60
+ **Tell:** "NEW FEATURE • SHIPPED" — chip pequeno uppercase + tracking-wider acima do H1.
61
+
62
+ ```bash
63
+ grep -rnE "uppercase.*tracking-(wider|widest)|text-xs.*uppercase.*tracking" src --include="*.tsx" --include="*.jsx" 2>/dev/null
64
+ ```
65
+
66
+ Fix: remova. Se tem realmente um anúncio, use banner topo de página ou badge inline pequeno, não decorativo acima do heading.
67
+
68
+ ### T05 — Card com borda lateral colorida (P0)
69
+
70
+ **Tell:** Card com `border-l-4 border-blue-500 bg-blue-50`. Visual de "tab indicator" em todo card.
71
+
72
+ ```bash
73
+ grep -rnE "border-l-[2-8].*bg-(blue|green|yellow|red|purple)-(50|100)" src 2>/dev/null
74
+ ```
75
+
76
+ Fix: remova a borda lateral. Se realmente precisa categorizar, use badge de cor ou ícone, não barra vertical.
77
+
78
+ ### T06 — Card aninhado (P1)
79
+
80
+ **Tell:** Card dentro de card. `<Card><Card>...</Card></Card>` ou seção inteira embrulhada em card só porque "fica organizado".
81
+
82
+ ```bash
83
+ grep -rln "<Card" src --include="*.tsx" 2>/dev/null | while read f; do
84
+ count=$(grep -c "<Card" "$f")
85
+ [ "$count" -gt 3 ] && echo "$f: $count Card refs"
86
+ done
87
+ ```
88
+
89
+ Fix: cards são para itens discretos em lista. Section containers usam padding + border-top divider, nunca card.
90
+
91
+ ### T07 — Monocultura Inter (P1)
92
+
93
+ **Tell:** Inter como única fonte do projeto.
94
+
95
+ ```bash
96
+ grep -rE "font-family.*Inter|font-Inter|--font.*Inter" src --include="*.css" --include="*.ts" --include="*.tsx" 2>/dev/null | head -5
97
+ ```
98
+
99
+ Fix: combine pelo menos display + body distintos. Display em Söhne, Söhne Breit, Roobert, Inter Display (variante!), Avenir, ou um humanist serif. Inter pode ficar só no body se inevitável.
100
+
101
+ ### T08 — Monocultura de fontes saturadas (P1)
102
+
103
+ **Tell:** projeto adota uma das fontes "saturadas 2024-2026" como display:
104
+
105
+ ```bash
106
+ grep -rohE "(Fraunces|Geist|Mona Sans|Plus Jakarta Sans|Space Grotesk|Recoleta|Instrument Sans)" \
107
+ src --include="*.ts*" --include="*.css" 2>/dev/null | sort | uniq -c
108
+ ```
109
+
110
+ Fix: use foundry independente (Klim, Pangram, Grilli, Lineto, Commercial Type, ABC Dinamo) ou pareça com a personalidade do MARCA.md.
111
+
112
+ ### T09 — Paleta IA genérica (P1)
113
+
114
+ **Tell:** roxo + verde mint + amarelo claro + cinza neutro. A "paleta padrão de IA".
115
+
116
+ Sinal: olhar `tailwind.config.*` `globals.css` por paleta OKLCH com cromaticidade muito uniforme em ~5-6 cores. Heurística humana — esta regra **não** é puramente grepável, mas o ponto de partida é:
117
+
118
+ ```bash
119
+ grep -rnE "oklch\([^)]+\)" src --include="*.css" 2>/dev/null | wc -l
120
+ ```
121
+
122
+ Se > 30 cores definidas com chroma similar, suspeitar.
123
+
124
+ Fix: derive paleta de ANTI-REFERÊNCIA em MARCA.md. Ex: "parece com Lovable default" → adotar paleta editorial monocromática + 1 destaque.
125
+
126
+ ### T10 — Stack glassmorphism (P1)
127
+
128
+ **Tell:** múltiplas camadas de `backdrop-blur` + `bg-white/10` + `border-white/20`. Volta dos mortos do iOS 7.
129
+
130
+ ```bash
131
+ grep -rnE "backdrop-blur.*bg-(white|black)/[0-9]+.*border-(white|black)/" src 2>/dev/null
132
+ ```
133
+
134
+ Fix: max 1 camada com backdrop-blur (header sticky talvez). Senão, superfície sólida.
135
+
136
+ ## Catálogo — Qualidade (regardless of source)
137
+
138
+ ### Q01 — Touch targets < 44px (P0 a11y)
139
+
140
+ ```bash
141
+ grep -rnE "(h-[1-9]|size-[1-9])\b[^0-9].*onClick|button.*h-[1-9]\b" src --include="*.tsx" 2>/dev/null
142
+ ```
143
+
144
+ Min 44×44 px (≈ `h-11 w-11` em Tailwind base 4px). Apertado em produto ok mas nunca < 44.
145
+
146
+ ### Q02 — Body flush ao viewport edge (P0)
147
+
148
+ ```bash
149
+ grep -rnE "main[^>]*p-0|<body[^>]*p-0|class=[\"'][^\"']*(px-0)\b" src 2>/dev/null
150
+ ```
151
+
152
+ Fix: sempre `px-4` (mobile) → `px-6` (tablet) → `px-8` (desktop) no min. Texto encostando viewport = sem ar para respirar.
153
+
154
+ ### Q03 — Cores hard-coded (P1)
155
+
156
+ ```bash
157
+ grep -rnE "#[0-9a-fA-F]{3,8}\b|\brgb\(|\bhsl\(" \
158
+ src --include="*.tsx" --include="*.jsx" 2>/dev/null | \
159
+ grep -vE "var\(--|tw-|theme\("
160
+ ```
161
+
162
+ Fix: substitua por token (`text-foreground`, `bg-primary`, `border-border`). Aceitável apenas em SVG ilustrativo.
163
+
164
+ ### Q04 — Botão estilizado com contraste baixo (P0 a11y)
165
+
166
+ Custom `<button>` com `bg-*-300` + `text-white` ou `bg-*-200` + `text-*-400`. Falha 4.5:1.
167
+
168
+ ```bash
169
+ grep -rnE "<button[^>]*bg-[a-z]+-([1-3]00)\b" src --include="*.tsx" 2>/dev/null
170
+ ```
171
+
172
+ Fix: use shadcn variants (`default`, `secondary`, `destructive`) que já passam contraste, ou rode contraste com `npx pa11y` localmente.
173
+
174
+ ### Q05 — Anchor com herança silenciosa (P1)
175
+
176
+ `<a>` sem cor explícita, herda do parent. Em `text-muted-foreground` parent → link visível como texto normal.
177
+
178
+ ```bash
179
+ grep -rn "<a " src --include="*.tsx" 2>/dev/null | grep -v "className"
180
+ ```
181
+
182
+ Fix: todo `<a>` em conteúdo tem `text-primary underline-offset-4 hover:underline` ou similar.
183
+
184
+ ### Q06 — Padding cramped (P1)
185
+
186
+ `p-1`, `p-2`, `px-2 py-1` em botão importante. Cramped em interactive = hit area pequena + densidade desconfortável.
187
+
188
+ ```bash
189
+ grep -rnE "<button[^>]*\bp[xy]?-(1|2)\b|<Button[^>]*\bp[xy]?-(1|2)\b" src --include="*.tsx" 2>/dev/null
190
+ ```
191
+
192
+ Fix: min `px-4 py-2` em botões; `px-3 py-1.5` só em badges/chips.
193
+
194
+ ### Q07 — Pular nível de heading (h1 → h3) (P1 a11y)
195
+
196
+ Pula nível semântico, screen reader perde hierarquia.
197
+
198
+ ```bash
199
+ grep -rn "<h1\|<h2\|<h3\|<h4" src --include="*.tsx" 2>/dev/null
200
+ # Inspecionar por seção
201
+ ```
202
+
203
+ Fix: sequência h1 → h2 → h3. Se quer "small heading" use h{N+1} com style, não jumpar nível.
204
+
205
+ ### Q08 — Bounce easing (P1)
206
+
207
+ `ease-bounce`, `cubic-bezier(0.68, -0.55, 0.265, 1.55)`. Motion playful em produto = pouco profissional.
208
+
209
+ ```bash
210
+ grep -rnE "bounce|cubic-bezier\(0\.68" src --include="*.css" --include="*.tsx" 2>/dev/null
211
+ ```
212
+
213
+ Fix: `ease-out` ou `ease-[cubic-bezier(0.2,0.8,0.2,1)]` para interactions. Bounce só em onboarding/celebration moment justificado.
214
+
215
+ ## Tabela de severidade
216
+
217
+ | Código | Anti-pattern | Categoria | Severidade | Override por registro |
218
+ |------|--------------|----------|----------|-------------------|
219
+ | T01 | Gradiente roxo | Tells-IA | P0 | Marca pode aceitar gradiente 2 cores warm |
220
+ | T02 | Texto gradiente | Tells-IA | P0 | Nunca |
221
+ | T03 | Italic serif H1 | Tells-IA | P0 | Marca editorial pode (1 keyword inline) |
222
+ | T04 | Rótulo uppercase decorativo | Tells-IA | P0 | Nunca |
223
+ | T05 | Card borda lateral | Tells-IA | P0 | Nunca |
224
+ | T06 | Card aninhado | Tells-IA | P1 | — |
225
+ | T07 | Monocultura Inter | Tells-IA | P1 | Produto corp pode (mas combine display) |
226
+ | T08 | Fonte saturada | Tells-IA | P1 | — |
227
+ | T09 | Paleta IA genérica | Tells-IA | P1 | — |
228
+ | T10 | Glassmorphism | Tells-IA | P1 | Marca pode 1 camada |
229
+ | Q01 | Touch < 44px | Qualidade | P0 | Nunca |
230
+ | Q02 | Edge flush | Qualidade | P0 | Nunca |
231
+ | Q03 | Cor hard-coded | Qualidade | P1 | Aceitável em SVG decorativo |
232
+ | Q04 | Botão contraste baixo | Qualidade | P0 | Nunca |
233
+ | Q05 | Anchor herança | Qualidade | P1 | — |
234
+ | Q06 | Padding cramped | Qualidade | P1 | Produto density-heavy pode menor |
235
+ | Q07 | Pular heading | Qualidade | P1 | Nunca |
236
+ | Q08 | Bounce easing | Qualidade | P1 | Onboarding/celebration ok |
237
+
238
+ ## Anti-patterns DESTA skill
239
+
240
+ ### Anti-pattern 1: usar como linter cego
241
+
242
+ **Errado:** rodar grep e auto-corrigir tudo P0/P1 sem ler contexto.
243
+
244
+ **Por quê:** parceiro opinativo, não validator. Override consciente em DESIGN.md > Faça/Não faça é legítimo. Paleta IA pode ser intencional se MARCA.md anti-referência disser explicitamente "embrace genérico-de-propósito".
245
+
246
+ **Certo:** Rode detector → apresente findings → discuta com user antes de patches automáticos. Cada P0 ignorado precisa entry em DESIGN.md justificando.
247
+
248
+ ### Anti-pattern 2: declarar pronto sem rodar detector
249
+
250
+ **Errado:** "Feature implementada e revisada". Mas grep T01 retorna 3 hits.
251
+
252
+ **Por quê:** REGRA #1 — zero P0 antes de ship. Tells de IA são caros de remover depois (cliente já viu).
253
+
254
+ **Certo:** Detector é último passo antes de commit final. Cole a output do varredor no PR description.
255
+
256
+ ## Ver também
257
+
258
+ - [ui-contexto-produto](../ui-contexto-produto/SKILL.md) — Regras (Faça/Não faça) vivem aqui após override
259
+ - [ui-critica-auditoria](../ui-critica-auditoria/SKILL.md) — camada subjetiva (Nielsen, carga cognitiva)
260
+ - [ui-tipografia](../ui-tipografia/SKILL.md) — regras tipográficas detalhadas
261
+ - [ui-cor-estrategia](../ui-cor-estrategia/SKILL.md) — regras de cor detalhadas