[writes] Edit Forge pipeline settings interactively. Use when changing framework, test runner, scoring thresholds, reviewer selection, convergence limits, or toggling features like caveman mode. Validates changes. Trigger: /forge-config, change settings, edit config, adjust thresholds, update scoring
See shared/skill-contract.md for the standard exit-code table.
| Command | Action |
|---|---|
/forge-config | Show current config summary |
/forge-config set <key> <value> | Set a config value |
/forge-config add <key> <value> | Add to list field (e.g., code_quality) |
/forge-config remove <key> <value> | Remove from list field |
/forge-config validate | Run validation (delegates to /forge-config-validate) |
/forge-config show <section> | Show specific section (components, scoring, convergence, caveman) |
/forge-config diff | Show changes since last pipeline run |
.claude/forge.local.md or .claude/forge-config.md exists. If neither: "No forge configuration found. Run /forge-init first." STOP..claude/forge.local.md and .claude/forge-config.md$ARGUMENTS (e.g., set components.testing vitest)${CLAUDE_PLUGIN_ROOT}/shared/validate-config.sh with the proposed changecomponents.* → forge.local.mdscoring.*, convergence.*, caveman.* → forge-config.md$ARGUMENTScode_quality)add: append value if not already presentremove: delete value if present, warn if not foundDelegates to /forge-config-validate skill. Shows results inline.
forge.local.md and forge-config.md.forge/state.json (if exists).forge/state.json: show "No previous run to compare against"<!-- locked --> fences in forge-config.md cannot be modified. Show: "This value is locked. Remove the <!-- locked --> fence to unlock."set/add/remove operation runs validation before applying| Condition | Action |
|---|---|
| Config file missing | Suggest: "Run /forge-init first" |
| Invalid key path | Show valid keys from config-schema.json |
| Invalid value | Show valid values with fuzzy suggestion |
| Locked section | Refuse edit, explain how to unlock |
/forge-config-validate — validate config without editing/forge-init — initial project setup/forge-help — find the right skill