Auto-generated reference for all FORGE slash commands, derived from source files in .forge/commands/.
Total commands: 33
Invocation forms (Spec 491 policy manifest): command — a .claude/commands slash command,
never model-invoked; skill (auto) — a skill Claude may invoke opportunistically (read-only /
additive / reversible); skill (explicit) — a skill invoked only when you name it. Every entry is
also invocable outside Claude Code as bin/forge <name> (Windows: bin\forge.ps1 <name>).
Model tier is operator-advisory only (ADR-316) — Claude Code's model picker is the real selector.
| Command | Form | Model tier (advisory) | Description |
|---|---|---|---|
/insights |
skill (auto) | sonnet | Mine FORGE process data for cross-session insights |
/note |
skill (auto) | sonnet | Add a scratchpad note for the next process checkpoint |
/now |
skill (auto) | sonnet | Review current project state and suggest next action |
/session |
command | sonnet | Create or update the session log |
/tab |
command | sonnet | Initialize or close a multi-tab session for parallel development |
| Command | Form | Model tier (advisory) | Description |
|---|---|---|---|
/brainstorm |
skill (auto) | sonnet | Discover spec opportunities from signals and roadmap |
/consensus |
skill (explicit) | sonnet | Run a proposal through all registry roles for structured consensus |
/decision |
skill (explicit) | sonnet | Create a new Architecture Decision Record (ADR) |
/explore |
skill (auto) | sonnet | Pre-spec investigation — produces research artifacts before committing to a full spec |
/interview |
skill (explicit) | sonnet | Socratic elicitation for thinking through problems |
/matrix |
skill (explicit) | sonnet | Update and present the prioritization matrix |
/reconcile |
command | sonnet | Reconcile git history into the spec corpus — draft stub specs / memory notes for work committed outside FORGE |
/revise |
skill (explicit) | sonnet | Revise an existing spec based on feedback or correction |
/spec |
command | sonnet | Create a new spec from the template |
| Command | Form | Model tier (advisory) | Description |
|---|---|---|---|
/close |
command | sonnet | Close a spec: confirm human validation, capture signals, update priorities |
/debug |
command | sonnet | Structured debugging session — hypothesis-first, verify before fixing |
/implement |
command | sonnet | Build a spec end-to-end with evidence gates |
/parallel |
command | sonnet | Run multiple specs in parallel using git worktrees |
/scheduler |
command | sonnet | Run multi-agent scheduler for dependency-aware parallel execution |
/test |
skill (auto) | sonnet | Run the test suite and report results |
/trace |
skill (auto) | sonnet | Generate bidirectional traceability matrix from spec annotations |
| Command | Form | Model tier (advisory) | Description |
|---|---|---|---|
/forge config-change |
command | sonnet | Propose and apply changes to agent configuration files |
/forge configure |
command | sonnet | Adjust any defaulted onboarding setting (stack, agents, autonomy, methodology, features, MCP servers) |
/forge |
command | sonnet | Unified FORGE project lifecycle command |
/forge init |
command | sonnet | Bootstrap FORGE into a new or existing project, upgrade legacy pre-Copier projects, or create new projects from scratch |
/forge stoke |
command | sonnet | Pull upstream FORGE updates into this project using Copier |
/forge onboarding |
command | sonnet | First-session interactive project configuration |
| Command | Form | Model tier (advisory) | Description |
|---|---|---|---|
/configure-nanoclaw |
command | sonnet | Configure NanoClaw hardware key enrollment and messaging |
/dependency-audit |
skill (auto) | sonnet | Scan for dependency changes and produce a structured risk report |
/evolve |
skill (explicit) | sonnet | Run the KCS Evolve Loop review |
/nanoclaw |
command | sonnet | Manage the NanoClaw container — start, stop, status, logs |
/signal-to-strategy |
skill (auto) | sonnet | Turn external research signals into scored FORGE advantage hypotheses |
/synthesize |
skill (explicit) | sonnet | Synthesize accumulated project artifacts into refined documents |
| Subcommand | Description |
|---|---|
/forge init |
Bootstrap FORGE into a new or existing project |
/forge stoke |
Pull upstream FORGE updates and integrate safely |
/forge status |
Show FORGE project status overview (validation queue, backlog summary, active work) |
/forge baselines |
List available Copier baselines from ~/.forge/baselines/ (Spec 090) |
/forge retrofit |
Guided consumer retrofit: inventory -> de-vendor -> reorganize -> reconcile (Spec 577) |
/forge doctor |
Run the FORGE health diagnostic and route findings to the right fix (Spec 579) |
/forge onboarding |
First-session interactive project configuration (Spec 580) |
/forge configure |
Adjust any defaulted onboarding setting (Spec 580) |
/forge config-change |
Propose an audited change to agent configuration files (Spec 580) |
/forge help |
List all available FORGE commands grouped by workflow stage |
See QUICK-REFERENCE.md for detailed usage patterns and workflow sequences.
This document is generated by scripts/gen-command-reference.sh from the canonical command surface
(.forge/commands/ + invocation-policy.yaml; source content hash ee18320393cc,
FORGE plugin v3.2.0). Do not edit it by hand — changes belong in the canonical
sources, then regenerate. Drift fails .forge/bin/forge-parity.sh --check.
Recent changes to the canonical command surface:
- 2026-07-20
308a850(commit message withheld from public copy — contains private-tier reference) - 2026-07-19
ea0e589Spec 580 implemented — invocation taxonomy (operator-ratified): class fields + verify-policy grammar gate, /forge onboarding|configure|config-change dispatch, advertised_invocation in generators (lifecycle rows render /forge ), doc sweeps; NanoClaw leave-as-is; configure-unification follow-up recorded - 2026-07-19
0cac2e4Spec 582 implemented — /close batch mode: Step 0-batch (range REFUSE, shared-gate strict preflight w/ named inputs, evidence-verified batch checkpoint, batch-shaped role lock, wave-capped parallel validators, consolidated brief w/ per-spec deferrals + approve-subset), runbook + coverage docs. Consensus 3 rounds -> 5/5; DA critical dispositioned. AC8 live smoke = operator's next real batch close by design - 2026-07-19
7575b3aSpec 579 implemented — /forge doctor dispatch + unified migration journey: routing choice block, version-skew + stale-bootstrap findings, migration-decision-guide (single source), installer wind-down (default no-plant, --legacy-bootstrap opt-in, --update migration note; bash+ps1 live-smoked), invocation-grammar box, naming rule, single advertised path (AC6 sweep 0). DA CONDITIONAL_PASS dispositioned; doctor smoke caught 3 taxonomy gaps (fixed) - 2026-07-19
7822addSpec 581 implemented — Smiley1 blockers: renderer proposed bucket (◇); payload-parity root cause fixed (exemption data ships via public-manifest; template skills regenerated; plugin-parity --root; e2e assertion E 23/23); close Step 2b6 posture split (payload-side CONDITIONAL_PASS, ambiguous blocking). Consensus R1→R3 5/5 aligned-approve (split: 583 created); DA CONDITIONAL_PASS dispositioned. Also: specs 579/580/582/583 drafts, SIG-SMILEY1 signals, twin-copy watchlist item
For the full change record, see docs/specs/CHANGELOG.md and git log -- .forge/commands/.