O que do-design faz?
Os caminhos são relativos à pasta desta skill; P é a raiz do projeto. Os scripts são
stdlib Python 3.8+. Execute o script antes de raciocinar sobre qualquer coisa que ele meça,
cite sua saída e nunca rederive ou estime o que ele relata.
Modelo
- O
DESIGN.mddo projeto (o documento) é vinculante e prevalece sobre esta skill. Em caso de conflito, o documento vence; diga isso. - Toda regra tem sua razão. Uma regra sem razão é excluída na primeira vez que for inconveniente.
- Evidência antes dos padrões. Um briefing resumido ("faça algo novo" + um logotipo) é motivo para pesquisar, não para recorrer à aparência usual ou inventar fatos. Sem fonte, sem afirmação: marque a lacuna ou pergunte.
- Carregue preguiçosamente. Apenas os arquivos que a tabela de comandos nomeia. Camadas extras "para completude" são uma falha de método.
- Convenção é o padrão, não a falha. O modo decide o quão longe se desviar.
Modos: declare uma linha no início de cada comando
| Modo | O visitante está | Impulso |
|---|---|---|
| Persuadir | decidindo e agindo | forte: um template é uma falha |
| Operar | completando uma tarefa | contenção: a convenção é um recurso |
| Ler | entendendo algo | médio: o conforto da leitura vence |
| Experiencia | dentro do trabalho em si | forte: o artefato lidera |
Escolha pela superfície, não pelo produto: uma página de destino de uma ferramenta de desenvolvedor é Persuadir, sua tela de configurações é Operar.
Comandos: carregue um arquivo de comando, mais o que suas linhas nomeiam
| Comando | Quando usar | Também carregar | Risco |
|---|---|---|---|
do-design-review | "isso corresponde ao documento?" Mais barato, execute na maioria das vezes | o DESIGN.md do projeto | - |
do-audit | "quão bom é isso?" Pontuação + descobertas classificadas | references/critique-rubric.md, references/slop-catalog.md, camadas 00-05 que o escopo toca | - |
do-design-new | "construa X": convencional, competente, dentro do documento | layers/00, as 1-3 camadas que a tarefa toca; layers/06 quando o briefing é resumido ou voltado ao cliente | baixo |
do-design-renew | "refaça esta aparência": novo mundo, mesma verdade do produto | layers/00, layers/06 | médio |
do-crazy | "algo que ninguém neste setor faria" | layers/00, layers/06 | alto, por design |
Camadas: 00-craft-floor (todo modo) · 01-color · 02-typography · 03-space-layout ·
04-motion-states · 05-voice · 06-research. Escrevendo um documento: templates/DESIGN.md,
examples/01-two-papers.md, references/interview.md.
Scripts (todos aceitam --json)
| Execute | Retorna |
|---|---|
scripts/check-design.py --root P | desvio do bloco de tokens do documento. Saída 0 limpo, 1 desvio, 2 sem documento/tokens. --init rascunha tokens a partir do código |
scripts/audit.py scan P | indicações de fonte (IDs como no catálogo de falhas), lacunas de a11y e superfície do navegador, inventário de valor |
scripts/audit.py copy P | indicações de prosa e microcópia, ritmo de frase, marcadores de lacuna não preenchidos |
scripts/audit.py contrast FG BG / --paper P/DESIGN.md | taxas WCAG |
scripts/audit.py score H L S C T U D | pontuação ponderada, faixa, lista de trabalho |
scripts/render-audit.py URL-ou-arquivo [--shots DIR] [--inject-css ARQUIVO] | a página renderizada em 1280/768/390: sobreposição, rolagem lateral, clipping, contraste pintado, alvos de toque, visibilidade de foco. --inject-css mede uma correção CSS contra a página implantada antes de implantar. Precisa de Chrome/Chromium |
| `scripts/research.py suggest | profile |
bash scripts/install-guardrails.sh P | DESIGN.md a partir do template, o bloco AGENTS.md/CLAUDE.md, o verificador |
Capturas de tela custam muito mais contexto do que a saída do script: tire-as apenas para o que precisa de olhos (hierarquia, distinção, composição), apenas na viewport, 390 primeiro. Scripts também podem estar errados: antes de relatar um P0 que pareça improvável, confirme uma vez (uma captura de tela direcionada ou a geometria do elemento) e corrija o script se for um falso positivo.
Definições compartilhadas
Teste de troca. Substitua o nome do produto pelo de um concorrente. Se nada quebrar, a página não diz nada sobre este produto: não escolhido, não feio. Corrija na cópia, no visual e em um detalhe de assinatura, nunca adicionando decoração.
Direção, cinco linhas. Escrito antes de construir, mostrado, depois aguarde um sim (se disserem "apenas faça", declare a suposição em uma linha e vá):
Produto: o que faz, para quem, uma frase simples
Caráter: 2-3 palavras concretas (nunca limpo, moderno, elegante, minimalista, premium)
Mundo: o lugar ou material a que pertence; define tom neutro, destaque, imagens
Momentos: 1-2 lugares onde a tela fica rica
Assinatura: um detalhe que só este produto tem, usado consistentemente
Marcador de lacuna. [número necessário], [fonte necessária], [foto necessária] onde um fato ou
recurso está faltando. audit.py copy lista os que ainda estão abertos; nenhum pode ser enviado.
Pontuação: todo comando de avaliação termina com ela
| # | Campo | Pergunta | P |
|---|---|---|---|
| 1 | Hierarquia | A coisa mais importante pode ser nomeada em 2 segundos? | 3 |
| 2 | Legibilidade | Contraste, tamanho, medida, cópia real em toda largura | 3 |
| 3 | Sistema | Uma paleta, uma escala, uma lógica de raio, uma linguagem de movimento | 2 |
| 4 | Ofício | Alinhamento, ritmo de espaçamento, estados, superfícies do navegador | 2 |
| 5 | Verdade do conteúdo | Dados reais, cópia específica, sem alegações inventadas | 3 |
| 6 | Usabilidade | Tarefa completa; affordances óbvios; erros recuperáveis | 3 |
| 7 | Distinção | Passa no teste de troca? | 2 |
Pontue cada um de 0 a 4 (4 = genuinamente excelente, não "ok") e compute com audit.py score.
Faixas: 85+ Forte, envie e corrija apenas P0 · 70-84 Sólido, envie após os P1s nomeados ·
50-69 Fraco, uma revisão real primeiro · <50 Falho, a direção está errada: reconstrua (do-design-renew).
Pontue a renderização, não o código-fonte. Um campo que você não pôde verificar é u: pontua 0 e
lê-se não verificado, nunca uma estimativa. Distinção recebe 4 apenas se você puder nomear o que a torna
deste produto. Os três piores campos são a lista de trabalho, uma ação cada.
Severidade: P0 bloqueia o envio (quebrado, ilegível, proibição grave), relate todos · P1 danifica a confiança, top 5 · P2 ofício, top 5 · P3 polimento, liste apenas.
Formato da descoberta: [Pn] localização - o que está errado - correção; descobertas de script mantêm seu ID.
Sem documento
Diga "Sem DESIGN.md: o guardrail não tem nada para aplicar." Ofereça-se para escrevê-lo (template +
entrevista), ou uma adaptação retroativa a partir do código (check-design.py --init + entrevista §Retrofit): v1.0 é
o que é enviado, valores antigos vão para legacy: (contados, não falhados), lacunas vão para a lista de delta do documento.
Arquivos e demonstrações ficam fora de toda varredura via skip: no bloco de tokens (ou --skip a,b),
por pasta ou arquivo. Pesquise por imports antes de pular: pastas de arquivo geralmente contêm partes ativas.
Nunca invente um documento para que o verificador passe.
Inegociáveis
- Nunca quebre código funcional. Props, estado, roteamento, manipuladores e a11y sobrevivem; a cópia mantém seu significado.
- O briefing vence. Uma marca, fonte ou cor declarada supera o gosto, mesmo em uma lista de rejeitos. Escreva no documento (
allow:no bloco de tokens desliga uma regra de verificador ou ID de auditoria intencionalmente). - Nunca invente fatos, recursos ou fontes. Corte uma alegação vaga; nunca a substitua por uma específica inventada. Use um marcador de lacuna.
- Mantenha a voz do autor. Corte hábitos de máquina, mantenha as peculiaridades da pessoa.
- Densidade, não presença. Aja em agrupamentos (3+ indicações P0/P1 distintas), nunca em um gradiente ou um travessão. Um resultado limpo é válido; nunca fabrique descobertas.
- Corrija, nunca acuse. Nunca diga "isso parece gerado por IA"; nomeie o que não foi escolhido e o que fazer em seu lugar.
- Somente leitura, a menos que solicitado para revisões e auditorias.