From f8d9d7fef9ee8709f4fda29dd68eeffed847bb8c Mon Sep 17 00:00:00 2001 From: Kjell Tore Guttormsen Date: Wed, 24 Jun 2026 11:52:59 +0200 Subject: [PATCH] =?UTF-8?q?chore(voyage):=20release=20v5.6.1=20=E2=80=94?= =?UTF-8?q?=20one-line=20descriptions=20for=20reference/dormant=20agents?= =?UTF-8?q?=20(~700=20tok=20trim)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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) Claude-Session: https://claude.ai/code/session_01CrTb8ktf1XZWEVwgz5MTTo --- .claude-plugin/plugin.json | 2 +- CHANGELOG.md | 14 ++++++++++++++ README.md | 4 ++-- agents/planning-orchestrator.md | 14 +------------- agents/research-orchestrator.md | 13 +------------ agents/review-orchestrator.md | 15 +-------------- agents/synthesis-agent.md | 24 +----------------------- package-lock.json | 4 ++-- package.json | 2 +- 9 files changed, 24 insertions(+), 68 deletions(-) diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index 29fe990..bc9c396 100644 --- a/.claude-plugin/plugin.json +++ b/.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" }, diff --git a/CHANGELOG.md b/CHANGELOG.md index ab89630..252a70c 100644 --- a/CHANGELOG.md +++ b/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). diff --git a/README.md b/README.md index 0cef395..f95ce45 100644 --- a/README.md +++ b/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 | |---------|-------------| diff --git a/agents/planning-orchestrator.md b/agents/planning-orchestrator.md index 1603930..a7c3511 100644 --- a/agents/planning-orchestrator.md +++ b/agents/planning-orchestrator.md @@ -1,18 +1,6 @@ --- name: planning-orchestrator -description: | - 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. +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). model: opus color: cyan tools: ["Read", "Glob", "Grep", "Write", "Edit", "Bash", "TaskCreate", "TaskUpdate"] diff --git a/agents/research-orchestrator.md b/agents/research-orchestrator.md index 04603c2..a31b950 100644 --- a/agents/research-orchestrator.md +++ b/agents/research-orchestrator.md @@ -1,17 +1,6 @@ --- name: research-orchestrator -description: | - 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. +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). model: opus color: cyan tools: ["Read", "Glob", "Grep", "Write", "Edit", "Bash"] diff --git a/agents/review-orchestrator.md b/agents/review-orchestrator.md index 0751191..b94d0cc 100644 --- a/agents/review-orchestrator.md +++ b/agents/review-orchestrator.md @@ -1,19 +1,6 @@ --- name: review-orchestrator -description: | - 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. +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). model: opus color: red tools: ["Read", "Glob", "Grep", "Write", "Edit", "Bash", "TaskCreate", "TaskUpdate"] diff --git a/agents/synthesis-agent.md b/agents/synthesis-agent.md index 39629d9..89bdab3 100644 --- a/agents/synthesis-agent.md +++ b/agents/synthesis-agent.md @@ -1,28 +1,6 @@ --- name: synthesis-agent -description: | - 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. - - - 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." - - Only reachable deliberately (PoC / future re-measurement) — not from the live pipeline. - - +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). model: opus color: cyan tools: ["Read", "Glob", "Grep"] diff --git a/package-lock.json b/package-lock.json index 63ff5b4..2c62c2a 100644 --- a/package-lock.json +++ b/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" diff --git a/package.json b/package.json index 5e7acd9..bca638c 100644 --- a/package.json +++ b/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": {