Communitygithub.com

prototype-first

Mostre opções de design como protótipos e obtenha uma escolha antes de construir qualquer coisa. Use para uma nova tela, um novo fluxo, um redesign, um site ou página de destino, qualquer solicitação 'mostre-me opções' ou 'você pode prototipar' e qualquer questão de UX com mais de uma resposta razoável. Também cobre como construir a partir de um protótipo escolhido.

O que é prototype-first?

Esta skill estabelece um fluxo de trabalho focado em design orientado a protótipos, garantindo que a validação visual ocorra antes de qualquer codificação. Ela é particularmente útil para desenvolvedores e agentes de IA que trabalham em novas telas, fluxos complexos, redesigns ou qualquer problema de UX com múltiplas soluções viáveis. A skill opera em plataformas como Claude Code e Cursor, onde o agente deve apresentar de 2 a 4 variantes de design realistas (A, B, C, D) usando dados reais, tokens de design atuais e interações clicáveis, depois parar e aguardar a seleção do usuário. Regras duras proíbem abrir PRs para protótipos, construir direções não aprovadas ou misturar rótulos de protótipo no código final. O ciclo começa com a coleta de referências visuais e questionamento do briefing, seguido pela criação de variantes em contexto, envio do round e interpretação do feedback do usuário (como escolha de variante, mix ou iteração). Por fim, a construção deriva exatamente do protótipo aprovado, sem desvios ou rótulos de protótipo. A skill garante que cada decisão de design seja testada visualmente, reduzindo retrabalho e alinhando a equipe em torno de uma visão clara.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/0xa3k5/skills/tree/main/skills/prototype-first

Perguntar na sua IA favorita

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

Documentação

Protótipo primeiro

Sou designer. Julgo o trabalho olhando e clicando nele, não lendo um plano. Um protótipo custa minutos. Construir a coisa errada custa uma pilha de PRs e um dia de revisão.

Esta skill faz uma coisa: obtém uma escolha de design minha antes de qualquer código ser escrito. Ela nunca abre um PR para um protótipo, nunca envia um protótipo como produto e nunca constrói uma direção que eu não escolhi.

Regras rígidas

  1. Nunca abra um PR para um protótipo, nem mesmo um rascunho. PRs são para código destinado a ir para main. Um PR de protótipo adiciona ruído de revisão e CI para algo que será descartado.
  2. Pare após cada rodada. Envie as variantes no formato abaixo e aguarde minha resposta. Não comece a construir "a escolha mais provável" enquanto eu olho. Se eu escolher outra coisa, esse trabalho é desperdício e tenho que revisá-lo de qualquer forma.
  3. O protótipo escolhido é a especificação. A construção deve se parecer com ele. Feedback posterior altera apenas o que eu nomeei. Eu comparo a construção com a imagem que escolhi, então qualquer desvio é lido como um erro, não como uma melhoria.
  4. Rótulos de protótipo permanecem em arquivos de protótipo. "B2", "direção A" e apelidos de variante nunca aparecem em código, tokens, commits, PRs ou issues. Eles significaram algo apenas durante a escolha. Na base de código, são ruído que alguém terá que decodificar depois.
  5. Veja referências como imagens. Quando eu nomear sites ou aplicativos de referência, veja capturas de tela deles. Uma busca apenas por texto perde toda qualidade visual que tornou a referência boa, e o resultado parece genérico.

Deveria ser um protótipo?

A mudança tem uma resposta óbvia (um valor de espaçamento, um rótulo, um token de cor)?
├── Sim → Construa e diga o que mudou. Pular o protótipo é um bom resultado.
└── Não
    ├── Nova tela, novo fluxo, redesign ou 2+ respostas razoáveis?
    │   └── Sim → Protótipo.
    │       ├── Precisa de dados reais, navegação real ou comportamento nativo?
    │       │   └── Sim → Branch descartável `proto/<tópico>` a partir do main
    │       └── Não → Arquivo HTML autônomo, compartilhado no chat ou thread da issue
    └── Incerto → Pergunte em uma linha: "prototipo isso ou apenas construo?"

Nunca esconda um protótipo dentro do produto atrás de uma rota /lab ou uma flag de desenvolvimento.

Fluxo de trabalho

Fase 1: Referências e perguntas

  1. Colete capturas de tela de cada referência que eu nomeei. Corte páginas longas em seções.
  2. Escreva observações concretas para cada uma: o tipo, o tratamento do título, como o produto é mostrado, como o layout é estruturado e o momento que se destaca. Diga por que cada uma funciona.
  3. Questione a solicitação. Se o que pedi é UX fraca, diga e diga por quê. Pense do lado do usuário final, não da correção literal que descrevi.
  4. Faça algumas perguntas curtas e numeradas sobre o que você não pode inferir, como tipo, densidade, tom e o que manter da versão atual.

Concluído quando: cada referência tem observações escritas, e eu respondi suas perguntas ou você não tinha nenhuma.

Fase 2: Construir as variantes

  • Mostre 2 a 4 variantes, rotuladas A, B, C e D. Uma variante não te ensina nada sobre meu gosto. Mais de quatro é ruído.
  • Pelo menos uma variante é sua própria ideia melhor se você contestou na Fase 1. Coloque-a ao lado da que pedi.
  • Crie o mock em contexto. Mostre a janela ou seção inteira, não um componente flutuando em uma página em branco.
  • Use o design real. Use os tokens, tipo e componentes atuais do aplicativo. Mostre claro e escuro se o aplicativo tiver ambos.
  • Use dados realistas. Nomes, números e comprimentos de texto com aparência real. Nunca lorem ipsum, e nunca dados de pessoas ou lugares reais.
  • Torne os fluxos clicáveis. Para qualquer coisa com etapas ou estados, construa um arquivo HTML com um alternador de cenário, um alternador claro/escuro, interações funcionais e uma nota em palavras simples sobre o que cada estado significa.
  • Combine o nível de acabamento com a pergunta. Para uma direção visual, parece o produto final, porque a aparência é o que estou julgando. Para um fluxo, parece o aplicativo e funciona, e o acabamento de borda pode esperar, porque estou julgando se me perco.

Concluído quando: cada variante é simulada em contexto com tokens reais e dados realistas, e cada fluxo é clicável.

Fase 3: Envie a rodada e pare

Envie a rodada no formato descrito em "Formato de saída obrigatório". Depois, pare.

Concluído quando: a rodada é enviada. Nada mais acontece até eu responder.

Fase 4: Leia minha escolha

Eu digoSignificaVocê faz
"C"Construa C como mostradoVá para a Fase 5
"D, mas 1.5px não 3px"D com exatamente essa mudançaMude apenas isso, depois Fase 5
"Os botões de A, a barra de busca de C"Uma misturaPegue cada parte nomeada da variante de onde a nomeei. A parte que eu disser que mais gosto domina. Não desvie para a variante que foi mais fácil de construir.
"Gosto de B, mas quero testá-lo"Uma escolha provisóriaConstrua B e mantenha o segundo colocado até eu ter testado B no aplicativo real ou no dispositivo
Feedback em uma varianteItereMostre a próxima rodada apenas daquela variante, de volta para a Fase 3
"Não entendo este protótipo"Pare de prototiparConstrua a coisa real em um PR
"nenhuma destas"Você perdeu minha intençãoVolte para as referências e minhas palavras. Não faça uma quarta versão da mesma ideia.

Pergunte por que quando eu não disser. Se eu escolher sem dar um motivo, faça uma pergunta curta: "o que fez B vencer?" Grave minha resposta com a decisão. Uma escolha sem sua razão não ensina nada ao próximo agente sobre meu gosto.

Concluído quando: você sabe qual variante, ou qual mistura de partes, construir e por quê.

Fase 5: Construir a partir da escolha

  • Informe quem construir com o link do protótipo e os valores exatos: cores, tamanhos, espaçamento e tipo. Ninguém reconstrói de memória.
  • Descreva o design pelo que ele é ("tabela densa, pills de status, trilho esquerdo"), nunca pelo seu rótulo.
  • Aplique feedback geral posterior ("muito ocupado", "sem hierarquia") apenas onde apontei. Não é permissão para remover coisas que gostei no protótipo. Antes de descartar ou alterar um elemento do protótipo, nomeie-o e pergunte.

Concluído quando: a construção corresponde à escolha, e nenhum rótulo de protótipo aparece no código, commits, PR ou issues.

Formato de saída obrigatório

Toda rodada se parece com isto:

**Onde ver:** <link ou anexo>, ou `git checkout proto/<tópico> && <comando para executar>`

| Variante | Apostando em | Trade-off |
| --- | --- | --- |
| A | <uma linha: a ideia que esta variante testa> | <o que ela sacrifica> |
| B | ... | ... |

**No que questionei:** <uma ou duas linhas, ou "nada">

Responda com uma letra, uma mistura (`x de A, y de C`), ou `nenhuma`.

Mantenha-se nisso. O protótipo faz a explicação.

Variantes de invocação

InvocaçãoComportamento
/prototype-firstFluxo de trabalho completo da Fase 1, para após a Fase 3
/prototype-first <variante>Itere em uma variante da última rodada, de volta para a Fase 3
/prototype-first compareUm protótipo com um alternador AGORA / PROPOSTO contra a IU atual

Habilidades Relacionadas