Framework Open Source (MIT) · Pipeline de 3 sessões

De um agente fazendo tudo sozinho para 3 sessões que planejam, constroem e conferem.

Instale em qualquer repositório com um comando. Você conversa e aprova na Discovery; o Builder constrói em paralelo e abre o PR; o Reviewer, que só lê, confere as regras e devolve com comentários antes de voltar para você.

$ npx @nathanramorim/forge-sdd@latest init

01 · Visão do Pipeline

Como o trabalho passa de uma sessão para a outra.

Clique em qualquer sessão da esteira abaixo (ou aguarde a transição automática) para ver o que ela recebe, o que produz e qual portão valida a passagem.

01. Discovery
02. Builder
Artefato em trânsito (Handoff) Job na fila (forge dispatch): spec aprovada, critérios e rules aplicáveis
Transição 1 → 2 Fluxo avança somente com contrato cumprido

02 · Emulador Interativo Fiel

Veja como uma feature real nasce, roda em paralelo e passa na auditoria.

Clique nos 5 passos abaixo na ordem em que o trabalho acontece. À esquerda você vê o terminal e o chat; à direita, a sessão ativa e os arquivos gerados em sdd/.

meu-projeto — forge-sdd v5.0.0
Passo 1 de 5
Sessão Ativa Trabalhando

forge init

Estrutura SDD instalada e pronta para iniciar o ciclo.

Arquivos & Fila Atualizados no Repositório

03 · Instalação & Guia Rápido

Simples de instalar. Funciona com os agentes que você já usa.

Compatível com Claude Code, Google Gemini / Antigravity e GitHub Copilot. Código 100% aberto sob licença MIT.

Opção 1 · Instalação Global (Recomendado) npm / npx

Instale uma vez e use o comando curto forge

# 1. Instale globalmente via NPM
npm install -g @nathanramorim/forge-sdd
# 2. Inicialize dentro do seu projeto
forge init
Opção 2 · Uso Direto sem Instalar Zero Config

Rode direto via npx ou atualize projetos existentes

# Inicialização interativa (escolha Claude, Gemini, Copilot)
npx @nathanramorim/forge-sdd@latest init
# Atualizar um projeto existente preservando o histórico
forge update

Principais comandos do dia a dia

Na sessão Discovery você conversa por comandos de barra (/comando); o binário forge abre as sessões e cuida da fila, dos portões e das skills no terminal.

/discovery [ideia] Discovery

Faz o Reuse Check ("O que já existe"), gera a spec e os critérios e espera o seu OK no Portão FLX-01.

/split-features Discovery

Divide o plano em tarefas para o Builder, com as rules de cada uma; tarefas sem conflito rodam em paralelo.

/implementar [feature] Discovery → Builder

Envia o job da feature ao Builder (forge dispatch): ele constrói, abre o PR e o Reviewer confere.

/revisar Reviewer

Confere o resultado: roda os critérios e o Portão A (forge gate) e a revisão somente leitura (Camada B), e devolve o parecer.

forge-sdd queue CLI Go

Gerencia a fila local (enqueue, next, claim, complete, review, list) com detecção de conflito.

forge-sdd gate CLI Go

Executa o Portão Determinístico Camada A (branch, spec vinculada, segredos, tamanho e testes).

forge-sdd skills CLI Go

Propõe, aprova e sincroniza Auto-Skills (DUP-05) entre .agents/, .claude/ e .gemini/.

/status & forge report Qualquer sessão

Mostra o progresso atual, divergências com o Git remoto e relatório de telemetria por sessão.

04 · Governança em 3 Camadas

O antídoto contra o caos do desenvolvimento com IA sem supervisão.

Vazamento de credenciais, código duplicado e IAs que aprovam o próprio erro viraram notícia constante. No Forge-SDD 5.0, quem escreve o código jamais pode aprová-lo: veja ao lado como o Guardião Read-Only age em cada caso.

Bloqueado na Auditoria SEG-01 · P-13

Chave privada detectada no diff da tarefa

O Reviewer opera sem permissão de escrita: ele bloqueia a passagem e devolve a evidência exata para o Builder corrigir.

Permissão de escrita do Reviewer: 0 arquivos

05 · Evolução de Arquitetura

O que muda da geração v4.x para o Forge-SDD 5.0.

Antes (v2.x) · Agente Solitário
  • Um único agente acumulando todas as funções A mesma sessão que escrevia o código fazia a própria revisão, sem isolamento entre execução e auditoria.
  • Constituição monolítica carregada inteira Todas as regras eram lidas do zero a cada comando, consumindo contexto com temas fora do escopo da tarefa.
  • Execução sequencial manual Tarefas independentes esperavam em uma única lista de texto, sem fila determinística nem paralelismo.
Agora (v5.0) · 3 Sessões em Pipeline
  • Quem confere não é quem construiu A Discovery planeja com você e só segue com o seu aval → o Builder constrói em paralelo e abre o PR → o Reviewer confere em modo somente leitura e devolve com comentários, até 3 vezes.
  • Constituição por IDs + Regras sob demanda Princípios fixos ficam enxutos com IDs estáveis; o "como cumprir" é carregado de .agents/rules/sdd-*.md apenas quando a tarefa exige.
  • Motor de Auto-Skills (Regra de Três) Atividades padronizadas que se repetem 3 vezes viram Skills reutilizáveis automaticamente sincronizadas entre os agentes.

06 · Demonstração Oficial em Vídeo

Veja o Forge-SDD 5.0 em ação em 60 segundos.

Assista à demonstração oficial apresentando o portão determinístico Camada A e a revisão somente leitura na prática. O vídeo é anterior ao pipeline de 3 sessões.

Vídeo Oficial 1080p Full HD