Menu
Ajuda completa do Forge Agent — comandos, skills, agentes.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Executa o milestone inteiro de forma autonoma ate concluir.
Executa exatamente uma unidade de trabalho e para (step mode).
Task autonoma sem milestone — brainstorm, discuss, plan, execute.
Gerencia múltiplas contas Claude e troca entre elas (setup-token). Use ao esgotar a sessão de uma conta.
Qualidade do codebase — lint, nomenclatura. Flags: --fix, --paths.
Configuracoes do Forge — status line, hooks, MCPs.
| 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):
Sistema de agentes Claude Code baseado no workflow GSD-2. Hierarquia: Milestone → Slice → Task (iron rule: task cabe em um context window).
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.
| 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. |
/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ônomatask — cria e executa uma task avulsanew-milestone — planeja um novo milestonesair — fecha o REPL (status e help também disponíveis digitando)Acessíveis via
/forgeREPL 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. |
| 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. |
| 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. |
| 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. |
| 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 | 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. |
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](fallbackclaude-opus-4-7) ·sonnet→claude-sonnet-5·haiku→claude-haiku-4-5-20251001Para mudar:forge-prefs set <fase> <modelo>
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
| 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 |
.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