Por Que uma Spec, Não Só Vibração
Vibe coding não significa pular o planejamento. Significa planejar rápido e de forma leve, e então direcionar a IA para executar. Uma spec é o volante. Sem ela, a IA chuta sua intenção a cada , e pequenos mal-entendidos se acumulam numa bagunça.
Uma spec te dá três coisas:
- Contexto compartilhado — você pode colar a spec em qualquer sessão de IA e reestabelecer instantaneamente o que está construindo.
- Um limite de escopo — uma linha escrita entre "dentro" e "fora" que impede o crescimento descontrolado de recursos (feature creep).
- Uma lista de tarefas — pedaços construíveis que a IA pode completar um de cada vez.
Uma spec funciona como um funil: pega uma ideia ampla e vaga e a estreita, passo a passo, em pequenos pedaços que a IA consegue de fato construir.
┌─────────────────────────┐
│ IDEA │ fuzzy, one line
└───────────┬─────────────┘
▼
┌───────────────────┐
│ SPEC │ problem · scope · stories
└─────────┬─────────┘
▼
┌───────────────┐
│ TASKS │ small, ordered steps
└───────┬───────┘
▼
┌───────────┐
│ BUILD │ one chunk at a time
└───────────┘
Ela não precisa ser longa. Uma página basta para a maioria dos projetos. Na verdade, uma spec que passa de duas páginas geralmente é um sinal de alerta: você está planejando longe demais ou expandindo o escopo silenciosamente. Na dúvida, corte. As partes que você apaga raramente fazem falta, e as partes que você mantém ficam mais afiadas.