forge-prefs - SKILL.md Agent Skill

name: forge-prefs description: "Preferencias do agente GSD — modelos, git, skip rules." disable-model-invocation: true allowed-tools: Read, Write, Edit

Input

$ARGUMENTS

Mapa de aliases → model IDs

Quando o usuário usar um alias, converta para o model ID completo:

Alias	Model ID completo
`opus`	`claude-opus-4-8[1m]` (fallback `claude-opus-4-7`)
`sonnet`	`claude-sonnet-4-6`
`haiku`	`claude-haiku-4-5-20251001`

O usuário pode passar tanto o alias quanto o model ID completo — ambos são aceitos.

Fallback: Se claude-opus-4-8[1m] não estiver disponível na conta, o instalador detecta e faz downgrade para claude-opus-4-7. Ao editar agentes Opus manualmente, aceite ambos claude-opus-4-8[1m] e claude-opus-4-7 como válidos.

Operações

Sem argumento ou "show"

Read ~/.claude/forge-agent-prefs.md. Display:

Forge Agent — Configuração atual

MODELOS DISPONÍVEIS
  opus   → claude-opus-4-8[1m]           (análise profunda, planejamento — fallback: 4-6)
  sonnet → claude-sonnet-4-6         (execução, tarefas padrão)
  haiku  → claude-haiku-4-5-20251001 (tarefas leves, memórias)

ROTEAMENTO POR FASE
  discuss    → forge-discusser   [claude-opus-4-8[1m]]
  research   → forge-researcher  [claude-opus-4-8[1m]]
  plan       → forge-planner     [claude-opus-4-8[1m]]
  execute    → forge-executor    [claude-sonnet-4-6]
  complete   → forge-completer   [claude-sonnet-4-6]
  memory     → forge-memory     [claude-haiku-4-5-20251001]

SKIP RULES
  skip_discuss:  false
  skip_research: false

GIT
  merge_strategy: squash
  auto_push:      false
  main_branch:    master

IDS
  format: timestamp        (timestamp | sequential)

(Read actual values from the prefs file — do not hardcode the above. For IDS, if no ids: block exists in the file, show format: timestamp (default).)

"models"

Display the full model list with descriptions:

MODELOS DISPONÍVEIS NO CLAUDE CODE

  opus    claude-opus-4-8[1m] (fallback: claude-opus-4-7)
          Modelo mais capaz. Ideal para: discuss, research, plan.
          Use quando precisar de raciocínio profundo e decisões arquiteturais.
          Fallback automático para 4-6 se 4-7 não estiver disponível na conta.

  sonnet  claude-sonnet-4-6
          Modelo balanceado (padrão para execução). Ideal para: execute, complete.
          Boa relação entre qualidade e custo.

  haiku   claude-haiku-4-5-20251001
          Modelo mais rápido e barato. Ideal para: memory extraction.
          Use para tarefas leves que não precisam de raciocínio pesado.

Para mudar o modelo de uma fase:
  /forge-prefs set <fase> <alias ou model ID>

Exemplos:
  /forge-prefs set execute opus
  /forge-prefs set execute claude-opus-4-8[1m]
  /forge-prefs set research haiku
  /forge-prefs set research claude-haiku-4-5-20251001

"set <phase> <model>"

Exemplos válidos:

/forge-prefs set research haiku
/forge-prefs set execute opus
/forge-prefs set execute claude-opus-4-8[1m]
/forge-prefs set plan claude-sonnet-4-6

Fases válidas: discuss, research, plan, execute, complete, memory

Mapa fase → arquivo de agente:

discuss → ~/.claude/agents/forge-discusser.md
research → ~/.claude/agents/forge-researcher.md
plan → ~/.claude/agents/forge-planner.md
execute → ~/.claude/agents/forge-executor.md
complete → ~/.claude/agents/forge-completer.md
memory → ~/.claude/agents/forge-memory.md

Steps:

Resolve o model ID completo (converta alias se necessário)
Atualize a coluna "Model ID" na tabela de Phase → Agent Routing no ~/.claude/forge-agent-prefs.md
Atualize o campo model: no frontmatter do arquivo de agente correspondente
Confirme:

✓ Fase 'execute' atualizada

  Antes: claude-sonnet-4-6
  Agora: claude-opus-4-8[1m]

  Arquivo do agente atualizado: ~/.claude/agents/forge-executor.md

Se o modelo passado não for reconhecido (nem alias nem model ID válido):

Modelo desconhecido: '{input}'

Modelos disponíveis:
  opus    → claude-opus-4-8[1m] (fallback claude-opus-4-7)
  sonnet  → claude-sonnet-4-6
  haiku   → claude-haiku-4-5-20251001

"skip-research <true|false>"

Toggle research phase skip. Update skip_research in ~/.claude/forge-agent-prefs.md. Confirm the new value.

"skip-discuss <true|false>"

Toggle discuss phase skip. Update skip_discuss. Confirm the new value.

"git <setting> <value>"

Exemplos: git auto_push true, git merge_strategy merge, git main_branch main

Update the git setting in ~/.claude/forge-agent-prefs.md. Confirm.

"ids <timestamp|sequential> [repo|local]"

Controla o formato dos IDs gerados para milestones e tasks soltas (pref ids.format, consumida por scripts/forge-ids.js). A leitura aceita sempre os dois formatos.

Exemplos:

/forge-prefs ids sequential — seta no user-global (~/.claude/forge-agent-prefs.md)
/forge-prefs ids sequential repo — seta no repo (.gsd/claude-agent-prefs.md, commitável)
/forge-prefs ids timestamp local — seta no local (.gsd/prefs.local.md, gitignored)

Scope → arquivo (cascata: user → repo → local, último ganha):

(omitido) → ~/.claude/forge-agent-prefs.md
repo → .gsd/claude-agent-prefs.md
local → .gsd/prefs.local.md

Steps:

Valide o valor: apenas timestamp ou sequential. Valor inválido → mostre os dois válidos e pare.
Read o arquivo do scope. Se já existe um bloco ids: com format:, edite o valor in-place. Se não existe, adicione ao final do arquivo:
```
ids:
  format: <valor>
```

Se o valor for sequential, inclua o aviso na confirmação:

⚠ sequential reintroduz risco de colisão entre devs/branches paralelos
  (dois devs criando milestone ao mesmo tempo geram o mesmo M00N).
  Recomendado apenas para repositório de dev único.

Confirme mostrando o valor efetivo resolvido pela cascata:

✓ ids.format atualizado

  Scope:  {user-global | repo | local} → {arquivo}
  Valor:  {timestamp | sequential}
  Efetivo (após cascata): {resultado de node scripts/forge-ids.js --help → ou
    grep dos 3 arquivos na ordem user → repo → local, último encontrado ganha}

  Formatos gerados a partir de agora:
    milestone: {M-<ts>-<slug> | M00N}
    task:      {T-<ts>-<slug> | TASK-00N}

Nota: repo/local exigem .gsd/ no projeto atual — se não existir, avise que o scope exige /forge-init primeiro e ofereça o user-global como alternativa.

"reset"

Restore all defaults:

discuss/research/plan → claude-opus-4-8[1m] (fallback claude-opus-4-7 se 4-7 indisponível na conta)
execute/complete → claude-sonnet-4-6
memory → claude-haiku-4-5-20251001
skip rules → all false
git → squash, auto_push false, main_branch master
ids → format timestamp (remove o bloco ids: apenas do user-global; repo/local não são tocados pelo reset)

Update both ~/.claude/forge-agent-prefs.md AND all agent frontmatter files. Confirm with the restored routing table.

After any change, show the updated routing table.