Spec-Driven Development (SDD)
IA é tão boa quanto a estrutura que você dá a ela. O AI-SDD transforma prompts vagos em especificações precisas — e especificações precisas em software funcionando.
A evolução das metodologias de desenvolvimento
"Software era caro, lento e limitado pela capacidade humana."
As metodologias surgiram da necessidade de gerenciar a capacidade humana e a complexidade em times coordenados.
Otimizado para previsibilidade e documentação completa
Otimizado para adaptação iterativa e entrega contínua
Especificação como fonte da verdade compartilhada
A IA mudou o gargalo do desenvolvimento
O humano era o gargalo. Cada linha de código custava tempo e dinheiro. Metodologias nasceram para gerenciar esse custo, minimizar retrabalho e coordenar times.
A velocidade de execução deixou de ser a restrição principal. O novo gargalo é a clareza da intenção — a qualidade da especificação que guia a IA.
"Apenas Prompting" Não Escala.
Código Que Resolve o Problema Errado
Sem requisitos estruturados, a IA gera o que ela acha que você quer — não o que você realmente precisa. O resultado parece certo até chegar em produção.
Sem Rastro da Intenção
A saída bruta da IA não tem trilha de auditoria. Seis meses depois, ninguém sabe por que uma decisão foi tomada — apenas que o código existe. As revisões viram adivinhação.
Ciclos de Retrabalho Que Cancelam os Ganhos
Aceleração de IA sem direção apenas faz você se perder mais rápido. Times gastam o tempo que a IA economizou consertando implementações desalinhadas.
O custo de corrigir cresce exponencialmente
"30 minutos de revisão de spec = 30 dias de retrabalho evitados."
Defeitos detectados na fase de requisitos custam em média 100x menos do que os mesmos defeitos encontrados em produção. Uma especificação clara é o melhor investimento que um time pode fazer.
Fonte: IBM System Science Institute
Spec-Driven Development: a especificação como fonte da verdade
No SDD, o humano expressa a intenção — a IA gera a especificação. Tudo o mais deriva dela: código, testes e documentação. A spec é o contrato único entre humanos e IA — clara, versionada e auditável.
Manter a especificação como a única fonte da verdade, da qual o código, os testes e a documentação são derivados — nunca o contrário.
Is SDD the True Parent of TDD, BDD, and DDD?
TDD, BDD e DDD assumem que a especificação já existe. O SDD é a camada upstream que nenhum deles possui. — ai-sdd.com
Três papéis, um contrato único
O Diretor
Expressa a intenção e o contexto de negócio em alto nível. A IA estrutura o restante — o humano revisa e aprova cada fase antes de avançar.
O Contrato
Especificação formal em texto versionado. Requisitos no formato EARS, design de arquitetura e tarefas atomizadas — sem ambiguidade.
O Executor
Transforma a intenção humana em especificação estruturada. Gera código, testes e documentação alinhados ao contrato — sem ambiguidade.
"A IA gera o contrato e o executa. O humano define a intenção."
EARS (Easy Approach to Requirements Syntax): eliminando a ambiguidade que custa caro
"O sistema deve enviar uma notificação quando o usuário fizer alguma coisa importante."
5 desenvolvedores = 5 implementações diferentes
- "alguma coisa importante" — o que exatamente?
- Qual tipo de notificação? Email? Push? SMS?
- Para quem é enviada? Quando expira?
WHEN um pedido de compra for confirmado pelo sistema de pagamento AND o valor total for superior a R$500,00 THEN o sistema SHALL enviar um e-mail de confirmação ao usuário cadastrado WITHIN 60 segundos da confirmação do pagamento. WHERE o usuário tiver desabilitado notificações por e-mail, o sistema SHALL enviar uma notificação push no aplicativo móvel.
- Gatilho preciso e mensurável
- Comportamento obrigatório (SHALL)
- Casos alternativos cobertos
Steering: governança automática para todo o time
product.md Visão do produto, personas, objetivos de negócio e restrições. A IA nunca perde o contexto estratégico.
tech.md Stack tecnológica, padrões de código, convenções de nomenclatura e regras de segurança.
structure.md Organização de pastas, módulos, limites de responsabilidade e padrões arquiteturais.
Cada conversa com a IA recomeça do zero. Inconsistências entre features, padrões divergentes, retrabalho constante.
A IA carrega o contexto do projeto em cada sessão. Decisões consistentes, menos revisões, código coerente.
O Steering transforma a IA de um assistente genérico em um membro especialista do seu time, com conhecimento profundo do produto, da stack e das convenções do projeto.
Do Direcionamento ao Deploy
Seis fases, cada uma com um checkpoint humano antes da IA prosseguir.
Direcionamento
Estabelece o contexto do projeto: visão do produto, stack tecnológica, estrutura do código. Agentes de IA leem isso em cada tarefa — antes de gerar qualquer coisa.
Início da Spec
Descreva a funcionalidade em linguagem natural. A IA gera um shell de spec estruturado — você o refina até o ponto de partida dos requisitos.
Requisitos
A IA expande a descrição em requisitos formais no formato EARS. O humano revisa e aprova antes de prosseguir — este é o gate mais crítico.
Design
A IA gera um design técnico alinhado aos requisitos. O arquiteto valida as decisões de arquitetura. Nenhum código até o design ser aprovado.
Tarefas
O design é dividido em tarefas atômicas e testáveis — cada uma rastreável a um requisito específico. O roadmap de implementação.
Implementação
A IA implementa tarefa por tarefa. O desenvolvedor revisa cada uma. A validação executa contra os requisitos originais — não apenas "os testes passam".
Descreve a intenção em alto nível — o problema a resolver e o contexto de negócio.
Gera requisitos estruturados no formato EARS — precisos, sem ambiguidade, verificáveis.
Revisa e aprova os requisitos — ou solicita ajustes antes de avançar.
Propõe o design de arquitetura — componentes, integrações e decisões técnicas documentadas.
Revisa e aprova o design — garantindo alinhamento com as restrições e a visão do produto.
Atomiza as tarefas de implementação — cada uma rastreável a um requisito, com critérios de aceitação definidos.
Revisa e aprova o backlog — valida escopo, prioridade e granularidade antes da execução.
Executa as tarefas da spec, gerando testes automaticamente com TDD — código aderente ao design e aos requisitos aprovados.
Revisa a implementação e aprova o merge — validação final antes da entrega.
Realiza o merge e deployment — intenção original entregue em produção, rastreável do início ao fim.
"Software falha porque humanos e IA se entendem mal.
— Tese Central do Spec-Driven Development
IA executa contratos — não adivinha intenções."
O SDD não é sobre dar mais autonomia para a IA. É sobre criar o contrato preciso que permite que a IA use toda a sua capacidade de execução a serviço da intenção humana.
