@nathanramorim/forge-sdd

CLI que scaffolda a estrutura Forge-SDD v1.3.2 em segundos. Suporte total para GitHub Copilot, Claude e Gemini.

🚀 Landing Page: forge-sdd.vercel.app

Uso rápido (npx)

npx @nathanramorim/forge-sdd@latest init

Apresenta um formulário interativo e cria toda a infraestrutura de memória de projeto, especificações, agentes e MCPs.

Requisitos

• Node.js ≥ 18
• O binário Go é baixado automaticamente e cacheado em ~/.cache/forge-sdd/.

Opções CLI

# Modo interativo (padrão)
npx @nathanramorim/forge-sdd@latest init

# Gemini (Google) - não interativo
npx @nathanramorim/forge-sdd@latest init --yes --agent gemini

# Claude (Anthropic)
npx @nathanramorim/forge-sdd@latest init --yes --agent claude

# Preview sem criar arquivos
npx @nathanramorim/forge-sdd@latest init --yes --dry-run

O que é gerado

Uma árvore de aproximadamente 40 arquivos baseada na Metodologia Forge-SDD, organizada para minimizar o consumo de tokens e maximizar a precisão da IA:

• sdd/memory/: Estado ativo e histórico.
• sdd/spec/: Especificação particionada (overview, stack, modules...).
• sdd/features/: Roadmap e tarefas executáveis.
• Agentes: Arquivos de instrução e comandos customizados para o agente escolhido.
• .vscode/mcp.json: Integração com MCP (Context7, Git).

Como interagir com os Agentes

A Metodologia Forge-SDD v1.3.2 oferece 7 comandos universais que funcionam de forma idêntica em todos os agentes suportados.

🛠️ Comandos Universais (Prompts)

| Comando | O que faz | Agente (Ativação) | |---------|-----------|-------------------| | /status | Diagnóstico rápido do progresso e fases. | Copilot, Claude, Gemini | | /proxima-feature | Inicia a próxima tarefa (cria branch, delega). | Copilot, Claude, Gemini | | /nova-feature | Specifier cria nova feature e atualiza índice. | Copilot, Claude, Gemini | | /revisar | Revisor valida código e critério de conclusão. | Copilot, Claude, Gemini | | /doctor | Check-up de integridade, MCPs e budgets. | Copilot, Claude, Gemini | | /archive | Compacta progress.md movendo para o log. | Copilot, Claude, Gemini | | /upgrade-sdd | Migra a estrutura para uma nova versão. | Copilot, Claude, Gemini |

♊ Gemini (Google AI Studio / CLI)

Peça pelo nome do comando ou /comando (ex: "rodar o status"). O Gemini carrega automaticamente suas habilidades de Orquestrador, Builder, etc., localizadas em .gemini/.

🤖 GitHub Copilot (VS Code Chat)

Use comandos slash diretamente no chat (ex: /status). Configuração em .github/chatmodes/ e .github/prompts/.

Links

• GitHub Repository
• Metodologia SDD