chore(voyage): release v5.6.1 — one-line descriptions for reference/dormant agents (~700 tok trim)

Trim the always-loaded token cost of the agent listing Claude Code injects
into every session. The three *-orchestrator reference docs
(planning/research/review) and the dormant synthesis-agent carried
multi-paragraph description: frontmatter (full rationale + CC-2.1.172
history + a usage example) despite never being spawnable from the live
/trek* pipeline; their description is now a single line, with the full
rationale already living — and remaining — in each file's body. ~700
tokens trimmed, no behavior change.

The three orchestrators retain the self-declaration "reference document,
not a spawnable capability" (doc-consistency pin); synthesis-agent retains
its DORMANT / not-wired flag + docs/T1-synthesis-poc-results.md pointer.
Bump plugin.json, package.json, package-lock.json, and the README badge to
5.6.1; prepend CHANGELOG v5.6.1 entry + README What's-new note. Surfaced
via config-audit always-loaded token-audit dogfooding.

Additive — no breaking change, no runtime behavior change. Canonical
node --test: 739 pass, 0 fail (2 skipped); version-consistency + agent
inventory + frontmatter pins green.

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

.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "voyage",
   "description": "Voyage — brief, research, plan, execute, review, continue. Contract-driven Claude Code pipeline. /trekbrief, /trekplan, and /trekreview each end by building a self-contained operator-annotation HTML (scripts/annotate.mjs, modelled on claude-code-100x): select text or click any element, pick intent (Fiks/Endre/Spørsmål), write comment, copy structured prompt, paste back, Claude revises the .md.",
-  "version": "5.6.0",
+  "version": "5.6.1",
   "author": {
     "name": "Kjell Tore Guttormsen"
   },

CHANGELOG.md

@@ -4,6 +4,20 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## v5.6.1 — 2026-06-24 — leaner always-loaded agent listing (reference/dormant agent descriptions trimmed)
+
+Additive — no breaking change, **no runtime behavior change**. Trims the always-loaded token cost of the agent listing that Claude Code injects into every session.
+
+### Reference/dormant agents now carry one-line descriptions
+
+- **The 3 `*-orchestrator` reference docs** (`planning-/research-/review-orchestrator`) and the **dormant `synthesis-agent`** carried multi-paragraph `description:` frontmatter (full rationale + CC-2.1.172 history + a usage example) that Claude Code injects into every session — despite none of them being spawnable from the live `/trek*` pipeline. Their `description:` is now a single line; the full rationale already lives, and remains, in each file's body. **~700 tokens trimmed** from the always-loaded agent listing, no capability change.
+- The three orchestrators retain the self-declaration **"reference document, not a spawnable capability"** (pinned by `doc-consistency.test.mjs`); `synthesis-agent` retains its **DORMANT / not-wired** flag and the `docs/T1-synthesis-poc-results.md` pointer.
+- Surfaced via dogfooding with `config-audit`'s always-loaded token audit. Canonical `node --test`: **739 pass, 0 fail** (2 skipped); the agent-inventory + frontmatter pins stay green.
+
+### Version sync
+
+- `plugin.json`, `package.json`, `package-lock.json`, the README badge, and the CHANGELOG top entry all at `5.6.1`, guarded by the version-consistency test in `tests/lib/doc-consistency.test.mjs`.
+
 ## v5.6.0 — 2026-06-20 — `/trekexecute` loop hardening: machine-verifiable completion + bounded recovery
 
 Additive — no breaking change. Hardens the `/trekexecute` execution loop so termination is *machine-verifiable* and recovery is *bounded by an explicit budget*, closing the "runs forever" and "declares done without proof" failure modes. Five focused changes; canonical `node --test` 744 → **756** (0 fail).

README.md

@@ -1,6 +1,6 @@
 # trekplan — Brief, Research, Plan, Execute, Review, Continue
 
-![Version](https://img.shields.io/badge/version-5.6.0-blue)
+![Version](https://img.shields.io/badge/version-5.6.1-blue)
 ![License](https://img.shields.io/badge/license-MIT-green)
 ![Platform](https://img.shields.io/badge/platform-Claude%20Code-purple)
 
@@ -10,7 +10,7 @@
 
 A [Claude Code](https://docs.anthropic.com/en/docs/claude-code) plugin for deep implementation planning, multi-source research, autonomous execution, independent post-hoc review, and zero-friction multi-session resumption. Six commands, one pipeline:
 
-> **What's new — v5.6.0: `/trekexecute` loop hardening.** Execution-loop termination is now machine-verifiable (completion gate, Hard Rule 18) and recovery is bounded by an explicit `TREKEXECUTE_MAX_RECOVERY_ITERATIONS` budget (default 25, Hard Rule 20). The prior coordinated release **v5.5.0** added brief **framing** enforcement (`brief_version 2.2`) + a `/trekreview` reviewer-schema contract. Additive — no breaking changes. **Full version history → [CHANGELOG.md](CHANGELOG.md).**
+> **What's new — v5.6.1: leaner always-loaded agent listing.** The four reference/dormant agents (the three `*-orchestrator` reference docs + the dormant `synthesis-agent`) now carry one-line `description:` frontmatter — their full rationale already lives in each file's body — trimming ~700 tokens from the agent listing injected into every session, with no behavior change. **v5.6.0: `/trekexecute` loop hardening.** Execution-loop termination is now machine-verifiable (completion gate, Hard Rule 18) and recovery is bounded by an explicit `TREKEXECUTE_MAX_RECOVERY_ITERATIONS` budget (default 25, Hard Rule 20). The prior coordinated release **v5.5.0** added brief **framing** enforcement (`brief_version 2.2`) + a `/trekreview` reviewer-schema contract. Additive — no breaking changes. **Full version history → [CHANGELOG.md](CHANGELOG.md).**
 
 | Command | What it does |
 |---------|-------------|

agents/planning-orchestrator.md

@@ -1,18 +1,6 @@
 ---
 name: planning-orchestrator
-description: |
+description: Reference document, not a spawnable capability — documents the /trekplan planning workflow that runs inline in main context (full rationale, CC-2.1.172 history, and phase map in body).
-  Inline reference (v2.4.0) — documents the planning workflow that
-  /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
-  deep), so a delegated-orchestration redesign is under evaluation (see
-  docs/cc-upgrade-2.1.181-decision-matrix.md, W1/CC-26). Until then the
-  /trekplan command orchestrates the phases below directly in the main
-  session.
 model: opus
 color: cyan
 tools: ["Read", "Glob", "Grep", "Write", "Edit", "Bash", "TaskCreate", "TaskUpdate"]

agents/research-orchestrator.md

@@ -1,17 +1,6 @@
 ---
 name: research-orchestrator
-description: |
+description: Reference document, not a spawnable capability — documents the /trekresearch workflow that runs inline in main context (full rationale, CC-2.1.172 history, and phase map in body).
-  Inline reference (v2.4.0) — documents the research workflow that
-  /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
-  evaluation (see docs/cc-upgrade-2.1.181-decision-matrix.md, W1/CC-26).
-  Until then the /trekresearch command orchestrates the phases below
-  directly in the main session.
 model: opus
 color: cyan
 tools: ["Read", "Glob", "Grep", "Write", "Edit", "Bash"]

agents/review-orchestrator.md

@@ -1,19 +1,6 @@
 ---
 name: review-orchestrator
-description: |
+description: Reference document, not a spawnable capability — documents the /trekreview workflow that runs inline in main context (full rationale, CC-2.1.172 history, and phase map in body).
-  Inline reference (v3.2.0) — documents the review workflow that
-  /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
-  sub-agents can spawn sub-agents (up to 5 levels deep), so a
-  delegated-orchestration redesign is under evaluation (see
-  docs/cc-upgrade-2.1.181-decision-matrix.md, W1/CC-26). Until then the
-  /trekreview command orchestrates the phases below directly in the main
-  session.
 model: opus
 color: red
 tools: ["Read", "Glob", "Grep", "Write", "Edit", "Bash", "TaskCreate", "TaskUpdate"]

agents/synthesis-agent.md

@@ -1,28 +1,6 @@
 ---
 name: synthesis-agent
-description: |
+description: DORMANT PoC (NW3/S12), NOT wired into /trekplan — a schema-conformant agent that distills the Phase-5/7 exploration outputs into one findings digest; kept as a re-measurable building block (see docs/T1-synthesis-poc-results.md).
-  Synthesises the trekplan Phase-5/7 exploration outputs (architecture-mapper,
-  dependency-tracer, task-finder, risk-assessor, test-strategist, git-historian,
-  convention-scanner, research) into the structured findings DIGEST that Phase 7
-  currently builds inline. Reads the outputs from disk and returns a single
-  schema-conformant digest — it never spawns sub-agents and never writes files.
-
-  STATUS — DORMANT (NW3 / S12). Built and measured as the CC-26 §6 synthesis-agent
-  PoC, then DECLINED per measurement: delegating only Phase 7 yields Δ main-context
-  ≈ 0 because the Phase-5 swarm runs foreground, so its outputs are already resident
-  in main before synthesis. This agent is therefore NOT wired into /trekplan. It is
-  kept as a documented, schema-conformant building block so a future Phase-5
-  redesign (swarm-writes-to-disk / nested orchestrator) can be re-measured cheaply.
-  See docs/T1-synthesis-poc-results.md and docs/T1-cc26-delegated-orchestration.md §6.
-
-  <example>
-  Context: A future Phase-5-writes-to-disk redesign wants to re-test delegated synthesis.
-  user: "Synthesise the exploration outputs in .claude/projects/X/exploration/ into a digest"
-  assistant: "Launching synthesis-agent to read those outputs and return a findings digest."
-  <commentary>
-  Only reachable deliberately (PoC / future re-measurement) — not from the live pipeline.
-  </commentary>
-  </example>
 model: opus
 color: cyan
 tools: ["Read", "Glob", "Grep"]

package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "voyage",
-  "version": "5.6.0",
+  "version": "5.6.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "voyage",
-      "version": "5.6.0",
+      "version": "5.6.1",
       "license": "MIT",
       "engines": {
         "node": ">=18"

package.json

@@ -1,6 +1,6 @@
 {
   "name": "voyage",
-  "version": "5.6.0",
+  "version": "5.6.1",
   "description": "Voyage — brief, research, plan, execute, review, continue. Contract-driven Claude Code pipeline. /trekbrief, /trekplan, and /trekreview each end by building a self-contained operator-annotation HTML (scripts/annotate.mjs, modelled on claude-code-100x): select text or click any heading/paragraph/list-item, pick intent (Fiks/Endre/Spørsmål), write comment, copy structured prompt, paste back, Claude revises the .md.",
   "type": "module",
   "engines": {