Framework Open Source (MIT) · Orquestração em 5 Estações

De um agente fazendo tudo sozinho para 5 especialistas em esteira.

Instale em qualquer repositório com um comando. Cada estação recebe um artefato validado, executa sua especialidade em fila ou em paralelo e passa pela auditoria de Governança Read-Only antes de voltar para você.

$ npx @nathanramorim/forge-sdd@latest init

01 · Visão Processual entre os Agentes

Como o bastão passa de uma estação para a outra.

Clique em qualquer etapa da esteira processual abaixo (ou aguarde a transição automática) para inspecionar o que cada agente recebe, o que ele produz e qual portão valida a passagem.

01. O Líder
02. PM & Arquiteto
Artefato em trânsito (Handoff) Demanda contextualizada + acionamento do Reuse Check (DUP-01)
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 comandos abaixo na ordem em que você usa no dia a dia. À esquerda você vê o terminal/chat real; à direita, a estação ativa e os arquivos gerados em sdd/.

meu-projeto — forge-sdd v3.0.0-beta
Passo 1 de 5
Estação Ativa Trabalhando

01. O Líder (Orquestrador)

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 para v3.0 preservando seu histórico
forge update

Principais comandos do dia a dia

Você conversa com o time por comandos de barra (/comando) no chat da IDE, enquanto o binário forge-sdd garante fila, portões e skills no terminal.

/discovery [ideia] Estação 02

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

/split-features Estação 03

Quebra o plano técnico em subtarefas P/M/G, vincula as rules aplicáveis e alimenta a fila determinística.

/proxima-feature Estação 04

Aciona os Builders para consumirem os próximos itens da fila (em paralelo quando sem conflito).

/revisar Estação 05 → 01

Roda o Portão A (forge-sdd gate), a auditoria Read-Only (Camada B) e entrega o Painel do Líder.

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 Estação 01

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 3.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 Analista de Governança 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 Auditor: 0 arquivos

05 · Evolução de Arquitetura

O que muda da geração v2.x para o Forge-SDD 3.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 (v3.0-beta) · 5 Estações em Esteira
  • Handoff explícito entre 5 especialistas Líder recebe a demanda → PM/Arquiteto especifica com seu aval → Planejador fatia → Builders constroem em paralelo → Governança audita em modo Read-Only.
  • 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.