O que craft faz?
Visão Geral
A porta de entrada para criar qualquer coisa visual. Ele transforma "projete a página de preços" em um design finalizado e revisado. Funciona a partir do brief do projeto, cobre todos os estados, oferece opções apenas quando a direção está em aberto, usa apenas as peças do sistema de design e verifica seu próprio trabalho antes de exibi-lo. Ele chama as outras habilidades de design em pontos fixos; não as substitui.
Quando usar
- "Projetar / criar / simular / redesenhar a <página, tela, fluxo, elemento>",
/craft(/craft:craftno plugin do Claude Code). - Várias páginas de uma vez ("projete a integração: boas-vindas, cadastro, verificação").
Quando NÃO usar
- Uma pequena alteração que a pessoa descreveu exatamente (um valor, um rótulo, um tamanho): faça diretamente.
- Apenas uma revisão ("o que há de errado nisso?"):
craft-critique. Apenas opções:craft-explore.
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 nenhuma ferramenta de design, construa em HTML (html.md). Se tudo o que você tem é uma imagem, diga que os valores lidos dela são estimativas.
Paradas são reais
Uma parada significa: termine sua vez com a pergunta e aguarde. Você sempre pode fazer isso, mesmo em uma sessão one-shot ou headless, onde sua mensagem final é a pergunta. Nunca decida uma parada pela pessoa porque a sessão "não pode esperar" ou "para economizar uma viagem de ida e volta". Decidir por conta própria transforma uma resposta de cinco segundos em horas de retrabalho.
Etapas
- Contexto.
- Leia
DESIGN.mdna raiz do projeto. Se estiver faltando, ou não tiver seção de Produto (um registro apenas de sincronização) → SUB-HABILIDADE OBRIGATÓRIA:craft-setup, depois retorne aqui. - Leia o sistema de design (tokens, componentes, guia) e as telas relacionadas a esta.
- Quando o brief e o código discordarem (o brief diz teal, os tokens dizem azul): siga o código, mencione em uma linha, adicione o conflito em
DESIGN.md› Perguntas em aberto e ofereça-se para atualizar o que estiver errado. Nunca substitua tokens dentro do CSS de uma página. - Quando a guia da ferramenta de design e o código diferirem e existir um
design-sync.json, não considere a guia desatualizada. Classifique com ela: código alterado → ofereça-se para atualizar a guia antes de desenhar; guia alterada → é a alteração da pessoa aguardando exportação, então desenhe com ela e mencione a exportação pendente.
- Leia
- Escopo em palavras. Liste cada página ou elemento a ser criado, cada um com sua função e sua próxima ação única.
- Palavras ambíguas recebem uma interpretação declarada claramente ("página de preços = a lista de preços da padaria, não planos de assinatura").
- Pare e confirme a lista quando houver mais de um item ou a solicitação for vaga. Um item claro: prossiga.
- Para cada item, em ordem:
- SUB-HABILIDADE OBRIGATÓRIA:
craft-states. Sua lista de estados escrita e sua parada vêm primeiro. - Direção em aberto? Apenas quando a pessoa pediu ideias, ou quando dois layouts estruturalmente diferentes são plausíveis e nem o brief nem o sistema escolhem entre eles → SUB-HABILIDADE OBRIGATÓRIA:
craft-exploreantes de desenhar os estados. Para várias páginas, pergunte na parada de escopo qual página (se houver) receberá opções; nunca execute uma rodada de opções por página por padrão. Os estados são então desenhados na direção escolhida. Uma tela que segue um padrão existente vai direto para o desenho. - Desenhe o estado principal, depois os outros estados, usando apenas as peças e tokens do sistema. Algo novo (um componente, uma cor, um tamanho que a escala não possui) → SUB-HABILIDADE OBRIGATÓRIA:
craft-system(modo adicionar) antes de usá-lo. Um componente que existe no código mas não está desenhado na ferramenta ("apenas no código" no índice) → SUB-HABILIDADE OBRIGATÓRIA:craft-sync(importação de um componente), desenhando apenas esse componente primeiro. Se a pessoa recusou a importação (vejaDESIGN.md), pergunte uma vez antes de importar; se ainda disser não, construa a partir dos valores do código no próprio board e anote. Nunca desenhe um similar, e nunca codifique um novo valor em uma página. - SUB-HABILIDADE OBRIGATÓRIA:
craft-critiqueno modo auto-verificação em cada board: renderize, corrija o que encontrar dentro do escopo desta tarefa e renderize novamente.
- SUB-HABILIDADE OBRIGATÓRIA:
- Finalização.
- Mostre o resultado com o resumo abaixo.
- Anexe as decisões em
DESIGN.md› Registro de decisões (data, decisão, motivo). - Mova qualquer pergunta que foi respondida para fora de Perguntas em aberto.
Resumo de finalização (a forma da sua mensagem final)
Feito: <páginas/elementos> — <onde: arquivos ou boards>
Decisões: <cada uma, uma linha com seu motivo> (também em DESIGN.md › Registro de decisões)
Alterações no sistema: <peças ou tokens adicionados/alterados> — afeta: <telas>
Corrigido na auto-verificação: <o que o craft-critique alterou antes de você ver>
Perguntas em aberto: <o que a pessoa ainda precisa decidir>
Regras
| Regra | Por quê |
|---|---|
DESIGN.md primeiro, sempre | Sem o brief, cada tela inventa seu próprio estilo |
| Escopo confirmado antes do trabalho quando houver mais de um item | Três páginas construídas com uma leitura errada são três páginas desperdiçadas |
Lista de estados antes de desenhar (via craft-states) | O caminho feliz é um estado entre muitos |
| Opções apenas quando a direção está em aberto | Opções em um padrão resolvido desperdiçam a atenção da pessoa |
Apenas peças e tokens do sistema; novos passam por craft-system | Valores codificados em páginas são onde a divergência começa |
| O código vence um brief desatualizado; anote, não substitua | Os tokens são o que é enviado; o brief é atualizado por decisão, não silenciosamente |
| Auto-verificação antes de mostrar | A pessoa deve revisar o design, não pegar erros |
Decisões vão para DESIGN.md | A próxima sessão de design começa a partir delas, não da memória |
Concluído quando
Cada item no escopo confirmado tem seus estados desenhados e auto-verificados, qualquer alteração no sistema passou por craft-system, o resumo de finalização foi fornecido e o Registro de decisões de DESIGN.md foi atualizado.
Erros comuns
| Pensamento | Realidade |
|---|---|
| "Três páginas são claras o suficiente, vou construí-las" | Confirme a lista primeiro. Custa uma mensagem. |
| "Vou fazer botões de 52px aqui; o token diz 44, mas esse público precisa de maior" | Isso é uma decisão de sistema. Proponha via craft-system, depois use em todo lugar. |
| "O brief diz teal, então vou substituir o azul no CSS desta página" | O código vence. Sinalize o conflito e pergunte; nunca corrija tokens localmente. |
| "Vou mostrar, eles me dirão o que está errado" | Execute craft-critique em modo auto-verificação primeiro e diga o que foi corrigido. |
| "As decisões estão na minha mensagem, é suficiente" | Mensagens desaparecem. Anexe-as a DESIGN.md. |
| "Esta sessão não pode esperar por respostas, então vou tomar as decisões eu mesmo e listá-las" | Terminar sua vez com a pergunta é parar. Faça isso; não construa nada além da primeira parada em aberto. |
| "Para economizar uma viagem de ida e volta, vou colocar as duas paradas em uma mensagem" | Tudo bem, se você então parar. Pergunte ambas, não construa nada, aguarde. |