Manifesto

Um framework de governança para quem trabalha com agentes de IA. Você define a direção, o agente executa, e toda tarefa segue o mesmo fluxo.

Pessoas orquestram · Agentes executam

Contexto

"Aprovar uma spec curta custa menos que revisar código que você não pediu."

O Spec-Driven Guide (SDG) é um framework de governança AI-native. Ele dá a toda tarefa o mesmo fluxo de trabalho, então o agente parte de um acordo que você aprovou em vez de um palpite.

Código que ninguém reconhece

Adotar IA rápido, sem base técnica, aumenta a dívida técnica e cognitiva. Sem padrões combinados, o agente escreve código que compila e que ninguém do time reconhece.

O que o framework padroniza

Toda tarefa passa pelo ciclo de cinco fases: SPEC → PLAN → CODE → TEST → END. O agente para para você aprovar no SPEC, de novo no PLAN, e mais uma vez antes do commit. Você sabe o que ele vai fazer antes dele fazer.

Fundamentos

Bom software vem de poucos hábitos, aplicados em todo ciclo.

O valor da palavra

Cada escolha, do comentário ao nome da função, carrega uma intenção. Nomear as coisas pelo que elas fazem é o que torna um sistema legível.

ClarezaIntencionalidade

Hábitos saudáveis

Rigor nos nomes e código defensivo vêm da prática, não de talento. Consistência é aplicar as mesmas regras no ciclo seguinte.

ConsistênciaAprendizado

Reflexão antes da construção

Decidir a ordem do trabalho protege o sistema enquanto ele cresce. Um plano escrito em dez minutos evita o retrabalho de uma mudança feita no lugar errado.

Spec-drivenPlanejamento

Parceria

Você define a intenção. O agente cuida da execução.

Desenvolvedor (define a direção)

Define o que construir, por quê e quando está bom. Conhecimento do domínio, prioridades e julgamento final ficam com você.

Agente (escreve o código)

Propõe soluções, gera código e aplica os padrões do projeto. Você revisa o que ele produz.

Manual de engenharia

Princípios que acompanham você em cada novo projeto.

A segurança pertence ao alicerce

Proteções e controle de acesso entram no primeiro rascunho. Colocar depois significa mexer em todas as camadas de novo.

O código é uma conversa com o time

Escrevemos para quem for manter o sistema depois. Muitas vezes, essa pessoa é você.

A resiliência vem do projeto

Sistemas confiáveis tratam a falha como caso previsto, não como exceção.

A IA amplifica os seus padrões

O agente repete o padrão que encontra no projeto, inclusive os que você deixou soltos.

Excelência por padrão

Open Source · Gratuito para sempre

A maioria dos projetos que envelheceram bem começou com uma decisão: levar os fundamentos a sério.