summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJesse Vincent <jesse@primeradiant.com>2026-07-30 10:35:28 -0700
committerJesse Vincent <jesse@primeradiant.com>2026-07-31 10:27:51 -0700
commite9686d5c09b80323bfdc44be8804081e46ea0986 (patch)
tree407df27899a06c8ef0ede39fed0a46267b23fe1e
parentd8189d1587ed29cbf7b01ed4138edc8799164898 (diff)
fix(codex): explicit model+effort on every spawn, config backstopfix/t5-codex-spawn-routing
Depth-2 child-issued spawns omitted model 2/2 at CLI 0.146; model without reasoning_effort resets effort to the model default.
-rw-r--r--skills/using-superpowers/references/codex-tools.md19
1 files changed, 19 insertions, 0 deletions
diff --git a/skills/using-superpowers/references/codex-tools.md b/skills/using-superpowers/references/codex-tools.md
index 077550e..e4488fb 100644
--- a/skills/using-superpowers/references/codex-tools.md
+++ b/skills/using-superpowers/references/codex-tools.md
@@ -59,6 +59,25 @@ two-thirds of all wait calls were short polls that timed out.
`wait_agent`'s only job. A stretch that times out with no activity
is your cue to reconcile, not to shorten the next stretch.
+## Model routing on spawns
+
+Every `spawn_agent` you issue — including when you are yourself a
+spawned child running a fan-out — sets `model` AND `reasoning_effort`
+explicitly, per the Model Selection rules of the skill you are
+executing. Setting `model` alone is a trap: the child's effort
+silently resets to that model's default, not to yours.
+
+Ask your human partner to add a machine-level backstop to
+`~/.codex/config.toml` so any spawn that slips through still routes to
+a deliberate tier instead of silently inheriting the session's most
+expensive model:
+
+```toml
+[agents]
+default_subagent_model = "<a mid-tier model from your spawn allowlist>"
+default_subagent_reasoning_effort = "medium"
+```
+
## Environment Detection
Skills that create worktrees or finish branches should detect their