Forge-SDD v3.0.0-beta MIT License

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ê.

Testar no Emulador Real Como Instalar & Usar GitHub (MIT) Pacote NPM
$ 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) Contexto do projeto (progress.md) + abertura de Discovery & Reuse Check
Passo 1 → 2 · Início da Esteira O Líder nunca implementa código direto: delega à estação certa
Estação 01 Trabalhando

O Líder (Orquestrador)

Maestro da operação · Seu ponto de contato

RECEBE (ENTRADA) Pedido do Humano / Laudo Camada B
ENTREGA (SAÍDA) Demanda estruturada → Estação 02

Recebendo sua demanda e acionando o PM + Arquiteto para concepção…

Recebe sua demanda, coordena os especialistas em sequência ou paralelo e consolida o Painel Executivo.

Interação viva
Estação 02 Aguarda você

Produto & Arquiteto

Concepção da Spec · Reuse Check (DUP-01)

RECEBE (ENTRADA) Demanda do Líder + Código atual
ENTREGA (SAÍDA) discovery.md + criteria.md

Portão FLX-01 aberto: aguardando seu "De Acordo" na especificação.

Mapeia o que já existe para evitar duplicação e estrutura os critérios de aceite antes de qualquer código.

Interação viva
Estação 03 Planejando

O Planejador

Fatiamento P/M/G · Regras sob demanda

RECEBE (ENTRADA) Spec aprovada (FLX-01)
ENTREGA (SAÍDA) plan.md + sdd/.queue/queue.json

Mapeando IDs da Constituição (ARQ, SEG, TST) por subtarefa…

Quebra a Spec em tarefas atômicas e anexa apenas os módulos de regras necessários para cada Builder.

Interação viva
Estação 04 Trabalhando

Fila de Builders

Execução isolada · Paralelismo seguro

RECEBE (ENTRADA) Tarefa da fila + Rules do escopo
ENTREGA (SAÍDA) Código + Testes + Portão A (PASS)

Construindo em paralelo tarefas sem conflito de arquivos…

Consome a fila determinística: tarefas sem conflito rodam em paralelo; dependências aguardam liberação.

Interação viva
Estação 05 Auditando

Analista de Governança

Auditoria Somente Leitura · Camada B

RECEBE (ENTRADA) Diff + Spec + IDs Constituição
ENTREGA (SAÍDA) Laudo JSON → Líder (ou ↺ Builder)

Inspecionando conformidade com ARQ-*, SEG-*, DUP-* e TST-*…

Proibido de editar código. Audita arquitetura, segurança e reuso antes de devolver o laudo ao Líder.

Interação viva

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
$ forge init . --agent claude,gemini --name checkout-api
→ Gerando papéis canônicos em .agents/roles/{lider,pm-architect,planner,builder,governance}.md
→ Distribuindo regras em .agents/rules/sdd-{arquitetura,seguranca,reuso-e-duplicacao,codigo-e-testes,fluxo-e-portao}.md
→ Criando sdd/memory/constitution.md (IDs estáveis: ARQ-*, SEG-*, DUP-*, COD-*, TST-*, FLX-*, GOV-*)
✓ Estrutura Forge-SDD v3.0.0-beta criada com sucesso!
Passo 1 de 5
Bootstrap CLI Go Estrutura Pronta

01. O Líder (Orquestrador)

Instalei os papéis das 5 estações (.agents/roles/), as regras modulares (.agents/rules/) e a Constitution por IDs.

Arquivos & Fila Atualizados no Repositório

.agents/roles/ (5 estações) criado
.agents/rules/sdd-*.md criado
sdd/memory/constitution.md criado
sdd/memory/progress.md 240 bytes ≤ 1 KB

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 (05 ↺ 04).

$ forge-sdd gate --mode bloqueio
- [P-13 FALHOU] Credencial exposta detectada em internal/auth/client.go:42 - Veredito Camada B: "bloqueado" (violação SEG-01 — retorna à Estação 04)
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.

06 · Demonstração Oficial em Vídeo

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

Assista à demonstração oficial apresentando a esteira autônoma em 5 estações, o portão determinístico Camada A e a governança somente-leitura na prática.

Vídeo Oficial 1080p Full HD