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