EN

Spec-DrivenGuide

O framework de governança para desenvolvedores e agentes

Construa com prefixos
$ npx sdg-agents

Execute no terminal, dentro da pasta do seu projeto. O agente lê as regras e passa a segui-las.

Comece pelo prefixo

Comece pelo prefixo

Instrua o agente como se estivesse escrevendo uma mensagem de commit.

Pedido solto

arrume o login

O agente adivinha o escopo e começa a escrever. Você descobre o que ele decidiu revisando tudo depois.

Especificação à mão

## Contrato - Entrada, saída, códigos de erro - Critérios de aceite - Casos extremos + 34 linhas

Funciona bem. Detalhar ajuda, e o agente pode escrever esse detalhe com você.

Prefixo

fix: login aceita senha vazia

O agente escreve a SPEC, espera sua aprovação, e só então planeja, codifica e testa no mesmo ciclo.

A SPEC sai do contexto que o agente já tem do projeto. Leia a sugestão e ajuste até alinhar com o propósito. Se houver risco, detalhe o máximo possível.

As 5 Fases

As 5 Fases

O que o agente executa por você depois de uma única linha com prefixo.

1

1. ESPECIFICAÇÃO

O CONTRATO

Escreva o que vai construir e por quê. Nada de código até chegar a um acordo.

2

2. PLANEJAMENTO

A ESTRATÉGIA

Ordene as tarefas e divida as grandes em subtarefas numeradas que outra pessoa consiga seguir.

3

3. PROGRAMAÇÃO

A EXECUÇÃO

Siga o plano. Escreva o que foi acordado, nada mais.

4

4. TESTES

A VALIDAÇÃO

Verifique se o que foi construído bate com o que foi acordado. Pegue os problemas antes de subir.

5

5. FIM

A ENTREGA

Feche o ciclo: atualize o registro de mudanças, sincronize a lista de tarefas e siga em frente.

Execução do Agente

Execução do Agente

O que seu agente faz, passo a passo, em cada fase.

ESPECIFICAÇÃO

O CONTRATOModo: Planejamento
5 passos

PLANEJAMENTO

A ESTRATÉGIAModo: Planejamento
8 passos

PROGRAMAÇÃO

A EXECUÇÃOModo: Rápido
4 passos

TESTES

A VALIDAÇÃOModo: Rápido
6 passos

FIM

A ENTREGAModo: Planejamento
8 passos
Comandos do Agente

Comandos do Agente

Inicie o fluxo certo com um simples prefixo de texto.

Primeiro contato

land: <seu objetivo aqui>

Defina a visão e o escopo do projeto antes de escrever a primeira linha.

Funcionalidade

feat: <descreva a funcionalidade>

Percorra SPEC → PLAN → CODE → TEST → END para qualquer nova feature.

Correção

fix: <especifique o problema aqui>

Diagnostique a causa raiz, corrija e confirme que nada mais quebrou.

Fim do Ciclo

end: <instrução opcional aqui>

Resuma o que foi feito, atualize o registro de mudanças e faça o commit.

Documentação

docs: <o que documentar>

Escreva ADRs, registros de mudanças e especificações técnicas com o template certo.

Auditoria

audit: <escopo da auditoria>

Verifique se as regras de governança estão aplicadas ao projeto e receba um plano de correção.

Ainda sem agente no editor?Veja os prompts

Memória do Projeto

Memória do Projeto

Os arquivos que seu agente lê antes de cada ciclo.

Contexto Central

Arquitetura & Decisões

Contexto, tecnologias e decisões táticas.

Lições Aprendidas

Experiência Acumulada

O que deu errado antes e a regra que saiu disso.

Lista de Pendências

Próximos Passos

Estado atual, tarefas pendentes e entrega.

Log de Resiliência

Histórico Técnico

Análise de causa raiz (RCA) e histórico de falhas.

Mapa de Impacto

Filtro de Raio de Ação

Arquivos modificados, importações no raio de impacto e testes em risco.

Perguntas Frequentes

Perguntas Frequentes

O que os desenvolvedores perguntam antes do primeiro ciclo.

Preciso escrever uma especificação para usar o Spec-Driven Guide?

Não. Você abre o pedido com um prefixo (feat:, fix:, docs:, audit: ou land:) e o agente escreve a SPEC para você, depois para e espera a sua aprovação antes de planejar ou escrever código. Especificação longa escrita à mão fica reservada para mudanças críticas, onde o rigor extra se paga.

Como instalo o Spec-Driven Guide em um projeto?

Rode npx sdg-agents dentro do projeto. A CLI escreve um roteador AGENTS.md na raiz do repositório mais o conjunto de instruções em .ai/. Qualquer agente que leia AGENTS.md pega a governança a partir dali.

Com quais agentes de IA funciona?

Qualquer agente que leia AGENTS.md na raiz do repositório: Claude Code, Cursor, GitHub Copilot, Codex, Gemini, Windsurf e Roo Code. O Claude Code ainda carrega sozinho um CLAUDE.md que aponta para o mesmo arquivo.

Quais são as cinco fases do ciclo SDG?

SPEC define o quê e o porquê. PLAN transforma isso em uma lista ordenada de tarefas. CODE segue o plano e nada além dele. TEST verifica a entrega contra o acordo. END fecha o ciclo com changelog e proposta de commit. O agente para e pede aprovação explícita na SPEC e no PLAN.

O que o prefixo audit: faz?

Ele roda uma checagem de drift: o agente compara o código com as regras de governança instaladas em .ai/ e devolve um plano de correção com tarefas que você pode executar, em vez de reescrever código silenciosamente.

Construtor de Contexto

Construtor de Contexto

Gere as instruções de partida do seu agente em poucos cliques.

Construtor de Contexto

Etapa 1/4: Arquitetura

Arquitetura

Arquitetura

SDG Icon

Spec-DrivenGuide

v2.1.0
O framework de governança para desenvolvedores e agentes © 2026