Como funciona o SDD
Do modelo em cascata à execução por IA orientada por especificação — a análise técnica completa.
Evolução
Como o desenvolvimento de software evoluiu
Quatro eras do desenvolvimento de software — do rígido modelo em cascata aos agentes de IA orientados por especificação.
Waterfall
Fases sequenciais: requisitos, conceção, implementação, testes e colocação em produção. Cada etapa termina antes de começar a seguinte. As alterações são dispendiosas; os ciclos de feedback medem-se em meses.
Previsível, mas lento. Um pedido de alteração após a fase de conceção podia fazer recomeçar todo o calendário.
Agile
Sprints iterativos, histórias de utilizador, reuniões diárias e retrospetivas. As equipas entregam de forma incremental e adaptam-se às mudanças. Mas a velocidade continua limitada pela dimensão da equipa e pelo custo da coordenação.
Feedback mais rápido, mas crescer exige mais pessoas — e mais pessoas exigem mais coordenação.
AI-Assisted
Preenchimento automático de código, assistentes de IA, geração de código por chat. Cada programador torna-se mais rápido, mas o processo de desenvolvimento em si não muda. A IA ajuda; o trabalho continua a ser feito por pessoas.
Ganhos de produtividade de 20–40 % por programador — mas o processo, os papéis e os estrangulamentos continuam os mesmos.
SDD
A especificação passa a ser o contrato executável. Os agentes de IA implementam, testam, documentam e colocam em produção — sob a orquestração de um engenheiro sénior que controla todo o ciclo de vida através de especificações formais.
Não se trata de programadores mais rápidos, mas de um processo fundamentalmente diferente. Um engenheiro, a especificação em primeiro lugar, a execução a cargo da IA. Conceito central
O que é Specification-Driven Development?
Uma metodologia em que a especificação é a fonte da verdade e os agentes de IA são a força de trabalho.
Specification-Driven Development (SDD) é uma metodologia em que cada funcionalidade, serviço e integração nasce como uma especificação formal, legível por máquina — antes de se escrever qualquer código.
Ao contrário das abordagens tradicionais, em que os programadores interpretam os requisitos e tomam decisões de implementação de improviso, o SDD concentra na especificação, desde o início, todas as decisões de arquitetura e de negócio. A especificação não é documentação — é a fonte de verdade que os agentes de IA executam.
O resultado: entregas previsíveis, qualidade constante e uma velocidade de desenvolvimento que cresce com a profundidade da especificação — e não com a dimensão da equipa.
A especificação é código
Cada funcionalidade começa como uma especificação formal: contratos de API, modelos de dados, regras de negócio e critérios de aceitação. A especificação é suficientemente precisa para que os agentes de IA a implementem sem ambiguidade.
Os agentes fazem o trabalho
Os agentes de IA tratam da implementação, dos testes, da documentação, da configuração de CI/CD e da localização. Cada agente atua dentro de um papel definido e de limites de contexto rigorosos.
O ser humano mantém o controlo
Um engenheiro sénior escreve as especificações, revê todos os resultados, toma as decisões de arquitetura e valida a qualidade. A IA amplia a competência — não substitui o discernimento.
Arquitetura
Três camadas de contexto
Cada agente de IA opera dentro de uma hierarquia de contexto rigorosa, que garante consistência e qualidade.
Contexto do sistema
Regras de arquitetura, restrições da pilha tecnológica, normas de codificação, convenções de nomenclatura e invariantes de todo o projeto. Este contexto é carregado em todas as sessões dos agentes e nunca muda a meio do projeto.
Exemplo: “Java 21, Spring Boot 3.2, PostgreSQL. Todos os serviços usam arquitetura hexagonal. As APIs REST seguem a especificação OpenAPI 3.1. Sem ORM — SQL puro com jOOQ.”
Contexto da funcionalidade
Requisitos, critérios de aceitação, contratos de API, modelos de dados e regras de negócio de uma funcionalidade específica. Este contexto restringe-se à tarefa atual e define o que o agente deve construir.
Exemplo: “Serviço de emissão de certificados: POST /api/v1/certificates. Valida a capacidade do armazém, verifica números de série duplicados e emite o evento de domínio CertificateIssued.”
Contexto de execução
O ficheiro atual, o âmbito da função, os resultados esperados dos testes e as dependências imediatas. É a camada de contexto mais restrita — indica ao agente exatamente onde se encontra e o que deve produzir a seguir.
Exemplo: “Implementar o método CertificateService.issue(). Entrada: IssueCertificateCommand. Saída: CertificateDTO. Deve passar em: CertificateServiceTest, linhas 45–78.”
Ciclo de vida
O ciclo de vida do SDD
Sete etapas da especificação à produção — com validação humana em cada fase crítica.
- 01
Redigir a especificação do sistema
Definir a arquitetura, a pilha tecnológica, as normas de codificação, as convenções de API e as regras de todo o projeto. Isto torna-se o contexto imutável do sistema para todos os agentes.
- 02
Definir os requisitos das funcionalidades
Para cada funcionalidade: contratos de API, modelos de dados, regras de negócio, critérios de aceitação e resultados esperados dos testes. A especificação deve ser suficientemente precisa para permitir uma implementação sem ambiguidade.
- 03
Revisão humana: especificação
O engenheiro revê a especificação quanto à completude, à coerência e à solidez arquitetural. Este é o ponto de controlo mais crítico — os erros nesta etapa propagam-se por todo o sistema.
- 04
Os agentes de IA implementam
Os agentes executam a especificação: escrevem código, criam testes, geram documentação e configuram o CI/CD. Cada agente trabalha dentro do seu papel e dos seus limites de contexto.
- 05
Validação automatizada
Todo o código gerado é compilado, testado e submetido automaticamente a análise estática. A cobertura de testes, a segurança de tipos e as normas de codificação são asseguradas pelos pipelines de CI — não por pessoas.
- 06
Revisão humana: resultado
O engenheiro revê o código gerado quanto à correção, aos casos-limite, à segurança e à prontidão para produção. Nada do que a IA produz entra em produção sem validação humana.
- 07
Colocar em produção
O código aprovado é integrado, os pipelines são executados e o sistema é colocado em produção. Rastreabilidade completa da especificação ao commit e do commit à produção.
A sua especificação, um preço fixo, um sistema em funcionamento.
- 01 NDA assinado Antes de discutirmos qualquer pormenor. A sua ideia fica protegida.
- 02 Conversa inicial · 30 min Apenas com um engenheiro sénior — sem comerciais nem intermediários.
- 03 Orçamento por escrito · 24 h Âmbito fixo, preço fixo ou tempo e materiais — a escolha é sua.
- 04 Início no prazo de 48 horas Se houver sintonia, podemos começar de imediato.