open/voyage
1
0
Fork 0
Code Issues Releases 5 Activity

fix(docs): no doc claims an opus orchestrator any more; research spawns use the resolved model

Browse source 
D-07 had been closed on CLAUDE.md alone. The same false claim lived on elsewhere:
- README.md's "Switch the planning model" said four commands default to opus.
- The same README section offered a sed recipe for `model: opus` frontmatter lines, which
  0 of 7 command files have.
- commands/trekresearch.md said "the orchestrator runs on Opus".
Since v5.9.0 no command pins model:, so the orchestrator follows the session model.

- README: the section now says how it actually works. You pick the orchestrator's model with
  the session model (`claude --model sonnet` or `/model`). Sub-agent models are resolved at
  the spawn sites: brief phase_signals, then profile phase_models, then the agents/*.md pins
  as fallback. `--profile economy` still moves the sub-agents to Sonnet.
- trekresearch Launch rules: "Use model: "opus" for all sub-agents" contradicted the same
  file's own three-layer resolution, which v5.9.0 wired into the spawn sites and the file
  documents in Phase 1 and Hard rules -> Cost. The rule now injects
  `phase_signal_result.model` with agent frontmatter as the fallback, and says the
  orchestrator follows the session model. Nothing changes under the default premium
  profile: it still resolves to opus. The engine=swarm note now names the resolved-model
  injection as the anchor, instead of the removed literal.
- Two doc-consistency pins were written first and failed before this change:
  - no opus-orchestrator claim in README/CLAUDE.md/trekresearch, and no `^model: opus$`
    recipe;
  - the Launch rules name `phase_signal_result.model` and carry no blanket opus rule.
- Not touched: the follow-up agent in the default-off STORM phase still says model: "opus".
  That is part of an experiment whose fate is an operator decision.

End-state gate D-07: open -> closed. Defects 3 -> 2 of 7 (D-03, D-04 remain, by design);
registry integrity intact. Suite 1081 (1079/0/2), run on a clean export of the index.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Kjell Tore Guttormsen 2026-09-17 17:00:30 +02:00
commit e1d4425053
3 changed files with 42 additions and 18 deletions
Download patch file Download diff file Expand all files Collapse all files

6
commands/trekresearch.md
View file

@ -327,7 +327,7 @@ Profile below). The profile's on/off switch wins. Initialize
**engine = swarm (default):** run the `### External agents` block below
unchanged. This is byte-for-byte the current path, so `--engine swarm`
changes nothing (SC1). Keep the native-swarm anchors intact ("in parallel",
"single message", `model: "opus"`).
"single message", and the resolved-model injection in the Launch rules).
**engine = deep-research:**
@ -394,7 +394,9 @@ investigate, and any context from the interview.
### Launch rules
- Launch ALL selected agents **in parallel** in a single message
- Use model: "opus" for all sub-agents (the orchestrator runs on Opus)
- Inject the resolved model at every spawn: `phase_signal_result.model` (brief
signal > profile), with the agent's frontmatter `model:` as the fallback — see
Hard rules → Cost. The orchestrator itself follows the session model.
- **Never pass the Agent tool's `name` parameter — at this or any other spawn
site in this command.** `name` does not label a subagent, it changes its
kind: the spawn is recorded as `taskKind: "in_process_teammate"`