Spec-Driven Development
Ir para notas que citam estaSpec-Driven Development é a abordagem em que specs estruturadas, escritas e revisadas antes do código, guiam o agente de IA, em vez de um único prompt com todo o contexto do sistema.
A abordagem nasce de um problema prático do desenvolvimento assistido por IA: pedir ao modelo que construa um sistema inteiro de uma vez obriga-o a carregar um contexto gigantesco, e ele se perde sem saber o que fazer primeiro. Um teste feito assim consumiu milhares de tokens, levou de quatro a cinco horas e entregou um resultado inutilizável. O SDD é visto como a evolução natural do Vibe Coding e como uma das peças do Harness Engineering, a estrutura mais ampla que mantém o modelo nos trilhos.
A palavra central é especificar. A spec tira do modelo a responsabilidade de planejar: o time decide antes o que será feito, e o agente recebe uma tarefa já definida e só o contexto necessário para cumpri-la. Isso reduz a aleatoriedade do resultado, sem eliminá-la. O conceito bebe de metodologias mais antigas, como DDD e BDD, e usa cenários de alto nível e cenários técnicos, com entradas e saídas esperadas, para orientar os testes. Ganhou popularidade por volta de setembro de 2025, com raízes na iniciativa Kiro, da Amazon, e não é exclusivo de nenhuma ferramenta.
A spec como artefato vivo do repositório
Diferente de uma conversa de chat, que não fica registrada, a spec é um conjunto de arquivos em markdown (contexto, plano, tarefas) versionado em Git junto com o código. Markdown é escolhido porque é o formato que os modelos consomem melhor. Como as specs se acumulam ao longo do tempo, funcionam de forma parecida com migrations de banco: lendo a sequência delas, dá para entender como o sistema evoluiu sem ler todo o código. Durante a implementação, o agente volta a consultar a spec a cada passo para conferir se o que fez bate com o especificado, e modelos mais capazes se autocorrigem a partir dela.
O ciclo de especificar, revisar, quebrar, implementar e arquivar
O fluxo se repete por funcionalidade: descrever o problema e a solução em alto nível, revisar essa proposta com olho humano, traduzi-la em arquitetura e tecnologias, quebrá-la numa lista ordenada de tarefas, implementar e verificar. Quando o resultado está de bom tamanho, a spec é arquivada e o time parte para a próxima. A ordem importa: se uma spec depende de outra que ainda não foi implementada e testada, os erros se acumulam e viram bola de neve. Spec Kit separa essas etapas em comandos distintos; OpenSpec junta especificação, plano e tarefas numa única proposta.
Projeto-base como ponto de partida
Um projeto-base já configurado poupa o time de montar a estrutura do zero. Um exemplo combina o framework de specs, o Claude Code com Subagentes especialistas por área (como um de back-end), o HTML das telas prototipadas no Google Stitch e arquivos de stack e convenção. Os subagentes são escritos em inglês porque o modelo traduziria internamente o português antes de trabalhar, um custo pequeno, mas evitável. O design entra só como HTML, sem a captura de tela, para economizar tokens, ao preço de um pouco de precisão.
Ganhos, limites e custo de especificar
Com specs, um back-end e um front-end funcionais, ainda não completos, saem em cerca de uma hora e meia a duas horas, com custo-benefício melhor do que prompts soltos. Isso torna o SDD bom para provas de conceito. Ele rende melhor em sistemas pequenos e médios e ainda não se mostrou indicado para sistemas muito grandes. Escrever spec também custa: para uma mudança pequena num projeto existente, um fluxo completo é um canhão para matar uma formiga, e ferramentas mais enxutas se encaixam melhor. Uma divisão comum é usar um modelo mais forte para gerar as specs e um mais barato para implementar.
Quando quase todo o sistema sai da IA, Guardrails e compliance ficam fracos. A segurança precisa de tempo dedicado e de mão humana, e comandos executados pelo agente em modo de permissão total devem ser acompanhados de perto.