Pular para o conteúdo
LabS Atlas
Agentic AI
Entrar

Spec-Driven Development

Ir para notas que citam esta
atualizado há 25 diasEntre para perguntar ao Labinho sobre esta notaO Labinho é o assistente que responde com as notas e as sessões do LabS e mostra de onde tirou cada resposta.

Spec-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.

A spec não substitui a revisão de segurança

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.