open source · MIT license

Spec-Driven Development
para agentes de IA.

Um framework de referência para desenvolver com agentes de IA sem perder controle: escreva a spec, gere o prompt, deixe o agente implementar com TDD, e valide tudo no CI.

Explorar o repositório → Como funciona
O método

Da spec ao merge, em 5 passos.

A especificação escrita é a fonte da verdade — não o prompt improvisado. Cada etapa alimenta a próxima, e o CI garante que nada quebra antes do merge.

01
spec.md
→
02
prompt gerado
→
03
agente de IA
→
04
código + TDD
→
05
CI + Trivy
Por que

Menos retrabalho, ciclo mais curto.

🎯

Menos ida e volta

Critérios de aceite testáveis eliminam a ambiguidade que gera revisões inteiras depois do código pronto.

🚫

Sem escopo inventado

A seção "Não-escopo" da spec impede que o agente adicione autenticação, paginação e afins que ninguém pediu.

✅

Revisão objetiva

Compare os critérios de aceite (AC1, AC2...) com os testes que os cobrem. Auditoria em minutos, não em horas.

~60%
redução no ciclo de dev reportada com SDD em produção
29
testes cobrindo o exemplo de referência (TDD)
0
vulnerabilidades CRITICAL/HIGH no scan Trivy do CI
Exemplo incluído

Uma API real, não um "hello world".

O repositório inclui uma API de gestão de tarefas em TypeScript, com máquina de estados, validações e testes — implementada seguindo exatamente o fluxo acima.

 terminal 
# clonar e rodar os testes (TDD)
git clone https://github.com/mariospdias/sdd-starter-kit
cd sdd-starter-kit && npm install
npm test

# subir a API localmente
npm run dev  → http://localhost:3000

# ou via Docker
docker compose up --build

Use no seu próximo projeto.

Copie o template de spec, gere o prompt e leve esse fluxo para o seu time — ou para o seu próprio código.

Ver template de spec Ler documentação