@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.
- package/README.md +1 -1
- package/bin/cli.js +2 -2
- package/bin/mcp.js +6 -6
- package/bin/ui.js +74 -74
- package/gates/ai-prompt-stability.md +120 -120
- package/gates/budget-description.md +68 -68
- package/gates/confidence.md +29 -29
- package/gates/dependency-check.md +33 -33
- package/gates/dept-cycle-prevention.md +179 -179
- package/gates/golden-signals-coverage.md +133 -133
- package/gates/legacy-refactor-safety.md +178 -178
- package/gates/multi-tenant-rls-coverage.md +102 -102
- package/gates/no-personal-uuid.md +72 -72
- package/gates/obs-agents-mcp-supabase.md +86 -86
- package/gates/obs-skills-frontmatter.md +76 -76
- package/gates/observability-coverage.md +151 -151
- package/gates/omm-no-regression.md +83 -83
- package/gates/postmortem-template-required.md +127 -127
- package/gates/prr-checklist-coverage.md +128 -128
- package/gates/regression.md +32 -32
- package/gates/release-pipeline-policy.md +132 -132
- package/gates/secrets-scan.md +33 -33
- package/gates/service-role-not-in-user-facing.md +113 -113
- package/gates/skill-must-include.md +71 -71
- package/gates/sync-idempotent.md +62 -62
- package/gates/verify-phase-goal.md +34 -34
- package/kit/agents/designer-ui.md +216 -216
- package/kit/agents/workflow-generator.md +537 -0
- package/kit/commands/adicionar-backlog.md +1 -1
- package/kit/commands/adicionar-fase.md +1 -1
- package/kit/commands/adicionar-tarefa.md +1 -1
- package/kit/commands/auditar-observabilidade.md +103 -103
- package/kit/commands/auditar-toil.md +129 -129
- package/kit/commands/caracterizar-prompt.md +195 -195
- package/kit/commands/criar-workflow.md +158 -0
- package/kit/commands/definir-perfil.md +1 -1
- package/kit/commands/definir-slo.md +108 -108
- package/kit/commands/fio.md +1 -1
- package/kit/commands/golden-signals.md +142 -142
- package/kit/commands/instrumentar-fase.md +200 -200
- package/kit/commands/investigar-producao.md +162 -162
- package/kit/commands/observabilidade.md +118 -118
- package/kit/commands/postmortem.md +179 -179
- package/kit/commands/prr.md +205 -205
- package/kit/commands/publicar-rapido.md +207 -207
- package/kit/commands/risk-budget.md +220 -220
- package/kit/commands/sre.md +230 -230
- package/kit/file-manifest.json +5 -2
- package/kit/framework/references/output-style.md +22 -22
- package/kit/hooks/post-apply-migration.js +199 -199
- package/kit/hooks/sidecar-tool-publisher.js +210 -210
- package/kit/skills/_shared-dados-distribuidos/glossary.md +224 -224
- package/kit/skills/_shared-legacy/glossary.md +389 -389
- package/kit/skills/_shared-multi-tenant/glossary.md +186 -186
- package/kit/skills/_shared-observability/glossary.md +396 -396
- package/kit/skills/_shared-sre/glossary.md +712 -712
- package/kit/skills/_shared-supabase/glossary.md +234 -234
- package/kit/skills/blameless-postmortems/SKILL.md +340 -340
- package/kit/skills/burn-rate-alerting/SKILL.md +258 -258
- package/kit/skills/cascading-failures/SKILL.md +311 -311
- package/kit/skills/core-analysis-loop/SKILL.md +352 -352
- package/kit/skills/distributed-tracing/SKILL.md +362 -362
- package/kit/skills/dynamic-workflow-authoring/SKILL.md +327 -0
- package/kit/skills/eliminating-toil/SKILL.md +243 -243
- package/kit/skills/event-based-slos/SKILL.md +296 -296
- package/kit/skills/four-golden-signals/SKILL.md +314 -314
- package/kit/skills/hermetic-builds/SKILL.md +323 -323
- package/kit/skills/legacy-monster-methods/SKILL.md +444 -444
- package/kit/skills/llm-as-dependency/SKILL.md +436 -436
- package/kit/skills/load-shedding-graceful-degradation/SKILL.md +396 -396
- package/kit/skills/observability-driven-development/SKILL.md +315 -315
- package/kit/skills/observability-maturity-model/SKILL.md +222 -222
- package/kit/skills/opentelemetry-standard/SKILL.md +351 -351
- package/kit/skills/production-readiness-review/SKILL.md +305 -305
- package/kit/skills/release-engineering/SKILL.md +367 -367
- package/kit/skills/retry-strategies/SKILL.md +372 -372
- package/kit/skills/sre-risk-management/SKILL.md +221 -221
- package/kit/skills/structured-events/SKILL.md +265 -265
- package/kit/skills/supabase-cron-queues/SKILL.md +275 -275
- package/kit/skills/supabase-database-functions/SKILL.md +332 -332
- package/kit/skills/supabase-declarative-schema/SKILL.md +183 -183
- package/kit/skills/supabase-pgvector-rag/SKILL.md +253 -253
- package/kit/skills/supabase-postgres-style/SKILL.md +138 -138
- package/kit/skills/supabase-storage/SKILL.md +234 -234
- package/kit/skills/telemetry-pipelines/SKILL.md +259 -259
- package/kit/skills/telemetry-sampling/SKILL.md +256 -256
- package/kit/skills/ui-anti-padroes-ia/SKILL.md +261 -261
- package/kit/skills/ui-contexto-produto/SKILL.md +248 -248
- package/kit/skills/ui-cor-estrategia/SKILL.md +213 -213
- package/kit/skills/ui-critica-auditoria/SKILL.md +260 -260
- package/kit/skills/ui-motion-funcional/SKILL.md +264 -264
- package/kit/skills/ui-ritmo-espacial/SKILL.md +259 -259
- package/kit/skills/ui-tipografia/SKILL.md +211 -211
- package/package.json +1 -1
- package/src/cli/index.js +1114 -1114
- package/src/cli/render.js +194 -194
- package/src/cli/upgrade-check.js +135 -135
- package/src/core/error-redaction.js +76 -76
- package/src/core/failures.js +153 -153
- package/src/core/gate-runner.js +205 -205
- package/src/core/gates.js +82 -82
- package/src/core/logger.js +170 -170
- package/src/core/manifest-verify.js +174 -174
- package/src/core/metrics.js +268 -268
- package/src/core/notify.js +60 -60
- package/src/core/path-safety.js +141 -141
- package/src/core/replays.js +120 -120
- package/src/core/ui.js +185 -185
- package/src/mcp-server/install.js +149 -149
- package/src/mcp-server/roots.js +124 -124
- package/src/ui/auto-spawn.js +113 -113
- package/src/ui/browser.js +78 -78
- package/src/ui/client.js +130 -130
- package/src/ui/events.js +65 -65
- package/src/ui/lockfile.js +191 -191
- package/src/ui/port.js +67 -67
- package/src/ui/server.js +547 -547
- 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
|