docs(voyage): S33 — reconcile agent inventory (21 spawnable + 3 reference docs) + record D1–D3 considered-and-kept

Balance-backlog S33 (DOC, non-breaking). The D1–D3 forks resolved conservatively
(balance-backlog-plan.md), collapsing the model + observability work into a
documentation record. Three deliverables, all doc-only, no code/frontmatter change:

- V35 (doc half): the "24 agents" headline is reconciled to its honest split —
  21 spawnable (one dormant: synthesis-agent, Δ≈0) + 3 orchestrator reference
  docs (planning-/research-/review-orchestrator document the inline /trek*
  workflow; not spawned). Each orchestrator header now declares itself a
  "reference document, not a spawnable capability". README + CLAUDE.md state the
  split; counts in the new pins are DERIVED from agents/ so they survive reword.
- D2 (V32 rationale): docs/observability.md gains a "Why direct export rather
  than a native collector" section — direct export keeps the path / SSRF /
  field-allowlist guards in audited in-process code (the S21 hardening) instead
  of re-hosting a collector; textfile mode remains the collector escape hatch.
- D3 (kept-opus): docs/voyage-vs-cc-balance-analysis.md §10 decision record —
  opus on V09 (glue), V35 (dormant), V11 (retrieval), V16 (mechanical), V08
  (researchers) was reconsidered for sonnet and KEPT (pin 40d8742 firm).

No agent frontmatter changed — tests/lib/agent-frontmatter.test.mjs is the
structural model source-of-truth and is untouched (diff is description-only:
model: opus + tools lists unchanged, no Agent tool granted). No Handover-1
change; no exporter/gemini-bridge removal. Non-breaking, no version bump.

tests/lib/doc-consistency.test.mjs: +5 S33 pins (inventory split derived from
agents/; synthesis-agent dormant; orchestrator relabel; observability D2
rationale; analysis-doc D1–D3 record). Tests 739 (737 pass / 2 skip / 0 fail),
bar `node --test`; `claude plugin validate` green (1 accepted warning).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LqBYc8Ltrk7LipyJmGxXiB

agents/planning-orchestrator.md

@@ -2,8 +2,10 @@
 name: planning-orchestrator
 description: |
   Inline reference (v2.4.0) — documents the planning workflow that
-  /trekplan executes in main context. Historically not spawned as a
-  sub-agent: before Claude Code 2.1.172 the harness did not expose the
+  /trekplan executes in main context.
+  This file is a reference document, not a spawnable capability.
+  Historically not spawned as a sub-agent: before Claude Code 2.1.172
+  the harness did not expose the
   Agent tool to sub-agents, so a background orchestrator could not spawn
   the exploration swarm (architecture-mapper, task-finder, plan-critic,
   etc.). As of CC 2.1.172 sub-agents can spawn sub-agents (up to 5 levels

agents/research-orchestrator.md

@@ -2,8 +2,10 @@
 name: research-orchestrator
 description: |
   Inline reference (v2.4.0) — documents the research workflow that
-  /trekresearch executes in main context. Historically not spawned as
-  a sub-agent: before Claude Code 2.1.172 the harness did not expose the
+  /trekresearch executes in main context.
+  This file is a reference document, not a spawnable capability.
+  Historically not spawned as a sub-agent: before Claude Code 2.1.172
+  the harness did not expose the
   Agent tool to sub-agents, so a background orchestrator could not spawn
   the research swarm. As of CC 2.1.172 sub-agents can spawn sub-agents
   (up to 5 levels deep), so a delegated-orchestration redesign is under

agents/review-orchestrator.md

@@ -2,8 +2,10 @@
 name: review-orchestrator
 description: |
   Inline reference (v3.2.0) — documents the review workflow that
-  /trekreview executes in main context. Historically not spawned
-  as a sub-agent: before Claude Code 2.1.172 the harness did not expose
+  /trekreview executes in main context.
+  This file is a reference document, not a spawnable capability.
+  Historically not spawned as a sub-agent: before Claude Code 2.1.172
+  the harness did not expose
   the Agent tool to sub-agents, so a background orchestrator could not
   spawn the reviewer swarm (brief-conformance-reviewer,
   code-correctness-reviewer, review-coordinator). As of CC 2.1.172