𝗗𝗲 𝗩𝟭.𝟬 𝗽𝗮𝗿𝗮 𝗩𝟮.𝟬: 𝗨𝗺𝗮 𝗥𝗲𝗽𝗲𝗻𝘀𝗮𝗱𝗲𝗿𝗮 𝗻𝗼 𝗣𝗶𝗽𝗲𝗹𝗶𝗻𝗲 𝗱𝗲 𝗩𝗶𝗯𝗲 𝗖𝗼𝗱𝗶𝗻𝗴
Recentemente, corrigi um pequeno erro de digitação no meu projeto de código aberto, vibe-coding-universal. Alterei um rótulo de v2.0 (antigo) para v1.0 (antigo).
Essa pequena mudança revelou um grande problema. Nem eu sabia o nome da minha própria versão. Se eu estou confuso, seus usuários também ficarão perdidos.
Minha primeira versão era simples. Ela usava 7 perguntas para ajudar a IA a entender os requisitos. Produzia um único arquivo de guia para ferramentas como Claude Code ou Cursor. Funcionava, mas tinha falhas:
- A IA tinha que adivinhar cores, fontes e espaçamento.
- Design e tarefas ficavam em um único arquivo.
- A IA dependia de sua própria memória em vez de sistemas de design reais.
A Versão 2.0 não é apenas uma atualização. É uma nova forma de trabalhar.
V1.0 vs V2.0:
V1.0:
- 7 rodadas de perguntas de requisitos.
- Sem regras de design.
- Um único arquivo de guia.
- Sem referências externas.
V2.0:
- 7 rodadas de requisitos + 7 rodadas de preferências de design.
- DESIGN_SPEC.md completo com cores, fontes e regras de layout.
- Um pacote Build Spec completo (PRD, Design, Arquitetura, Tarefas).
- Acesso a 71 sistemas de design de marcas como Stripe, Linear e Apple.
- Tokens CSS precisos para a IA usar.
A maioria das pessoas escreve prompts de IA ruins. Elas perguntam: "De qual estilo de design você gosta?". Isso é amplo demais.
A V2.0 usa múltipla escolha em vez disso. Cada rodada faz uma pergunta com 4 a 6 opções.
- Rodada 1: Tipo de projeto (SaaS, Dashboard, ferramenta de IA, etc.).
- Rodada 2: Referência visual (Stripe, Apple, Vercel, etc.).
- Rodada 3: Clima das cores (Frio, Quente, Neutro).
Após 7 rodadas, o sistema extrai tokens de design de 71 sistemas de marcas. Ele gera uma lista de variáveis CSS. Isso fornece instruções exatas para a IA.
O erro de versão aconteceu porque a lacuna entre a V1.0 e a V2.0 era muito grande. Eu via ambas como a versão "atual".
Se o seu projeto passar por uma mudança massiva, use rótulos de versão claros. Os usuários não passarão 5 minutos estudando sua estrutura. Eles te dão 10 segundos.
Antes da sua próxima atualização, pergunte a si mesmo:
Um novo usuário consegue entender esta comparação em 3 segundos?
Se a resposta for não, corrija seu texto antes de corrigir seu código.
Comunidade de aprendizado opcional: https://t.me/GyaanSetuAi