@luanpdd/kit-mcp 1.35.0 → 1.36.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.
Files changed (117) hide show
  1. package/bin/cli.js +2 -2
  2. package/bin/mcp.js +6 -6
  3. package/bin/ui.js +74 -74
  4. package/gates/ai-prompt-stability.md +120 -120
  5. package/gates/budget-description.md +68 -68
  6. package/gates/confidence.md +29 -29
  7. package/gates/dependency-check.md +33 -33
  8. package/gates/dept-cycle-prevention.md +179 -179
  9. package/gates/golden-signals-coverage.md +133 -133
  10. package/gates/legacy-refactor-safety.md +178 -178
  11. package/gates/multi-tenant-rls-coverage.md +102 -102
  12. package/gates/no-personal-uuid.md +72 -72
  13. package/gates/obs-agents-mcp-supabase.md +86 -86
  14. package/gates/obs-skills-frontmatter.md +76 -76
  15. package/gates/observability-coverage.md +151 -151
  16. package/gates/omm-no-regression.md +83 -83
  17. package/gates/postmortem-template-required.md +127 -127
  18. package/gates/prr-checklist-coverage.md +128 -128
  19. package/gates/regression.md +32 -32
  20. package/gates/release-pipeline-policy.md +132 -132
  21. package/gates/secrets-scan.md +33 -33
  22. package/gates/service-role-not-in-user-facing.md +113 -113
  23. package/gates/skill-must-include.md +71 -71
  24. package/gates/sync-idempotent.md +62 -62
  25. package/gates/verify-phase-goal.md +34 -34
  26. package/kit/agents/designer-ui.md +216 -216
  27. package/kit/agents/workflow-generator.md +537 -167
  28. package/kit/commands/adicionar-backlog.md +1 -1
  29. package/kit/commands/adicionar-fase.md +1 -1
  30. package/kit/commands/adicionar-tarefa.md +1 -1
  31. package/kit/commands/auditar-observabilidade.md +103 -103
  32. package/kit/commands/auditar-toil.md +129 -129
  33. package/kit/commands/caracterizar-prompt.md +195 -195
  34. package/kit/commands/criar-workflow.md +158 -158
  35. package/kit/commands/definir-perfil.md +1 -1
  36. package/kit/commands/definir-slo.md +108 -108
  37. package/kit/commands/fio.md +1 -1
  38. package/kit/commands/golden-signals.md +142 -142
  39. package/kit/commands/instrumentar-fase.md +200 -200
  40. package/kit/commands/investigar-producao.md +162 -162
  41. package/kit/commands/observabilidade.md +118 -118
  42. package/kit/commands/postmortem.md +179 -179
  43. package/kit/commands/prr.md +205 -205
  44. package/kit/commands/publicar-rapido.md +207 -207
  45. package/kit/commands/risk-budget.md +220 -220
  46. package/kit/commands/sre.md +230 -230
  47. package/kit/file-manifest.json +424 -424
  48. package/kit/framework/references/output-style.md +22 -22
  49. package/kit/hooks/post-apply-migration.js +199 -199
  50. package/kit/hooks/sidecar-tool-publisher.js +210 -210
  51. package/kit/skills/_shared-dados-distribuidos/glossary.md +224 -224
  52. package/kit/skills/_shared-legacy/glossary.md +389 -389
  53. package/kit/skills/_shared-multi-tenant/glossary.md +186 -186
  54. package/kit/skills/_shared-observability/glossary.md +396 -396
  55. package/kit/skills/_shared-sre/glossary.md +712 -712
  56. package/kit/skills/_shared-supabase/glossary.md +234 -234
  57. package/kit/skills/blameless-postmortems/SKILL.md +340 -340
  58. package/kit/skills/burn-rate-alerting/SKILL.md +258 -258
  59. package/kit/skills/cascading-failures/SKILL.md +311 -311
  60. package/kit/skills/core-analysis-loop/SKILL.md +352 -352
  61. package/kit/skills/distributed-tracing/SKILL.md +362 -362
  62. package/kit/skills/dynamic-workflow-authoring/SKILL.md +327 -223
  63. package/kit/skills/eliminating-toil/SKILL.md +243 -243
  64. package/kit/skills/event-based-slos/SKILL.md +296 -296
  65. package/kit/skills/four-golden-signals/SKILL.md +314 -314
  66. package/kit/skills/hermetic-builds/SKILL.md +323 -323
  67. package/kit/skills/legacy-monster-methods/SKILL.md +444 -444
  68. package/kit/skills/llm-as-dependency/SKILL.md +436 -436
  69. package/kit/skills/load-shedding-graceful-degradation/SKILL.md +396 -396
  70. package/kit/skills/observability-driven-development/SKILL.md +315 -315
  71. package/kit/skills/observability-maturity-model/SKILL.md +222 -222
  72. package/kit/skills/opentelemetry-standard/SKILL.md +351 -351
  73. package/kit/skills/production-readiness-review/SKILL.md +305 -305
  74. package/kit/skills/release-engineering/SKILL.md +367 -367
  75. package/kit/skills/retry-strategies/SKILL.md +372 -372
  76. package/kit/skills/sre-risk-management/SKILL.md +221 -221
  77. package/kit/skills/structured-events/SKILL.md +265 -265
  78. package/kit/skills/supabase-cron-queues/SKILL.md +275 -275
  79. package/kit/skills/supabase-database-functions/SKILL.md +332 -332
  80. package/kit/skills/supabase-declarative-schema/SKILL.md +183 -183
  81. package/kit/skills/supabase-pgvector-rag/SKILL.md +253 -253
  82. package/kit/skills/supabase-postgres-style/SKILL.md +138 -138
  83. package/kit/skills/supabase-storage/SKILL.md +234 -234
  84. package/kit/skills/telemetry-pipelines/SKILL.md +259 -259
  85. package/kit/skills/telemetry-sampling/SKILL.md +256 -256
  86. package/kit/skills/ui-anti-padroes-ia/SKILL.md +261 -261
  87. package/kit/skills/ui-contexto-produto/SKILL.md +248 -248
  88. package/kit/skills/ui-cor-estrategia/SKILL.md +213 -213
  89. package/kit/skills/ui-critica-auditoria/SKILL.md +260 -260
  90. package/kit/skills/ui-motion-funcional/SKILL.md +264 -264
  91. package/kit/skills/ui-ritmo-espacial/SKILL.md +259 -259
  92. package/kit/skills/ui-tipografia/SKILL.md +211 -211
  93. package/package.json +1 -1
  94. package/src/cli/index.js +1114 -1114
  95. package/src/cli/render.js +194 -194
  96. package/src/cli/upgrade-check.js +135 -135
  97. package/src/core/error-redaction.js +76 -76
  98. package/src/core/failures.js +153 -153
  99. package/src/core/gate-runner.js +205 -205
  100. package/src/core/gates.js +82 -82
  101. package/src/core/logger.js +170 -170
  102. package/src/core/manifest-verify.js +174 -174
  103. package/src/core/metrics.js +268 -268
  104. package/src/core/notify.js +60 -60
  105. package/src/core/path-safety.js +141 -141
  106. package/src/core/replays.js +120 -120
  107. package/src/core/ui.js +185 -185
  108. package/src/mcp-server/install.js +149 -149
  109. package/src/mcp-server/roots.js +124 -124
  110. package/src/ui/auto-spawn.js +113 -113
  111. package/src/ui/browser.js +78 -78
  112. package/src/ui/client.js +130 -130
  113. package/src/ui/events.js +65 -65
  114. package/src/ui/lockfile.js +191 -191
  115. package/src/ui/port.js +67 -67
  116. package/src/ui/server.js +547 -547
  117. package/src/ui/wrapper.js +129 -129
@@ -1,261 +1,261 @@
1
- ---
2
- name: ui-anti-padroes-ia
3
- description: Use ao gerar/revisar UI — catalogo de 18 regras que delatam UI gerada por IA. Tells (gradiente roxo, card aninhado, monocultura Inter) + Qualidade (touch <44px, edge flush). Grep 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
1
+ ---
2
+ name: ui-anti-padroes-ia
3
+ description: Use ao gerar/revisar UI — catalogo de 18 regras que delatam UI gerada por IA. Tells (gradiente roxo, card aninhado, monocultura Inter) + Qualidade (touch <44px, edge flush). Grep 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