Desenvolvimento Autônomo
Orientado por Especificações
Como estruturar a colaboração entre humanos e IA para construir software em uma nova escala de eficiência.
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.
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."
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 100× 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
Da intenção a produção
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.
EARS: 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.
"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.
Dúvidas?
Obrigado pela sua atenção!
