Communitygithub.com

craft-setup

Use quando uma solicitação para projetar ou criar uma página, tela ou elemento começa em um projeto sem DESIGN.md na raiz, quando a pessoa pede para configurar, definir ou iniciar o design, estilo, marca ou diretrizes de um produto, ou executa /craft-setup (/craft:craft-setup no plugin do Claude Code).

O que é craft-setup?

Esta skill estabelece a fundação de design de um produto antes de qualquer tela ser desenhada. Ela guia o agente a entrevistar o usuário — uma pergunta por vez — para extrair informações sobre produto, público, tom de voz, estilo visual, marca, referências e restrições, registrando tudo em um arquivo `DESIGN.md` na raiz do projeto. A skill também gerencia a criação de tokens, tipografia, espaçamento e regras de interação via sub-skills `craft-system` (para projetos sem sistema de design) ou `craft-sync` (para importar um sistema de design existente no código para a ferramenta de design). Projetada para ambientes como Claude Code e Cursor, ela evita suposições não verificadas, exige aprovação explícita do usuário e nunca gera telas durante a configuração — isso é responsabilidade da skill `craft` posteriormente.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/diego3g/craft/tree/HEAD/skills/craft-setup

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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.md na raiz do projeto.
  • "Configurar o design", "definir nosso estilo / marca / diretrizes", /craft-setup (/craft:craft-setup no plugin do Claude Code).

Quando NÃO usar

  • DESIGN.md existe e a tarefa é de design: use craft.
  • Alterar um token ou uma diretriz: use craft-system.

Passos

  1. 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").
  2. 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.
  3. 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.
  4. Escreva DESIGN.md na 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.
  5. Pare e mostre DESIGN.md para a pessoa. Altere até que eles aprovem.
  6. 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-system no 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.

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 craft só 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

RegraPor quê
Uma pergunta por mensagem, com opçõesUma parede de perguntas é folheada e metade respondida
Leia antes de perguntar; nunca pergunte o que os arquivos dizemPerguntar 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 explicitamenteO que evitar restringe o design mais rápido do que o que almejar
Não redesenhe arquivos existentes durante a configuraçãoA configuração registra decisões; alterar o CSS deles é uma tarefa de design que eles ainda não pediram
Nenhuma tela durante a configuraçãoTelas 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

PensamentoRealidade
"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.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Habilidades Relacionadas