Configuração de design
Visão geral
Antes da primeira tela, alinhe o que é o produto, para quem ele é, como deve parecer e o que nunca deve parecer. Escreva isso em DESIGN.md, o resumo que toda decisão de design lê primeiro. Pergunte, não invente: uma marca criada pelo agente é um palpite que a pessoa terá que desfazer. Leia o que existe, entreviste a pessoa uma pergunta de cada vez, escreva o resumo, pare para aprovação e então construa as fundações.
Quando usar
- Uma tarefa de design e nenhum
DESIGN.mdna raiz do projeto. - "Configurar o design", "definir nosso estilo / marca / diretrizes",
/craft-setup(/craft:craft-setupno plugin do Claude Code).
Quando NÃO usar
DESIGN.mdexiste e a tarefa é de design: usecraft.- Alterar um token ou uma diretriz: use
craft-system.
Passos
- Leia primeiro. README, docs, CSS ou tokens existentes, o arquivo de design, pastas de marca, qualquer rascunho antigo de
DESIGN.md. Anote o que eles já respondem. Se o código já possui um sistema de design (um pacote de UI, arquivos de token, uma biblioteca de componentes), diga com contagens e escreva "Fonte do sistema de design:<caminho>" na seção de Marca do resumo. No passo 6, ofereça importá-lo para a ferramenta de design em vez de criar fundações; as perguntas de marca que ele responde são puladas. Dois pacotes de UI → pergunte qual é a fonte antes de pular qualquer pergunta de marca. Nunca pergunte algo que esses arquivos já respondem. Confirme em uma linha ("Seu README diz pt-BR apenas e membros acima de 60, então projetarei para texto de 18px e toques de 48px"). - Entreviste, uma pergunta por mensagem. Siga a entrevista em sua ordem: produto, público e voz, humor, marca, referências, restrições.
- Ofereça de 3 a 5 opções mais "algo diferente" sempre que possível.
- Pule qualquer pergunta já respondida.
- Pare quando as respostas forem suficientes para projetar a primeira tela. Seis boas respostas vencem quinze.
- Referências são obrigatórias. Peça de 2 a 5 produtos, sites ou imagens que eles gostem. Para cada um, pergunte o que aproveitar e o que evitar. Se for um link ou imagem que você possa abrir, olhe e diga o que vê antes de perguntar.
- Escreva
DESIGN.mdna raiz do projeto a partir do modelo, com todas as oito seções: Produto, Público e voz, Humor, Marca, Referências, Restrições, Registro de decisões, Perguntas em aberto.- Use as palavras deles sempre que possível.
- Qualquer coisa que você inferiu e eles não confirmaram vai para Perguntas em aberto, não para o resumo como fato.
- Pare e mostre
DESIGN.mdpara a pessoa. Altere até que eles aprovem. - Fundações.
- Sistema de design já no código: ofereça a importação. Em caso afirmativo, SUB-SKILL OBRIGATÓRIA:
craft-sync(importar). Ela mostra um inventário e pergunta quais componentes desenhar. Em caso negativo, registre " — Importação para recusada" no Registro de decisões. Ofereça mesmo após "pular": trata-se da ferramenta de design, não do resumo. - Nenhum sistema no código: SUB-SKILL OBRIGATÓRIA:
craft-systemno modo criar para as fundações (tokens, tipografia, espaçamento, regras de interação). Ela tem sua própria parada para aprovação. - Tokens e estilos existentes são o ponto de partida: estenda-os, não os renomeie ou mova sem perguntar.
- Sistema de design já no código: ofereça a importação. Em caso afirmativo, SUB-SKILL OBRIGATÓRIA:
Se a pessoa disser "pular" ou "apenas projete"
Não continue perguntando. Escreva um DESIGN.md mínimo a partir do que você leu e do que eles disseram:
- cada lacuna se torna uma Pergunta em aberto;
- cada suposição é marcada como "(assumido)".
Diga em uma linha quais suposições são mais importantes. "Pular" dispensa a entrevista e a parada para aprovação do resumo, nunca o passo 6:
- sistema de design no código → ainda faça a única pergunta de importação ("Importar para agora? Mostrarei o que existe e você escolhe os componentes"), depois continue;
- ainda sem tokens → o passo de fundações e sua parada ainda são executados, porque
craftsó pode desenhar com peças do sistema.
Depois, continue com a tarefa que eles pediram.
Antes de começar
- Se nenhum adaptador em
references/adapters/corresponder à sua ferramenta, faça os mesmos verbos em sua ferramenta e diga quais você mapeou manualmente. Sem ferramenta de design, construa em HTML (html.md). Se você só tiver uma imagem, diga que os valores lidos dela são estimativas. DESIGN.mdé um arquivo Markdown simples no repositório em toda ferramenta. Apenas o quadro de referências opcional vive na ferramenta de design.
Regras
| Regra | Por quê |
|---|---|
| Uma pergunta por mensagem, com opções | Uma parede de perguntas é folheada e metade respondida |
| Leia antes de perguntar; nunca pergunte o que os arquivos dizem | Perguntar o que está no README mostra que você não olhou |
| Nenhuma marca inventada: cores, fontes e humor vêm deles ou são marcados como "(assumido)" | Uma marca inventada é um palpite que eles terão que desfazer tela por tela |
| Referências sempre vêm com aproveitar/evitar | "Gosto do Stripe" é inútil; "aproveitar o espaçamento calmo, evitar os gradientes" é uma regra |
| "Nunca gostei" é perguntado explicitamente | O que evitar restringe o design mais rápido do que o que almejar |
| Não redesenhe arquivos existentes durante a configuração | A configuração registra decisões; alterar o CSS deles é uma tarefa de design que eles ainda não pediram |
| Nenhuma tela durante a configuração | Telas vêm do craft, após o resumo e fundações serem aprovados |
Pronto quando
DESIGN.md estiver aprovado com suas oito seções, e as fundações estiverem resolvidas: criadas e aprovadas via craft-system, ou (com um sistema no código) importadas via craft-sync ou a importação recusada e registrada. Após um "pular": DESIGN.md está escrito com suas suposições marcadas, as fundações existem (aprovadas ou já no projeto), e a tarefa original continuou.
Erros comuns
| Pensamento | Realidade |
|---|---|
| "Vou escolher uma paleta legal e fontes, eles podem mudar" | Eles não podem mudar o que não sabiam que foi decidido. Pergunte, ou marque como "(assumido)". |
| "Enquanto estou aqui, vou fazer mockups das telas principais" | Esse é o trabalho do craft, após a aprovação. A configuração termina no resumo e fundações. |
| "Deixe-me fazer todas as seis perguntas de uma vez para economizar tempo" | Uma por mensagem, com opções. É mais rápido para eles responderem. |
| "Os tokens deles estão bagunçados, vou reestruturá-los" | Estenda-os. Reestruturar é uma mudança separada e aprovada. |
| "Nenhuma referência dada, vou pular essa seção" | Peça por elas. Se eles não tiverem nenhuma, ofereça três que se encaixam no humor e pergunte o que aproveitar e evitar de cada. |