fix(docs): the alias targets and effort defaults match the docs today (green)

Verified 2026-10-02 against code.claude.com/docs/en/model-config and
/sub-agents. On the Anthropic API opus -> Opus 5.5 and sonnet ->
Sonnet 5.5 (default effort medium), fable -> Fable 5.1 (default high).
Three more claims in the same section were false and are corrected:
an agent without effort: inherits the session level, not the model
default; MAX_THINKING_TOKENS=0 has no effect on Opus 5.5, Sonnet 5.5
or Fable; effort is capped by maxEffortLevel or an organization cap.
"Mythos-class" is replaced by the docs' own wording. History is
untouched (CHANGELOG, the measurement docs, the Path C line).

STATE said seven files but listed six; the red pin found exactly
these six. The end-state registry line names a CC changelog fact and
stays as history.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

CLAUDE.md

@@ -82,7 +82,7 @@ Full flag reference for each command (modes, `--gates`, `--profile`, breaking ch
 
 > **Inventory (S33 reconcile, updated v5.10.1).** 23 agent files = **20 spawnable** (one, `synthesis-agent`, ships **dormant** — Δ≈0, wired to nothing) **+ 3 orchestrator reference docs** (`planning-/research-/review-orchestrator` document the inline `/trek*` workflow, not spawnable capabilities). All 23 stay `model: opus` (operator pin `40d8742`); the glue/mechanical/retrieval/dormant roles were reconsidered for a sonnet downgrade and **kept opus** — decision record: `docs/voyage-vs-cc-balance-analysis.md` §10.
 
-> **Model & effort.** `opus` = Opus 4.8 (default reasoning effort `high`); `sonnet` = Sonnet 4.6; `fable` = Fable 5 (Mythos-class, above Opus — reasoning effort inherits from the session; xhigh requires a session-level setting). Select agents carry native per-spawn `effort:` (retrieval → `medium`, adversarial-reasoning → `high`) — a different axis from brief `phase_signals.effort` (orchestration shape: which agents/passes run). Per-agent table + axes → `docs/profiles.md` §Model & effort axes.
+> **Model & effort.** On the Anthropic API, `opus` = Opus 5.5 and `sonnet` = Sonnet 5.5 (both default reasoning effort `medium`); `fable` = Fable 5.1 (the most capable model in Claude Code; default `high`, so xhigh must be chosen explicitly). An agent without `effort:` inherits the session level. Select agents carry native per-spawn `effort:` (retrieval → `medium`, adversarial-reasoning → `high`) — a different axis from brief `phase_signals.effort` (orchestration shape: which agents/passes run). Per-agent table + axes → `docs/profiles.md` §Model & effort axes.
 
 ## Reference docs (read on demand)
 

README.md

@@ -776,7 +776,7 @@ Four built-in model profiles plus operator-defined `<custom>.yaml` (drop in `lib
 | `economy` | sonnet | sonnet | sonnet | sonnet | sonnet | sonnet | ⚠ **Experimental** (uncalibrated Jaccard floor) — lowest cost; high-confidence small-scope tasks (opt-in via `--profile economy`) |
 | `balanced` | sonnet | sonnet | opus | sonnet | opus | sonnet | Mixed — opus where reasoning depth pays off (opt-in via `--profile balanced`) |
 | `premium` (default) | opus | opus | opus | opus | opus | opus | Maximum quality — Opus on every phase (default since the 2026-05-13 operator decision) |
-| `fable` | fable | fable | fable | fable | fable | fable | Max quality — Fable 5 (Mythos-class, above Opus) on every phase (opt-in via `--profile fable`); reasoning effort inherits from the session |
+| `fable` | fable | fable | fable | fable | fable | fable | Max quality — Fable 5.1 (the most capable model in Claude Code) on every phase (opt-in via `--profile fable`); reasoning effort inherits from the session |
 
 Lookup order:
 
@@ -801,9 +801,9 @@ Default JSONL stats stream (`${CLAUDE_PLUGIN_DATA}/trek*-stats.jsonl`) is unchan
 
 ## Cost profile
 
-The default `premium` profile runs **Opus on every phase** of the pipeline's agent work — the exploration and review swarms (5–10 sub-agents per command; spawn sites inject the composed brief > profile > frontmatter resolution, with `agents/*.md` `model: opus` pins as the fallback) and the executor (one per plan session). The command orchestrator itself is not profile-controlled: as of v5.9, command frontmatter omits `model:`, so the orchestrator follows the session model. For cheaper runs, opt into `--profile balanced` (Sonnet on brief/research/execute/continue, Opus on plan + review) or `--profile economy` (Sonnet everywhere); for maximum quality, `--profile fable` (Fable 5 on every phase). Per-command cost is published in `${CLAUDE_PLUGIN_DATA}/trek*-stats.jsonl` if you want exact numbers.
+The default `premium` profile runs **Opus on every phase** of the pipeline's agent work — the exploration and review swarms (5–10 sub-agents per command; spawn sites inject the composed brief > profile > frontmatter resolution, with `agents/*.md` `model: opus` pins as the fallback) and the executor (one per plan session). The command orchestrator itself is not profile-controlled: as of v5.9, command frontmatter omits `model:`, so the orchestrator follows the session model. For cheaper runs, opt into `--profile balanced` (Sonnet on brief/research/execute/continue, Opus on plan + review) or `--profile economy` (Sonnet everywhere); for maximum quality, `--profile fable` (Fable 5.1 on every phase). Per-command cost is published in `${CLAUDE_PLUGIN_DATA}/trek*-stats.jsonl` if you want exact numbers.
 
-The `opus` alias resolves to **Opus 4.8** (default reasoning effort `high`), `sonnet` to Sonnet 4.6, and `fable` to **Fable 5** (Mythos-class, above Opus; default reasoning effort `high` — xhigh requires a session-level setting, see [`docs/profiles.md`](docs/profiles.md)). Note two distinct effort axes that share the word "effort": brief `phase_signals.effort` (low/standard/high) tunes *orchestration shape* — how many agents and passes run — while native `effort:` on selected agents (retrieval at `medium`, adversarial-reasoning at `high`) tunes the *per-spawn reasoning budget*. See [`docs/profiles.md`](docs/profiles.md) § Model & effort axes.
+On the Anthropic API the `opus` alias resolves to **Opus 5.5** and `sonnet` to **Sonnet 5.5** (both default to reasoning effort `medium`), and `fable` to **Fable 5.1** (the most capable model in Claude Code; default reasoning effort `high` — xhigh must be chosen explicitly, see [`docs/profiles.md`](docs/profiles.md)). Other providers resolve `opus` and `sonnet` to other versions. Note two distinct effort axes that share the word "effort": brief `phase_signals.effort` (low/standard/high) tunes *orchestration shape* — how many agents and passes run — while native `effort:` on selected agents (retrieval at `medium`, adversarial-reasoning at `high`) tunes the *per-spawn reasoning budget*. See [`docs/profiles.md`](docs/profiles.md) § Model & effort axes.
 
 For per-profile cost estimates, see [`docs/profiles.md`](docs/profiles.md).
 

commands/trekbrief.md

@@ -404,15 +404,15 @@ The mapping table is canonical:
 - `low → {effort: low, model: sonnet}` (force sonnet for the low-cost path)
 - `standard → {effort: standard}` (model omitted; composition rule resolves via profile)
 - `high → {effort: high, model: opus}` (force opus for the high-confidence path)
-- `fable → {effort: high, model: fable}` (force Fable 5 for the max-quality path)
+- `fable → {effort: high, model: fable}` (force Fable 5.1 for the max-quality path)
 
 The fable tier reuses `effort: high` semantics — full swarm, contrarian
 always-on; `EFFORT_LEVELS` is unchanged (Voyage effort is orchestration
 shape, not model reasoning effort). Model reasoning effort is inherited from
-the session: Fable 5's default effort is `high`, NOT xhigh. To run xhigh, the
+the session: Fable 5.1's default effort is `high`, NOT xhigh. To run xhigh, the
-operator sets it at session level via `/effort xhigh`, the `effortLevel`
+operator chooses it explicitly via `/effort xhigh`, `--effort xhigh`, or
-setting, or `CLAUDE_CODE_EFFORT_LEVEL` — switching model resets effort to the
+`CLAUDE_CODE_EFFORT_LEVEL` — Claude Code saves effort per model, so a level
-model default, so it does not follow the model.
+saved for one model does not carry to another.
 
 ### Force-stop handling
 

commands/trekplan.md

@@ -549,7 +549,7 @@ Do NOT write this synthesis to disk. It is internal working context only.
 ## Phase 8 — Deep planning
 
 > **Schema-drift defense (sealed inline so this contract survives even when
-> `agents/planning-orchestrator.md` is not implicitly loaded by Opus 4.8).**
+> `agents/planning-orchestrator.md` is not implicitly loaded by the session model).**
 >
 > The plan you write MUST satisfy these regexes. The executor parses with
 > strict regex matching; any deviation breaks parsing and forces a re-plan.

docs/operations.md

@@ -37,7 +37,7 @@ Four built-in model profiles plus operator-defined `<custom>.yaml`. Each profile
 | `economy` | sonnet | sonnet | sonnet | sonnet | sonnet | sonnet | ⚠ **Experimental** (uncalibrated Jaccard floor) — lowest cost; high-confidence small-scope tasks (operator-opt-in via `--profile economy`) |
 | `balanced` | sonnet | sonnet | opus | sonnet | opus | sonnet | Mixed — opus where reasoning depth pays off (operator-opt-in via `--profile balanced`) |
 | `premium` (default) | opus | opus | opus | opus | opus | opus | Maximum quality — Opus on every phase. Default since 2026-05-13 operator request; also the hardcoded resolver default returned by `resolveProfile()` in `lib/profiles/resolver.mjs` |
-| `fable` | fable | fable | fable | fable | fable | fable | Max quality — Fable 5 (Mythos-class, above Opus) on every phase (operator-opt-in via `--profile fable`); reasoning effort inherits from the session — see `docs/profiles.md` §Model & effort axes |
+| `fable` | fable | fable | fable | fable | fable | fable | Max quality — Fable 5.1 (the most capable model in Claude Code) on every phase (operator-opt-in via `--profile fable`); reasoning effort inherits from the session — see `docs/profiles.md` §Model & effort axes |
 
 ### Lookup order
 

docs/profiles.md

@@ -14,7 +14,7 @@ Four pre-defined tiers ship with the plugin (fable added in v5.9), located at
 | `economy` | sonnet | sonnet | sonnet | sonnet | sonnet | sonnet | ⚠ **Experimental** (uncalibrated Jaccard floor) — lowest cost; small-scope tasks where you have high confidence the brief is right |
 | `balanced` | sonnet | sonnet | opus | sonnet | opus | sonnet | Mixed — opus where reasoning depth pays off (plan synthesis + adversarial review); opt-in via `--profile balanced` |
 | `premium` (default) | opus | opus | opus | opus | opus | opus | Maximum quality — Opus on every phase + external research on (default since the 2026-05-13 operator decision) |
-| `fable` | fable | fable | fable | fable | fable | fable | Max quality — Fable 5 (Mythos-class, above Opus) on every phase; opt-in via `--profile fable`; reasoning effort inherits from the session (see Model & effort axes) |
+| `fable` | fable | fable | fable | fable | fable | fable | Max quality — Fable 5.1 (the most capable model in Claude Code) on every phase; opt-in via `--profile fable`; reasoning effort inherits from the session (see Model & effort axes) |
 
 `premium` is the default tier — set by the 2026-05-13 operator decision and
 matched by the hardcoded resolver default in `lib/profiles/resolver.mjs`. It
@@ -23,7 +23,7 @@ roughly 5× the sub-agent cost of an all-sonnet run, accepted as a deliberate
 trade-off. Drop to `--profile balanced` (opus only on the two phases where
 quality matters most — Plan synthesis + Review — and sonnet everywhere else)
 or `--profile economy` (sonnet everywhere) when cost or latency matters more
-than depth. Step up to `--profile fable` (Fable 5 on every phase) when
+than depth. Step up to `--profile fable` (Fable 5.1 on every phase) when
 maximum quality is wanted end-to-end and cost is not a constraint.
 
 `economy` is *strictly experimental* in v4.1, and says so in the profile
@@ -38,19 +38,21 @@ back to `balanced`.
 
 ## Model & effort axes
 
-`opus`, `sonnet`, and `fable` are model **aliases**, not pinned ids. As of
+`opus`, `sonnet`, and `fable` are model **aliases**, not pinned ids. On the
-Claude Code 2.1.154 the `opus` alias resolves to **Opus 4.8**, whose default
+Anthropic API (verified 2026-10-02 against the Claude Code model-config docs)
-reasoning effort is **`high`**; `sonnet` resolves to Sonnet 4.6; `fable`
+the `opus` alias resolves to **Opus 5.5** and `sonnet` to **Sonnet 5.5**, both
-resolves to **Fable 5** (Mythos-class, positioned above Opus), whose default
+with default reasoning effort **`medium`**; `fable` resolves to **Fable 5.1**
-reasoning effort is also `high`. The profile table above selects *which
+(the most capable model in Claude Code), whose default reasoning effort is
-alias* runs each phase — it does not touch reasoning effort.
+**`high`**. Other providers resolve `opus` and `sonnet` to other versions. The
+profile table above selects *which alias* runs each phase — it does not touch
+reasoning effort.
 
 **Reasoning effort inherits from the session.** Voyage effort (orchestration
 shape — which agents/passes run) and model reasoning effort are different
-axes. Fable 5's default reasoning effort is `high`, NOT xhigh, and switching
+axes. Fable 5.1's default reasoning effort is `high`, NOT xhigh, and Claude
-model resets effort to the model default — xhigh does not follow the model.
+Code saves effort per model, so a level saved for one model does not carry to
-To run the fable tier at xhigh, set it at session level: `/effort xhigh`, the
+another. To run the fable tier at xhigh, choose it explicitly: `/effort xhigh`,
-`effortLevel` setting, or `CLAUDE_CODE_EFFORT_LEVEL`.
+`--effort xhigh`, or `CLAUDE_CODE_EFFORT_LEVEL`.
 
 Two different things share the word "effort" in Voyage. They are **orthogonal
 axes** — same name, different mechanism:
@@ -69,7 +71,7 @@ per-phase `model` (gated against `['sonnet','opus','fable']`). It never emits
 native `effort:`.
 
 **Native `effort:` on agents.** Voyage sets the reasoning axis statically on
-selected agents, additively over the Opus-4.8 default:
+selected agents, overriding the session level:
 
 - **Retrieval agents → `medium`:** `task-finder`, `git-historian`,
   `dependency-tracer`, `architecture-mapper` (structured discovery, not deep
@@ -77,12 +79,15 @@ selected agents, additively over the Opus-4.8 default:
 - **Adversarial-reasoning agents → `high`:** `plan-critic`, `risk-assessor`,
   `contrarian-researcher`, `review-coordinator` (synthesis and stress-testing
   where reasoning depth pays off).
-- **All other agents:** unset → inherit the model default (Opus 4.8 = `high`).
+- **All other agents:** unset → inherits the session's effort level (a session
+  that nothing sets runs at its model's default — `medium` on Opus 5.5).
 
 Native-effort precedence (harness): env `CLAUDE_CODE_EFFORT_LEVEL` > frontmatter
-`effort:` > session setting > model default. `MAX_THINKING_TOKENS=0` (or
+`effort:` > session setting > model default, and a `maxEffortLevel` setting or
-`--thinking disabled`) overrides effort entirely. Enterprise `availableModels`
+an organization effort cap still limits the result. `MAX_THINKING_TOKENS=0` has
-constrains the *model* alias only — it does **not** bound effort.
+no effect on Opus 5.5, Sonnet 5.5 or the Fable models: thinking cannot be turned
+off there. `availableModels` restricts which models can be selected — it does
+**not** bound effort.
 
 ## Decision tree