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