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
This commit is contained in:
parent
fe54ec91b4
commit
f8d9d7fef9
9 changed files with 24 additions and 68 deletions
|
|
@ -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"
|
||||
},
|
||||
|
|
|
|||
14
CHANGELOG.md
14
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).
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
# trekplan — Brief, Research, Plan, Execute, Review, Continue
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
|
@ -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 |
|
||||
|---------|-------------|
|
||||
|
|
|
|||
|
|
@ -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"]
|
||||
|
|
|
|||
|
|
@ -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"]
|
||||
|
|
|
|||
|
|
@ -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"]
|
||||
|
|
|
|||
|
|
@ -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.
|
||||
|
||||
<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>
|
||||
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"]
|
||||
|
|
|
|||
4
package-lock.json
generated
4
package-lock.json
generated
|
|
@ -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"
|
||||
|
|
|
|||
|
|
@ -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": {
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue