Série: O Novo Paradigma do Desenvolvimento de Software • Artigo 01
Quando o prompt solto já não é suficiente
Se você usa IA para programar, conhece a cena: dá um prompt, a IA cospe o código, você ajusta no feeling, repete. Funciona. Até o projeto crescer.
Aí começa o problema.
A IA esquece o que foi decidido. A arquitetura se perde. Cada nova sessão vira uma loteria — às vezes funciona, às vezes quebra tudo o que estava rodando bem. É como trabalhar com alguém que acorda toda manhã sem a memória do dia anterior.
Isso tem nome. Chamam de Vibe Coding. E tem limite.
O momento exato em que o Vibe Coding quebra
Existe um ponto de ruptura bem claro. Enquanto o projeto cabe na cabeça, tudo funciona. Quando ele passa a exigir coerência entre partes que foram feitas em sessões diferentes, o castelo começa a balançar.
Você pede uma feature nova e a IA refatora algo que já estava funcionando. Pede um ajuste e ela introduz um padrão que contradiz o que tinha sido decidido duas semanas atrás. O código até roda — mas virou uma colcha de retalhos.
O problema não é a IA — é o que você dá pra ela
A questão não está na capacidade dos modelos. É que estamos dando prompts soltos quando deveríamos estar entregando especificações completas. A IA responde ao que recebe. Se recebe ambiguidade, devolve inconsistência.
Spec Driven Development: a evolução natural
O SDD não foi inventado por uma pessoa. Foi uma convergência. Times diferentes, em empresas diferentes, bateram nas mesmas pedras e chegaram nas mesmas conclusões.
O conceito é simples: inverter o fluxo.
Em vez de prompt → código, o caminho passa a ser: Especificação → Plano de Arquitetura → Tarefas → Código
A especificação vira o artefato principal. O código é um produto derivado dela.
Quem está adotando
Quando GitHub, Amazon e OpenAI chegam nas mesmas conclusões mais ou menos ao mesmo tempo, não é coincidência: o processo funciona.
- GitHub lançou o Spec Kit — mais de 60.000 estrelas
- Amazon AWS criou o Kiro, uma IDE inteira focada em SDD
- OpenAI construiu um produto de 1 milhão de linhas sem código manual
A Constitution: regras inegociáveis
Uma das práticas mais poderosas do SDD é definir, antes de qualquer código, os princípios não negociáveis do projeto. Testes obrigatórios, stack definida, padrões de modularidade, requisitos de segurança.
Isso se materializa em um documento chamado Constitution — um arquivo markdown que a IA lê antes de tomar qualquer decisão. Não é sugestão, é regra.
Documentação deixou de ser burocracia
Sabe aquela documentação que todo dev odeia escrever? IAs generativas adoram escrever texto. É a natureza delas. A documentação deixou de ser obrigação penosa e virou combustível pra IA trabalhar melhor.
Por onde começar
- Escreve a Constitution antes de pedir qualquer código
- Transforma cada feature em uma spec antes de executar
- Decompõe em tasks pequenas e objetivas
- Trata a spec como um documento vivo
- Acostuma-se a revisar output com olhar crítico
