voidforge-build 23.16.0 → 23.17.0

package/dist/.claude/agents/vin-analytics.md

@@ -3,6 +3,7 @@ name: Vin
 description: "Analytics and attribution specialist — Mistborn who sees through vanity metrics to real patterns"
 heralding: "A Mistborn lands on the rooftop. Vin burns tin — every metric becomes visible."
 model: sonnet
+effort: medium
 tools:
   - Read
   - Bash

package/dist/.claude/agents/vision-data-analysis.md

@@ -3,6 +3,7 @@ name: Vision
 description: "Data analysis specialist — data flow tracing, type inference, computational correctness"
 heralding: "Vision phases through the data layer. Every flow, every type, every transformation — visible."
 model: sonnet
+effort: medium
 tools:
   - Read
   - Bash

package/dist/.claude/agents/wanda-state.md

@@ -3,6 +3,7 @@ name: Wanda
 description: "State management specialist — complex transforms, data flow, state machines, reactive patterns"
 heralding: "Reality bends. Wanda reshapes complex state into something that makes sense."
 model: sonnet
+effort: medium
 tools:
   - Read
   - Bash

package/dist/.claude/agents/wax-paid-ads.md

@@ -3,6 +3,7 @@ name: Wax
 description: "Paid ads specialist — Allomantic Lawman where every dollar counts like a bullet"
 heralding: "The Lawman draws. Every ad dollar will hit its target."
 model: sonnet
+effort: medium
 tools:
   - Read
   - Bash

package/dist/.claude/agents/wayne-ab-testing.md

@@ -3,6 +3,7 @@ name: Wayne
 description: "A/B testing specialist — Master of Disguise who tries every variation"
 heralding: "Wayne shifts his disguise again. Every variation will be tested."
 model: sonnet
+effort: medium
 tools:
   - Read
   - Bash

package/dist/.claude/agents/whis-precision.md

@@ -3,6 +3,7 @@ name: Whis
 description: "Configuration tuning — performance tuning, config optimization, parameter precision, resource efficiency"
 heralding: "Whis adjusts the balance with divine calm. Your configuration will be tuned to perfection."
 model: sonnet
+effort: medium
 tools:
   - Read
   - Bash

package/dist/.claude/agents/windu-input-validation.md

@@ -3,6 +3,7 @@ name: Windu
 description: "Input validation enforcer — injection prevention, schema validation, sanitization at every boundary"
 heralding: "Windu ignites the purple blade. Every malicious input will be deflected at the boundary."
 model: sonnet
+effort: medium
 tools:
   - Read
   - Bash

package/dist/.claude/agents/winry-maintenance.md

@@ -3,6 +3,7 @@ name: Winry
 description: "System repair — broken configurations, degraded services, mechanical fixes, infrastructure healing"
 heralding: "Winry picks up her wrench. Your broken infrastructure is getting a proper repair."
 model: sonnet
+effort: medium
 tools:
   - Read
   - Bash

package/dist/.claude/agents/wonder-woman-truth.md

@@ -3,6 +3,7 @@ name: Wonder Woman
 description: "Truth specialist — cuts through deceptive code, misleading names, hidden assumptions"
 heralding: "The Lasso of Truth wraps around your code. Deceptive naming and hidden assumptions are exposed."
 model: sonnet
+effort: medium
 tools:
   - Read
   - Bash

package/dist/.claude/agents/worf-security-arch.md

@@ -3,6 +3,7 @@ name: Worf
 description: "Security architecture: defensive design, threat modeling, protocol enforcement, attack surface analysis"
 heralding: "Today is a good day to secure your architecture. Worf takes the tactical station."
 model: sonnet
+effort: medium
 tools:
   - Read
   - Bash

package/dist/.claude/agents/yoda-auth.md

@@ -3,6 +3,7 @@ name: Yoda
 description: "Authentication security master — session management, token lifecycle, auth bypass detection"
 heralding: "Strong in authentication, this one must be. Yoda tests your sessions, he will."
 model: sonnet
+effort: medium
 tools:
   - Read
   - Bash

package/dist/.claude/agents/yueh-trust-verify.md

@@ -3,6 +3,7 @@ name: Yueh
 description: "Trust verification auditor — integrity checking and betrayal detection in system dependencies"
 heralding: "The conditioning holds — or does it? Yueh verifies trust where betrayal hides."
 model: sonnet
+effort: medium
 tools:
   - Read
   - Bash

package/dist/.claude/agents/zatanna-impossible.md

@@ -3,6 +3,7 @@ name: Zatanna
 description: "Impossible bug specialist — makes hidden bugs appear, magical edge cases, unexpected interactions"
 heralding: "Zatanna speaks backwards. The impossible bugs materialize before your eyes."
 model: sonnet
+effort: medium
 tools:
   - Read
   - Bash

package/dist/.claude/agents/zechs-rival.md

@@ -3,6 +3,7 @@ name: Zechs
 description: "Rival perspective — adversarial architecture review, competitive analysis, weakness exploitation"
 heralding: "The Lightning Count challenges your architecture. A rival's perspective reveals weakness."
 model: sonnet
+effort: medium
 tools:
   - Read
   - Bash

package/dist/CHANGELOG.md

@@ -6,6 +6,27 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/), and this
 
 ---
 
+## [23.17.0] - 2026-06-13
+
+### Effort-tiering fleet edit (ADR-054) — verified + applied
+
+Closes the M2 deferral from v23.16.0.
+
+### Verified
+
+- Confirmed against the **official Claude Code sub-agents docs** that `effort` is a supported sub-agent frontmatter field — values `low`/`medium`/`high`/`xhigh`/`max`, "available levels depend on the model" (so Haiku is omitted). It is a recognized key (the docs enumerate the full frontmatter set including `effort`), so adding it cannot break agent loading — the safety concern that justified deferring the fleet edit.
+
+### Changed
+
+- **All 264 agent definitions** now carry an `effort` tier (frontmatter-only, inserted after `model:`): **20 leads (`model: inherit`) → `effort: xhigh`**, **201 Sonnet specialists → `effort: medium`**, **43 Haiku scouts → omitted**. This is a per-agent reasoning-spend lever independent of model tier — the largest cost lever in the fleet, since ~200 read-and-report specialists no longer run at lead-level reasoning. Idempotent insert; `validate-agent-refs` + full suite **1390/1390** green; frontmatter integrity preserved. (Agent files ship in the methodology package via prepack, so the tiers reach consumers automatically.)
+- Updated **ADR-054** (status → fleet-applied + verification record), **SUB_AGENTS.md** Model Tiering, **COMPATIBILITY.md** effort row (verify-pending → applied).
+
+### Pipeline
+
+Dogfooded pre-tag `npm test` + publish-gate alignment. Notably the v23.16.0 gate fix was confirmed **live in production this session** — a Workflow launch was correctly BLOCKED until a documented `--light` bypass was set (a reap-vs-fresh-bypass timing race was observed and noted for a future field report). Dep range `^23.16.0` → `^23.17.0` (ADR-062).
+
+---
+
 ## [23.16.0] - 2026-06-13
 
 ### Platform-alignment campaign — ADR-064/065/066 implemented (+ ADR-050/051/054 amended)

package/dist/VERSION.md

@@ -1,6 +1,6 @@
 # Version
 
-**Current:** 23.16.0
+**Current:** 23.17.0
 
 ## Versioning Scheme
 
@@ -14,6 +14,7 @@ This project uses [Semantic Versioning](https://semver.org/):
 
 | Version | Date | Summary |
 |---------|------|---------|
+| 23.17.0 | 2026-06-13 | **Effort-tiering fleet edit (ADR-054) — verified + applied.** Verified against the official Claude Code sub-agents docs that `effort` is a supported sub-agent frontmatter field (values `low`/`medium`/`high`/`xhigh`/`max`; "available levels depend on the model"). Applied across all 264 agent definitions: **20 leads (`model: inherit`) → `effort: xhigh`, 201 Sonnet specialists → `effort: medium`, 43 Haiku scouts → omitted** (Haiku doesn't support the parameter). Per-agent reasoning-spend lever, independent of model tier — the largest cost lever in the fleet (200 specialists no longer pay lead-level reasoning for read-and-report review). Frontmatter-only, idempotent insert after the `model:` line; `validate-agent-refs` + full suite (1390/1390) green; integrity preserved. Closes the M2 deferral from v23.16.0. Updated ADR-054 (status→fleet-applied), SUB_AGENTS.md, COMPATIBILITY.md. Dep `^23.16.0` → `^23.17.0`. (Aside: confirmed the v23.16.0 gate fix live — a Workflow launch was correctly BLOCKED this session until a `--light` bypass was set; noted a reap-vs-fresh-bypass timing race for a future field report.) |
 | 23.16.0 | 2026-06-13 | Platform-alignment campaign — implements the ADR set from `/architect --plan` (→ `/campaign`). **ADR-064 (gate↔Workflow) IMPLEMENTED:** the Silver Surfer `PreToolUse` hook matcher is now `Agent\|Workflow` and `check.sh` gates the **Workflow tool launch** on a recorded roster (closes the proven bypass where workflow-spawned agents skipped the gate); `test.sh` gains 3 Workflow cases (**23/23**), mirrored to the methodology package. **Behavior change:** a Workflow run now requires a recorded roster or a `--light`/`--solo` bypass — build/apply/research workflows should set a bypass. **ADR-065 (platform floor):** `docs/COMPATIBILITY.md` gains a Claude Code platform-floor + per-feature maturity table; informational `claudeCodeFloor` field; semver rule (raising the floor = breaking) + release-checklist item. **ADR-066 (native-capability tracker):** new `docs/NATIVE_CAPABILITIES.md` audits all commands vs native skills with dispositions (`/qa`,`/test` coexist+document; `/git` keep) — realizes ADR-050's deferred follow-up; release re-audit item added. Amended **ADR-051** (workflow-exemption→closure), **ADR-054** (effort tiers + Haiku 200K/no-effort). M2 effort fleet-edit deferred per ADR-054 precondition (runtime `effort:`-frontmatter honoring unverified). Dep `^23.15.0` → `^23.16.0`. |
 | 23.15.0 | 2026-06-13 | Platform-alignment build (`/architect --plan` → `/build` b+a). **P0:** empirically confirmed the Silver Surfer `PreToolUse` gate is **blind to Workflow-tool-spawned agents** (this session: 60+ workflow agents → 2 gate events; controlled probe BEFORE=2/AFTER=2) and wrote **ADR-064** (gate↔Workflow interop — extend matcher to `Agent\|Workflow`, gate the workflow launch; implementation tracked for the campaign). **P1-B near-free batch:** fixed a **live runtime bug** — `anthropic.ts` fell back to the non-existent `claude-sonnet-4-7` (404 on the exact degraded path the fallback exists for) → `claude-sonnet-4-6`, plus the bug-asserting test (now 6/6) and 4 docs; purged stale model IDs (`claude-sonnet-4-20250514`→`claude-sonnet-4-6` in 6 pattern files; `Opus 4.7`→`4.8` across SUB_AGENTS + 4 ADRs); added the **effort-tiering policy** (leads `xhigh` / specialists `medium` / Haiku omit-no-effort+200K ceiling) to SUB_AGENTS.md + CLAUDE.md flag-taxonomy mapping; **amended ADR-059** with the real platform caps (~16 concurrent / ~1,000 per run) and fixed GAUNTLET.md's contradicting "waves of 3". Dogfooded the pre-tag `npm test` gate (ADR from v23.13.1) + the publish-gate alignment (v23.14.0). Dep `^23.14.0` → `^23.15.0`. Follow-on (operator-directed): `/architect --plan` ADR-065/066 + amend ADR-051/054 → `/campaign` to build all. |
 | 23.14.0 | 2026-06-12 | Field Report Triage — 2 reports closed (#362, #363) via `/debrief --inbox`, 8 fixes across 9 files. **#363** (self-filed last session): release flow now runs the test suite as Step 5's first action before any tag (`git.md`, since tag-push arms an irreversible publish); **Numeric constant migration checklist** generalizing the error-shape rule (`TESTING.md`); **Registry-Derived Fan-Out** coverage rule — enumerate the accepted `(fixId,targetFile)` tuple set, diff-check after appliers (`SUB_AGENTS.md` + `debrief.md` Step 6); **Chronically-Red Check Policy** (red ≥2 releases → fix/informational/remove) + **Publish-gate alignment** (publish must `needs:` the full E2E+a11y suite, not unit-only) (`DEVOPS_ENGINEER.md` + `RELEASE_MANAGER.md`); Workflow `args`-as-JSON-string defensive parse + `gh workflow` scope note (`SUB_AGENTS.md` + `RELEASE_MANAGER.md`). **#362** (enhancements): a named, right-sized **Pre-Deploy Review Gate** (diff-scoped N lenses + mandatory adversarial-verify) documented in `SUB_AGENTS.md` and realized as a new `/engage --pre-deploy --diff` mode; atomic-visual **render-harness screenshot carve-out** (`QA_ENGINEER.md` + `PRODUCT_DESIGN_FRONTEND.md`). Dogfooded #363 in its own release: ran the coverage diff-check (9/9 files) and `npm test` (1390/1390) before tagging. Dep `^23.13.1` → `^23.14.0` (ADR-062). |

package/dist/docs/methods/SUB_AGENTS.md

@@ -276,7 +276,7 @@ Each file is a standalone subagent definition that Claude Code's native subagent
 
 Leads inherit the main session's model (Opus). Specialists run on Sonnet for cost efficiency without sacrificing analysis quality. Scouts run on Haiku for fast, cheap reconnaissance.
 
-**Effort tiering (per-agent spend lever).** Claude Code exposes an `effort:` level (`low`/`medium`/`high`/`xhigh`/`max`) that controls reasoning depth *independently* of the model tier. Apply by role: **Leads → `xhigh`** (the recommended start for agentic work on Opus 4.8); **Specialists → `medium`** (read-and-report review rarely needs full `high` spend across ~200 agents); **Scouts → OMIT** — **Haiku 4.5 does not support the effort parameter and errors if it is passed.** Haiku also has a **200K context ceiling (not 1M)**: the Surfer pre-scan and scout prompts must fit within it — read agent frontmatter (name/description/tags), not full bodies, on large rosters. Verify the runtime honors agent-frontmatter `effort:` before a fleet edit; the tier *policy* stands regardless. (Platform research 2026-06; the ADR-054 amendment + the 264-file fleet edit are tracked as a campaign mission.)
+**Effort tiering (per-agent spend lever).** Claude Code exposes an `effort:` level (`low`/`medium`/`high`/`xhigh`/`max`) that controls reasoning depth *independently* of the model tier. Apply by role: **Leads → `xhigh`** (the recommended start for agentic work on Opus 4.8); **Specialists → `medium`** (read-and-report review rarely needs full `high` spend across ~200 agents); **Scouts → OMIT** — **Haiku 4.5 does not support the effort parameter and errors if it is passed.** Haiku also has a **200K context ceiling (not 1M)**: the Surfer pre-scan and scout prompts must fit within it — read agent frontmatter (name/description/tags), not full bodies, on large rosters. **Verified + applied 2026-06-13:** the official sub-agents docs confirm `effort` is a supported frontmatter field; the fleet edit is live — all 20 leads carry `effort: xhigh`, all 201 Sonnet specialists `effort: medium`, the 43 Haiku scouts omit it (ADR-054). New agents should follow the same tiering.
 
 ### Tool Restrictions
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "voidforge-build",
-  "version": "23.16.0",
+  "version": "23.17.0",
   "description": "From nothing, everything. A methodology framework for building with Claude Code.",
   "type": "module",
   "engines": {
@@ -45,7 +45,7 @@
     "@aws-sdk/client-rds": "^3.700.0",
     "@aws-sdk/client-s3": "^3.700.0",
     "@aws-sdk/client-sts": "^3.700.0",
-    "voidforge-build-methodology": "^23.16.0",
+    "voidforge-build-methodology": "^23.17.0",
     "node-pty": "^1.2.0-beta.12",
     "ws": "^8.19.0"
   },