forge-help

name	forge-help
description	Ajuda completa do Forge Agent — comandos, skills, agentes.
allowed-tools	Read

Read ~/.claude/forge-agent-prefs.md and .gsd/claude-agent-prefs.md (if exists) to get current model config. Then display the following help, filling in actual values where marked.

---

Exiba exatamente este conteúdo para o usuário (substituindo os valores dinâmicos indicados):

---

Forge Agent — Ajuda (v1.0)

Sistema de agentes Claude Code baseado no workflow GSD-2. Hierarquia: Milestone → Slice → Task (iron rule: task cabe em um context window).

---

Arquitetura v1.0

A partir da v1.0, o Forge Agent usa 3 comandos slash + skills:

Tipo	O que é	Como invocar
Comando slash	/forge, /forge-init, /forge-update	Digitar /forge no Claude Code
Skill	Tudo o mais (forge-auto, forge-status, etc.)	Via /forge REPL ou digitando o nome diretamente

Ponto de entrada recomendado: /forge — REPL com menu interativo que acessa todas as funcionalidades.

---

Inicialização

Comando	O que faz
/forge-init	Detecta projeto existente ou cria estrutura nova. Gera CLAUDE.md + .gsd/ + prefs. Execute uma vez por projeto.
/forge-init <descrição>	Mesmo que acima, passando a descrição do projeto diretamente.

---

Entry point — /forge

/forge

REPL interativo com menu. Acesso a todas as funcionalidades sem memorizar comandos.

Menu disponível:

• auto — executa o milestone inteiro de forma autônoma
• task — cria e executa uma task avulsa
• new-milestone — planeja um novo milestone
• sair — fecha o REPL (status e help também disponíveis digitando)

---

Skills de execução

Acessíveis via /forge REPL ou digitando o nome diretamente no Claude Code.

Skill	O que faz
forge-auto	Auto mode — executa o milestone inteiro de forma autônoma. Para em blocker ou milestone completo.
forge-next	Step mode — executa exatamente uma unidade e para. Ideal para revisar antes de continuar.
forge-task <descrição>	Task autônoma — task standalone sem milestone. Fluxo: brainstorm → discuss → research → plan → execute.
forge-task --skip-brainstorm <descrição>	Pula brainstorm — vai direto para discuss → plan → execute.
forge-task --resume TASK-001	Retoma uma task de onde parou.

---

Skills de planejamento

Skill	O que faz
forge-new-milestone <descrição>	Cria um milestone do zero. Fluxo: brainstorm → scope → discuss → plan → ROADMAP.
forge-discuss <M###|S##>	Abre discuss para um milestone ou slice. Registra decisões no CONTEXT file.
forge-add-slice <M###> <descrição>	Adiciona um slice a um milestone existente.
forge-add-task <S##> <descrição>	Planeja uma task dentro de um slice.

---

Skills de visibilidade

Skill	O que faz
forge-status	Dashboard — milestone ativo, progresso de slices e tasks, próxima ação.
forge-explain <alvo>	Explica qualquer artefato sem modificar nada. Alvos: M001, S03, T02, decisions, state, all.
forge-memories [show|stats|clean|export|inject]	Gerencia memórias auto-aprendidas do projeto.
forge-ask [resume|close|list]	Modo conversa — discute ideias, captura decisões, salva sessão. Pode invocar probe: / brainstorm: dentro da conversa.
forge-probe <ideia> [--quick]	Experimentos descartáveis — valida viabilidade antes de commit. Decompõe em probes Given/When/Then, escreve código mínimo em .gsd/probes/NNN-name/, retorna verdict (VALIDATED/INVALIDATED/PARTIAL) com evidência observável.
forge-skills [<nome>|--all]	Lista skills disponíveis e detalhes de uso.
forge-help	Esta tela.

---

Skills de manutenção

Skill	O que faz
forge-doctor [--fix] [--dry-run]	Diagnóstico do projeto — valida STATE, checkboxes, arquivos. --fix corrige automaticamente.
forge-codebase [--fix] [--dry-run] [--paths a,b]	Qualidade do codebase — estrutura, lint, nomenclatura. --fix corrige o que for seguro.
forge-sweep [--apply] [--force] [--scope task|milestone]	Limpa know-how (AUTO-MEMORY, DECISIONS, milestones, sessões) por política de equipe. Sem args = dry-run; --apply executa.

---

Skills de configuração

Skill	O que faz
forge-config [statusline on|off]	Dashboard de configurações — status line, hooks, MCPs.
forge-mcps [add|remove <nome>]	Gerencia MCPs. Catálogo: fetch, context7, github, postgres, redis, puppeteer, sqlite.
forge-prefs [models|set|skip-research|skip-discuss|git|ids|reset]	Gerencia preferências, modelos por fase e formato de IDs.

---

Comando de atualização

Comando	O que faz
/forge-update	Atualiza o Forge Agent (git pull + reinstala agents/commands/skills). Preserva preferências.
/forge-update <caminho>	Mesmo que acima, especificando o caminho do repositório manualmente.

---

Agentes especializados (invocados automaticamente)

Read ~/.claude/forge-agent-prefs.md to get the current model for each agent, then display:

Agente	Modelo atual	Usado em
forge-discusser	[Phase → Agent Routing: discuss-milestone model]	discuss-milestone, discuss-slice
forge-researcher	[Phase → Agent Routing: research-milestone model]	research-milestone, research-slice
forge-planner	[Phase → Agent Routing: plan-milestone model]	plan-milestone, plan-slice
forge-executor	[Phase → Agent Routing: execute-task model]	execute-task
forge-completer	[Phase → Agent Routing: complete-slice model]	complete-slice, complete-milestone
forge-memory	[Phase → Agent Routing: memory-extract model]	extração de memórias pós-unidade

Modelos: opus → claude-opus-4-8[1m] (fallback claude-opus-4-7) · sonnet → claude-sonnet-5 · haiku → claude-haiku-4-5-20251001 Para mudar: forge-prefs set <fase> <modelo>

---

Fluxo típico de trabalho

1. cd /seu/projeto
2. /forge-init                     ← uma vez por projeto
3. /forge                          ← entry point de tudo
   → new-milestone <descrição>     ← criar milestone
   → auto                          ← executar de forma autônoma
      ou
   → task <descrição>              ← task pontual sem milestone
4. /forge-update                   ← atualizar o Forge Agent

---

Arquivos de configuração

Arquivo	Escopo	O que controla
~/.claude/forge-agent-prefs.md	Global	Modelos por fase, skip rules, git
~/.claude/settings.json	Global	Status line, hooks, MCPs globais
.claude/settings.json	Projeto	Bypass permissions, MCPs de projeto
.gsd/claude-agent-prefs.md	Projeto	Overrides do projeto (sobrescreve global)
CLAUDE.md	Projeto	Carregado automaticamente em toda sessão
.gsd/AUTO-MEMORY.md	Projeto	Memórias auto-aprendidas acumuladas

---

Estrutura .gsd/ gerada durante execução

.gsd/
  STATE.md                    ← estado atual (milestone, slice, task, fase)
  DECISIONS.md                ← registro global de decisões (append-only)
  LEDGER.md                   ← resumo compacto de milestones concluídos
  PROJECT.md                  ← descrição do projeto e stack
  AUTO-MEMORY.md              ← memórias auto-aprendidas (max 50)
  CHECKER-MEMORY.md           ← padrões recorrentes de plan-check/verification (anti-recidivismo)
  CODING-STANDARDS.md         ← padrões detectados + Asset Map
  forge/
    events.jsonl              ← event log do orquestrador
    auto-mode.json            ← estado do auto-mode
  probes/                     ← experimentos descartáveis (forge-probe)
    MANIFEST.md               ← índice de probes
    NNN-descriptive-name/     ← probe isolado com README + código
  milestones/
    M001/
      M001-ROADMAP.md         ← slices com checkboxes + boundary map
      M001-CONTEXT.md         ← decisões do discuss
      M001-RESEARCH.md        ← pesquisa de codebase
      M001-SUMMARY.md         ← resumo acumulado
      slices/
        S01/
          S01-PLAN.md         ← tasks com checkboxes
          S01-CONTEXT.md      ← decisões do slice
          S01-SUMMARY.md      ← resumo ao completar
          S01-UAT.md          ← script de teste manual
          tasks/
            T01-PLAN.md       ← steps + must-haves
            T01-SUMMARY.md    ← o que foi feito + evidência
  tasks/                      ← tasks autônomas (forge-task)
    TASK-001/
      TASK-001-BRIEF.md
      TASK-001-PLAN.md
      TASK-001-SUMMARY.md