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
- 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. - 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.
- 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.
- 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.
- 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
- Colete capturas de tela de cada referência que eu nomeei. Corte páginas longas em seções.
- 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.
- 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.
- 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 digo | Significa | Você faz |
|---|---|---|
| "C" | Construa C como mostrado | Vá para a Fase 5 |
| "D, mas 1.5px não 3px" | D com exatamente essa mudança | Mude apenas isso, depois Fase 5 |
| "Os botões de A, a barra de busca de C" | Uma mistura | Pegue 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ória | Construa B e mantenha o segundo colocado até eu ter testado B no aplicativo real ou no dispositivo |
| Feedback em uma variante | Itere | Mostre a próxima rodada apenas daquela variante, de volta para a Fase 3 |
| "Não entendo este protótipo" | Pare de prototipar | Construa a coisa real em um PR |
| "nenhuma destas" | Você perdeu minha intenção | Volte 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ção | Comportamento |
|---|---|
/prototype-first | Fluxo 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 compare | Um protótipo com um alternador AGORA / PROPOSTO contra a IU atual |