# Chore Log — instructions-files-diet

## Run 1 — 2026-04-26 — Pass 1 (Option B)

- **Operator:** Jeffry Babb
- **Trigger:** `/gz-context-diet` skill invocation under GHI #327
- **Pass scope:** Lifts 1, 2, 4, 5, 6 (high-confidence subset). Lifts 3 and 7 deferred to Pass 2.
- **Acceptance result:** 4/5 PASS (lint, documents+surfaces, advisory-scorecard, mkdocs strict). 1 pre-existing FAIL (`uv run -m unittest -q`) — baseline failure unrelated to this chore.
- **Line-count delta:** 1801 → 1768 (−33 net). See `baseline-2026-04-26.txt` and `post-trim-2026-04-26.txt`.
- **Bullet-retention:** zero Mechanical/Promotable bullets removed; advisory-scorecard validates clean. See `bullet-retention-audit.md`.
- **Pointer discipline:** every lift left a `> See [...]` one-line pointer at the origin site.
- **Surfaces touched:**
  - `src/gzkit/templates/agents.md` (canonical AGENTS.md source — sync regenerates AGENTS.md from this template)
  - `.gzkit/rules/tests.md` (canonical rule — sync regenerates `.claude/rules/tests.md`)
  - `docs/governance/agent-contract-rationale.md` (extended with three lifted sections)
  - `docs/governance/operator-economy.md` (new)
  - `docs/governance/tests-rationale.md` (new)
- **Sync:** `uv run gz agent sync control-surfaces` clean; AGENTS.md and `.claude/rules/tests.md` regenerated from canonical sources.

## Run 2 — 2026-04-26 — Pass 2 (recovery from reflog)

- **Operator:** Jeffry Babb
- **Trigger:** Recovery operation. Pass 2 had been authored and committed locally as `a716808c` (`chore: update .gzkit, AGENTS.md, AGENTS.md.bak, templates (gz git-sync)`, 2026-04-26 12:11 CDT) but was discarded by a `pull --rebase origin main` → `rebase abort` → `reset: moving to origin/main` sequence. Recovered via `git checkout a716808c -- AGENTS.md src/gzkit/templates/agents.md` followed by `gz agent sync control-surfaces`.
- **Pass scope:** Lifts 3 and 7 — deferred items from Pass 1. Trim is along the narrative axis: tighter intro paragraphs, compressed operative-claims commentary, table prose collapsed to lead sentences. Every binding bullet preserved; no invariant relaxed.
- **Acceptance result:** 4/4 PASS — `gz lint` clean, `gz validate --documents --surfaces` clean (2 scopes), `gz validate --advisory-scorecard` clean (1 scope), `mkdocs build --strict` clean (built in 6.96s).
- **Line-count delta (post-Pass-1 → post-Pass-2):**
  - `AGENTS.md`: 606 → 474 (−132)
  - `src/gzkit/templates/agents.md`: 549 → 417 (−132)
  - `.claude/rules/**`: 1102 → 1102 (no rule trim in Pass 2)
  - **Per-turn contract weight (AGENTS.md + CLAUDE.md + .claude/rules/**): 1768 → 1636 (−132)**
- **Cumulative trim from baseline:** 1801 (pre-Pass-1) → 1636 (post-Pass-2) = **−165 net** across both passes.
- **Bullet-retention:** every Mechanical/Promotable bullet on the advisory scorecard preserved; scorecard validation passes clean. The Pass 2 trim collapsed multi-paragraph rationale prose around Persona, DO IT RIGHT framing, anti-vibing operative claims, STDLIB-FIRST narrative, OPERATOR ECONOMY § Why this is canon, Lane & Kind Attestation Matrix prose, Defect-fix routing intro, and the Attestation worked-example block. No invariant text removed.
- **Pointer discipline:** Pass 2 did not lift new content to `docs/governance/`; it compressed prose at the origin site. The Pass 1 lift pointers (5 entries) remain intact.
- **Surfaces touched:**
  - `AGENTS.md` (recovered from `a716808c`)
  - `src/gzkit/templates/agents.md` (canonical source — recovered from `a716808c`)
  - All `.claude/`, `.agents/`, `.github/` mirrors (regenerated by `gz agent sync control-surfaces`)
- **Recovery commit:** `fix(diet): recover Pass 2 trim from reflog a716808c (GHI #327)`
- **Discarded artifacts from `a716808c`:** the original lost commit included a tracked `AGENTS.md.bak` (632-line preserved backup) — intentionally not recovered, since git history is the canonical backup and tracked `.bak` files are an artifact-pollution smell. Two ledger entries from the lost sync commit will re-fire on the next `gz git-sync` ceremony.

## Run 3 — 2026-04-30 — regression rescue

- **Operator:** Jeffry Babb
- **Trigger:** AGENTS.md tripped Claude Code's "Large AGENTS.md will impact performance" warning at startup (41,557 chars > 40,000 threshold). Operator framing: *"why has this regressed? we just fixed this!!!!!!!!!!!"*
- **Regression cause:** Three commits since the Pass 2 floor (`861beb7b`, 37,286 chars) re-inflated AGENTS.md inline rather than via pointers — the exact pattern the diet doctrine rules out:
  - `bbe24585` (audit-begin/end CLI verbs): +251 chars
  - `30104aee` (Behavior Rule #11 — course-correction → insights, GHI #357): +2,351 chars (full pedagogy inline)
  - `eba8e0c8` (DO IT RIGHT invariant 1a — coupled-surface coherence, GHI #372): +1,669 chars (single dense paragraph with operator framing, exemplars, mechanical anchor)
- **Trim performed:**
  - DO IT RIGHT 1a: ~1,700-char inline narrative → ~700-char binding sentence + pointer. Pedagogy lifted to `docs/governance/agent-contract-rationale.md` § *Rationale for 1a (coupled-surface coherence)*.
  - Behavior Rule #11: ~1,100-char inline narrative → ~300-char binding sentence + pointer. Pedagogy lifted to § *Rationale for Behavior Rule 11 (course-correction → insights)*.
  - § OPERATOR ECONOMY § Why this is canon, not preference: lifted in full; replaced with one-line pointer. Destination: § *Operator economy — why this is canon* (was previously lifted to its own page in Pass 1, but Pass 2 inadvertently re-inlined the heading; this run restores the pointer-only shape and seats the rationale in the canonical agent-contract-rationale doc).
  - § Attestation § Worked example: inlined block was already lifted in Pass 1 but the duplicate had been retained in template; collapsed to pointer-only.
  - § Why this contract is not minimal: three paragraphs already lifted at GHI #327 Pass 1; collapsed to one-sentence summary + pointer (the inline triple-paragraph form was Pass 1 leftover that subsequent commits propagated).
- **Acceptance result:** 4/5 PASS. Pre-existing `rule-placement` validation error on main (`skill_surface_sync.instructions.md` consumer-side AGENTS.md scaffold; latent issue noted in `eba8e0c8` commit body) — not caused by this trim, confirmed by `git stash` re-run.
- **Char-count delta (post-Pass-2 floor → post-Run-3):**
  - `AGENTS.md`: 41,557 (regression high-water) → 39,474 (−2,083, +268 below Pass-2 floor)
  - `src/gzkit/templates/agents.md` (canonical): trimmed in step
  - `.claude/rules/**`: 2,094 → 2,075 lines (−19, sync propagation)
  - `docs/governance/agent-contract-rationale.md`: extended with three new sections (`Rationale for 1a`, `Rationale for Behavior Rule 11`, `Operator economy — why this is canon`)
- **Cumulative regression headroom:** AGENTS.md is now 526 chars below the 40,000-char Claude Code performance threshold.
- **Bullet-retention:** every Mechanical/Promotable bullet preserved as binding text. No invariant relaxed; only narrative compressed and codas/duplicated worked-example lifted. Trim is along the narrative axis, not the invariant axis.
- **Pointer discipline:** every lift left a one-line `> See [...]` pointer at the origin site, in the same shape as Pass 1 entries.
- **Surfaces touched:**
  - `src/gzkit/templates/agents.md` (canonical AGENTS.md source)
  - `docs/governance/agent-contract-rationale.md` (extended with three lifted sections)
  - All `.claude/`, `.agents/`, `.github/` mirrors (regenerated by `gz agent sync control-surfaces`)
- **Structural follow-up:** GHI to be filed proposing `gz validate --instructions-files-budget` — a fail-closed audit on per-file char budgets so this regression class is mechanically prevented. Until that validator lands, the diet remains a manual one-shot trim with nothing fail-closing the next inflation.

## Run 4 — 2026-05-04 — Pass 3 (narrative lift + rule compression)

- **Operator:** Jeffry Babb
- **Trigger:** `/gz-context-diet` skill invocation. Session baseline 2200 (up from Run 3 floor 2075 due to ADR-0.0.23 agent-failure-mode taxonomy and ADR-0.0.25 OBPI REQ-coverage gate additions since Run 3).
- **Pass scope:**
  - `AGENTS.md` (via `src/gzkit/templates/agents.md`): lifted "Ownership and craftsmanship pillars..." from § Anti-vibing (→ rationale doc), removed § Relationship to the rest of the contract (already in rationale doc), lifted "LLM training corpus..." opener + § Highly-opinionated defaults + § Relationship to the corpus from § Stdlib-First (→ rationale doc), removed "Canonical interaction mode..." framing paragraph from § Operator economy.
  - `.gzkit/rules/agent-failure-modes.md`: consolidated 6× repeated "External citation: Opus 4.7..." blocks to single `[1]` note in header; lifted 3× worked examples (GHI #290, #263, #261) to rationale doc § Failure-mode worked examples; compressed § Loading posture to 3-line binding summary + pointer.
  - `docs/governance/agent-contract-rationale.md`: extended with § Stdlib-First doctrine rationale, § Agent failure-mode taxonomy loading posture and worked examples, and "Ownership and craftsmanship" paragraph in § Anti-vibing mantra.
- **Acceptance result:** 5/5 PASS — advisory-scorecard, documents+surfaces, lint, mkdocs strict, unittest (4049 tests).
- **Line-count delta (session baseline → post-trim):**
  - `AGENTS.md`: 470 → 454 (−16)
  - `.claude/rules/agent-failure-modes.md`: 228 → 200 (−28)
  - Other rule files: unchanged
  - **Total per-turn: 2200 → 2156 (−44)**
- **Bullet-retention:** zero Mechanical/Promotable bullets removed; all lifted content was Judgment-class narrative, rationale exposition, meta-commentary. Advisory scorecard validates clean (exit 0). See updated `bullet-retention-audit.md`.
- **Pointer discipline:** every lift left a `> See [...]` one-line pointer at the origin site.
- **Surfaces touched:**
  - `src/gzkit/templates/agents.md` (canonical AGENTS.md source)
  - `.gzkit/rules/agent-failure-modes.md` (canonical rule source)
  - `docs/governance/agent-contract-rationale.md` (extended with three lifted sections)
  - All `.claude/`, `.agents/`, `.github/` mirrors (regenerated by `gz agent sync control-surfaces`)
- **Discovery:** canonical for AGENTS.md is `src/gzkit/templates/agents.md` (not `AGENTS.md` directly) — sync regenerates the rendered file. Edits to `AGENTS.md` directly are overwritten on next sync. This run applied all template edits to the correct canonical source.
## Run 5 — 2026-05-07 — Full rules diet + CLAUDE.md template diet

- **Operator:** Jeffry Babb
- **Trigger:** Operator audit of per-turn token cost. Operator observed gzkit is "becoming too token-expensive to run." Audit showed `.claude/rules/` at ~29K tokens (72% of contract surface). CLAUDE.md at ~1.2K tokens with content duplicating AGENTS.md.
- **Pass scope:** Full diet of 9 rule files + CLAUDE.md template. Rules: `complexity-thresholds`, `complexity-doctrine`, `tool-skill-runbook-alignment`, `tests`, `agent-failure-modes`, `security-sensitivity`, `cross-platform`, `gh-cli`. CLAUDE.md: removed build commands (duplicate), compressed Invariant 10a, moved Opus 4.7 tuning to `docs/governance/opus-tuning.md`.
- **Acceptance result:** 5/5 PASS — advisory-scorecard, documents+surfaces, lint, complexity-thresholds, complexity-doctrine-links. All 4,401 tests pass (0 failures).
- **Line-count delta:**
  - `CLAUDE.md` (template): 111 → 23 (−88, 77%)
  - `.gzkit/rules/**`: 2505 → 1345 (−1160, 46%)
  - `AGENTS.md`: 454 → 454 (unchanged this run)
  - **Total per-turn: 3074 → 1826 (−1248, 40.6% reduction)**
- **Estimated token savings:** ~10,000 tokens/turn
- **Lift destinations created (7 new files, 1 extended):**
  - `docs/governance/opus-tuning.md` (new, 70 lines)
  - `docs/governance/complexity/complexity-thresholds-rationale.md` (new, 172 lines)
  - `docs/governance/complexity/complexity-doctrine-rationale.md` (new, ~140 lines)
  - `docs/governance/tool-skill-runbook-rationale.md` (new, 88 lines)
  - `docs/governance/security-sensitivity-rationale.md` (new, 62 lines)
  - `docs/governance/cross-platform-rationale.md` (new, 77 lines)
  - `docs/governance/tests-rationale.md` (extended, +80 lines)
- **Test fixes:** 12 test assertions updated for version bumps and dieted content. All 4,401 pass.
- **Bullet-retention:** every Mechanical/Promotable scorecard entry preserved. Advisory scorecard validates clean (exit 0).
- **Pointer discipline:** every lift left a `> See [...]` one-line pointer at the origin site.
- **Surfaces touched:**
  - `src/gzkit/templates/claude.md` + `CLAUDE.md` (canonical template)
  - `.gzkit/rules/` (9 canonical rule files)
  - `docs/governance/` (7 new + 1 extended rationale files)
  - `tests/` (test assertion updates for 5 test files)
  - All vendor mirrors regenerated via `gz agent sync control-surfaces`
- **Pool ADR note:** Conditional rule loading (the "tighter runs" CMS configurability) is tracked by `ADR-pool.progressive-context-disclosure` (heavy lane), with enablers `ADR-pool.focused-context-loader`, `ADR-pool.brief-loaded-context-manifest`, `ADR-pool.prime-context-hooks`. Foundation ADR-0.0.34 (rendering substrate, Draft) is the architectural base.

## 2026-05-04T02:26:29-05:00
- Status: PASS
- Chore: instructions-files-diet
- Title: Instructions & Memory Files Diet (Progressive Disclosure)
- Lane: lite
- Version: 1.0.0
- Criteria Results:
  - [PASS] `uv run gz validate --advisory-scorecard` => rc=0 (0.15s) -- exit 0 == 0
  - [PASS] `uv run gz validate --documents --surfaces` => rc=0 (0.32s) -- exit 0 == 0
  - [PASS] `uv run gz lint` => rc=0 (0.52s) -- exit 0 == 0
  - [PASS] `uv run mkdocs build --strict` => rc=0 (2.42s) -- exit 0 == 0
  - [PASS] `uv run -m unittest -q` => rc=0 (31.70s) -- exit 0 == 0

```text
[uv run gz validate --advisory-scorecard] stdout:
Validated: advisory_scorecard

✓ All validations passed (1 scopes).
[uv run gz validate --documents --surfaces] stdout:
Validated: surfaces, documents

✓ All validations passed (2 scopes).
[uv run gz lint] stdout:
Running linters...
All checks passed!

ADR path contract check passed.
No Path(__file__).parents[N] violations found.
Lint passed.
[uv run mkdocs build --strict] stderr:
[31m │  ⚠  Warning from the Material for MkDocs team[0m
[31m │[0m
[31m │[0m  MkDocs 2.0, the underlying framework of Material for MkDocs,
[31m │[0m  will introduce backward-incompatible changes, including:
[31m │[0m
[31m │  × [0mAll plugins will stop working – the plugin system has been removed
[31m │  × [0mAll theme overrides will break – the theming system has been rewritten
[31m │  × [0mNo migration path exists – existing projects cannot be upgraded
[31m │  × [0mClosed contribution model – community members can't report bugs
[31m │  × [0mCurrently unlicensed – unsuitable for production use
[31m │[0m
[31m │[0m  Our full analysis:
[31m │[0m
[31m │[0m  [4mhttps://squidfunk.github.io/mkdocs-material/blog/2026/02/18/mkdocs-2.0/[0m
[0m
INFO    -  Cleaning site directory
INFO    -  Building documentation to directory: /Users/jeff/Documents/Code/gzkit/site
INFO    -  The following pages exist in the docs directory, but are not included in the "nav" configuration:
  - AGENTS.md
  - drafts/claude-code-inventory.md
  - drafts/claude-code-vs-codex-control-surface-parity.md
  - drafts/sprint-and-drift-harness-governance.md
  - examples/presentations/index.md
  - examples/presentations/complete-series-script.md
  - examples/presentations/part1-script.md
  - examples/presentations/part2-script.md
  - examples/presentations/part3-script.md
  - examples/presentations/part4-script.md
  - examples/presentations/part5-script.md
  - examples/presentations/part6-script.md
  - examples/templates/req-template.md
  - governance/AGENTS.md
  - governance/advisory-rules-audit.md
  - governance/agent-contract-rationale.md
  - governance/agent-control-surface-fidelity-doctrine.md
  - governance/agent-control-surface-rendering-substrate.md
  - governance/ai-governance-brief.md
  - governance/ai-governance-research-gaps.md
  - governance/ai-governance-research-literature.md
  - governance/ai-governance-research-practice.md
  - governance/ai-governance-research-regulation.md
  - governance/ai-governance-verification.md
  - governance/ai-governance.md
  - governance/ai-governance.provenance.md
  - governance/arb-middleware.md
  - governance/defect-fix-routing.md
  - governance/harness-engineering-appraisal.md
  - governance/layer-three-derived-views.md
  - governance/model-regression-taxonomy.md
  - governance/operator-economy.md
  - governance/tests-rationale.md
  - governance/trust-doctrine.md
  - governance/GovZero/obpi-pipeline-runbook.md
  - governance/research_sources/0900001680afb122.md
  - governance/research_sources/1-introduction-the-imperative-of-public-values-in-ai.md
  - governance/research_sources/1680afaeba.md
  - governance/research_sources/a-closer-look-at-the-existing-risks-of-generative-ai-mapping-the-who-what-and-how-of-real-world-inci.md
  - governance/research_sources/advancing-accountability-in-ai-en.md
  - governance/research_sources/ai-risk-management-framework-japanese-translation.md
  - governance/research_sources/anthropics-responsible-scaling-policy-version-30.md
  - governance/research_sources/artificial-intelligence-risk-management-framework-ai-rmf-10.md
  - governance/research_sources/artificial-intelligence-risk-management-framework-generative-artificial-intelligence-profile.md
  - governance/research_sources/arxiv-240614713.md
  - governance/research_sources/arxiv-240714981.md
  - governance/research_sources/auditing-work-exploring-the-new-york-city-algorithmic-bias-audit-regime.md
  - governance/research_sources/claude-4-system-card.md
  - governance/research_sources/hai-ai-index-report-2025-chapter3-final.md
  - governance/research_sources/hls20white20paper20final-v3.md
  - governance/research_sources/introducing-the-oecd-ai-capability-indicators-en.md
  - governance/research_sources/m-24-10-advancing-governance-innovation-and-risk-management-for-agency-use-of-artificial-intelligenc.md
  - governance/research_sources/m-25-21-accelerating-federal-use-of-ai-through-innovation-governance-and-public-trust.md
  - governance/research_sources/m-25-22-driving-efficient-acquisition-of-artificial-intelligence-in-government.md
  - governance/research_sources/microsoft-word-ai-governance-tiimalasipaperi-arxivdocx.md
  - governance/research_sources/nistai600-1genai-profileipd.md
  - governance/research_sources/operator-system-card.md
  - governance/research_sources/preparedness-framework-v2.md
  - governance/research_sources/quantifying-detection-rates.md
  - governance/research_sources/responsible-ai-governance-a-systematic-literature-review.md
  - governance/research_sources/responsible-ai-governance-in-the-public-sector-explaining-contextual-dynamics-through-a-realist-synt.md
  - governance/research_sources/responsible-use-guide.md
  - governance/research_sources/steering-ais-future-en.md
  - governance/research_sources/the-bureaucratic-challenge-to-ai-governance-an-empirical-assessment-of-implementation-at-us-federal.md
  - governance/research_sources/the-governance-of-ai-companies-reconciling-purpose-with-profits.md
  - harness-docs/GZK-GOV-007-ultrareview-and-gate-5.md
  - harness-docs/expanding-the-bitter-lesson-for-agentic-software-development.md
  - harness-docs/xhigh-measurement-protocol.md
  - releases/PATCH-v0.24.3.md
  - releases/PATCH-v0.25.10.md
  - releases/PATCH-v0.25.11.md
  - releases/PATCH-v0.25.12.md
  - releases/PATCH-v0.25.13.md
  - releases/PATCH-v0.25.14.md
  - releases/PATCH-v0.25.15.md
  - releases/PATCH-v0.25.16.md
  - releases/PATCH-v0.25.17.md
  - releases/PATCH-v0.25.18.md
  - releases/PATCH-v0.25.19.md
  - releases/PATCH-v0.25.7.md
  - releases/PATCH-v0.25.8.md
  - releases/PATCH-v0.25.9.md
  - releases/PATCH-v0.26.0.md
  - superpowers/plans/2026-03-26-pipeline-reliability-improvements.md
  - superpowers/specs/2026-03-26-pipeline-reliability-improvements-design.md
  - user/commands/adr-evaluate.md
  - user/commands/adr-report.md
  - user/commands/arb-advise.md
  - user/commands/arb-coverage.md
  - user/commands/arb-patterns.md
  - user/commands/arb-ruff.md
  - user/commands/arb-step.md
  - user/commands/arb-ty.md
  - user/commands/arb-typecheck.md
  - user/commands/arb-validate.md
  - user/commands/arb.md
  - user/commands/check.md
  - user/commands/chores-advise.md
  - user/commands/chores-doctor.md
  - user/commands/chores-propose-ghi.md
  - user/commands/chores-show.md
  - user/commands/drift.md
  - user/commands/format.md
  - user/commands/frontmatter-reconcile.md
  - user/commands/interview.md
  - user/commands/issue-file.md
  - user/commands/justify.md
  - user/commands/lint.md
  - user/commands/obpi-audit.md
  - user/commands/obpi-complete.md
  - user/commands/obpi-lock-check.md
  - user/commands/obpi-lock-claim.md
  - user/commands/obpi-lock-list.md
  - user/commands/obpi-lock-release.md
  - user/commands/obpi-lock-status.md
  - user/commands/obpi-withdraw.md
  - user/commands/personas-drift.md
  - user/commands/plan.md
  - user/commands/preflight.md
  - user/commands/readiness-evaluate.md
  - user/commands/roles.md
  - user/commands/skill-list.md
  - user/commands/skill-new.md
  - user/commands/test.md
  - user/commands/tidy.md
  - user/commands/typecheck.md
  - user/commands/validate.md
  - user/concepts/reporter-architecture.md
  - user/concepts/subagent-pipeline.md
  - user/concepts/task-overview.md
  - user/manpages/arb.md
  - user/manpages/closeout.md
  - user/manpages/gz-adr-audit-check.md
  - user/manpages/gz-chores.md
  - user/manpages/gz-issue.md
  - user/manpages/gz-justify.md
  - user/manpages/gz-personas.md
  - user/manpages/patch-release.md
  - user/skills/_TEMPLATE.md
  - user/skills/airlineops-parity-scan.md
  - user/skills/ghi-author.md
  - user/skills/ghi-close.md
  - user/skills/ghi-triage.md
  - user/skills/gz-adr-autolink.md
  - user/skills/gz-adr-promote.md
  - user/skills/gz-adr-recon.md
  - user/skills/gz-adr-sync.md
  - user/skills/gz-agent-sync.md
  - user/skills/gz-check-config-paths.md
  - user/skills/gz-context-diet.md
  - user/skills/gz-deps-upgrade.md
  - user/skills/gz-issue-file.md
  - user/skills/gz-justify.md
  - user/skills/gz-migrate-semver.md
  - user/skills/gz-pythonic-pattern-apply.md
  - user/skills/gz-pythonic-pattern-detect.md
  - user/skills/gz-skill-router.md
  - user/skills/gz-tech-debt-review.md
  - user/skills/gz-tidy.md
INFO    -  Documentation built in 2.28 seconds
[uv run -m unittest -q] stdout:
Error: Attestation receipt-binding gate failed (heavy/foundation policy).
  - missing: no receipt file at
arb-step-unittest-dddddddddddddddddddddddddddddddd.json
Recovery: re-run the cited ARB commands and re-cite the resolved receipt IDs.
Error: ADR closeout blocked — unwaived REQ coverage gaps in ADR-9.9.9-fixture:
  OBPI-9.9.9-99-fixture: REQ-9.9.9-99-01
Waive each gap with `gz obpi complete --accept-uncovered <REQ-ID>
--accept-uncovered-reason <REASON>` before closing the ADR.
ADR closeout receipt emitted.
  ADR: ADR-9.9.9-fixture
  Event: closed
ADR closeout receipt emitted.
  ADR: ADR-9.9.9-fixture
  Event: closed
ADR Eval: ADR-0.0.26 -- GO
  Weighted total: 0.75/4.0
  OBPIs scored: 0
ADR Eval: ADR-0.0.26 -- GO
  Weighted total: 0.75/4.0
  OBPIs scored: 0
ADR Eval: ADR-0.0.26 -- GO
  Weighted total: 0.75/4.0
  OBPIs scored: 0
ADR Eval: ADR-0.0.26 -- NO GO
  Weighted total: 0.75/4.0
  OBPIs scored: 0
ADR Eval: ADR-0.0.26 -- GO
  Weighted total: 0.75/4.0
  OBPIs scored: 0

Advisory proposal: dim:clarity:low
  Recurrence: 3
  Summary: Dimension 'clarity' scored in the 'low' band across 3 distinct
artifacts
  Rule target: docs/governance/clarity-low-improvement.md
Advisory: would file GHI for dim:clarity:low
No proofs directory for eval-feedback-cluster
No unfiled proposals for eval-feedback-cluster.

Proposal: dim:clarity:low
  Recurrence: 3
  Summary: Dimension 'clarity' scored in the 'low' band across 3 distinct
artifacts
  Rule target: docs/governance/clarity-low-improvement.md
Filed: https://github.com/owner/repo/issues/101

Proposal: dim:clarity:low
  Recurrence: 5
  Summary: Dimension 'clarity' scored in the 'low' band across 3 artifacts
  Rule target: docs/governance/clarity-low-improvement.md
Filed: https://github.com/owner/repo/issues/100

Proposal: dim:clarity:low
  Recurrence: 3
  Summary: Dimension 'clarity' scored in the 'low' band across 3 distinct
artifacts
  Rule target: docs/governance/clarity-low-improvement.md
Filed: https://github.com/owner/repo/issues/99
Chores registry diff:
  + agents-md-architectural-boundaries
  + arb-pattern-extraction
  + cli-contract-governance
  + complexity-reduction-xenon
  + config-paths-remediation
  + control-surface-rule-conflicts
  + control-surface-rule-vs-check-drift
  + control-surface-skill-rule-reachability
  + coverage-40pct
  + cross-platform-test-cleanup
  + dependency-currency
  + doc-coverage
  + eval-feedback-cluster
  + evidence-integrity-audit
  + exceptions-and-logging-rationalization
  + frontmatter-ledger-coherence
  + hardcoded-root-eradication
  + instructions-files-diet
  + memory-hygiene
  + module-sloc-cap-radon
  + pep257-docstring-compliance
  + pool-triage
  + pythonic-design-pattern-application
  + pythonic-design-pattern-detection
  + pythonic-refactoring
  + quality-check
  + repository-structure-normalization
  + schema-and-config-drift-audit
  + skill-authoring-quality
  + skill-command-doc-parity
  + skill-manifest-sync
  + skill-trigger-testing
  + sync-manpage-docstrings
  + test-isolation-compliance
  + test-manpage-examples
  + validate-manpages
  = only-local (local-only, preserved)
Chores registry diff:
  + agents-md-architectural-boundaries
  + arb-pattern-extraction
  + cli-contract-governance
  + complexity-reduction-xenon
  + config-paths-remediation
  + control-surface-rule-conflicts
  + control-surface-rule-vs-check-drift
  + control-surface-skill-rule-reachability
  + coverage-40pct
  + cross-platform-test-cleanup
  + dependency-currency
  + doc-coverage
  + eval-feedback-cluster
  + evidence-integrity-audit
  + exceptions-and-logging-rationalization
  + frontmatter-ledger-coherence
  + hardcoded-root-eradication
  + instructions-files-diet
  + memory-hygiene
  + module-sloc-cap-radon
  + pep257-docstring-compliance
  + pool-triage
  + pythonic-design-pattern-application
  + pythonic-design-pattern-detection
  + pythonic-refactoring
  + quality-check
  + repository-structure-normalization
  + schema-and-config-drift-audit
  + skill-authoring-quality
  + skill-command-doc-parity
  + skill-manifest-sync
  + skill-trigger-testing
  + sync-manpage-docstrings
  + test-isolation-compliance
  + test-manpage-examples
  + validate-manpages
  = only-local-slug (local-only, preserved)
Chores registry diff:
  + agents-md-architectural-boundaries
  + arb-pattern-extraction
  + cli-contract-governance
  + complexity-reduction-xenon
  + config-paths-remediation
  + control-surface-rule-conflicts
  + control-surface-rule-vs-check-drift
  + control-surface-skill-rule-reachability
  + coverage-40pct
  + cross-platform-test-cleanup
  + dependency-currency
  + doc-coverage
  + eval-feedback-cluster
  + evidence-integrity-audit
  + exceptions-and-logging-rationalization
  + frontmatter-ledger-coherence
  + hardcoded-root-eradication
  + instructions-files-diet
  + memory-hygiene
  + module-sloc-cap-radon
  + pep257-docstring-compliance
  + pool-triage
  + pythonic-design-pattern-application
  + pythonic-design-pattern-detection
  + pythonic-refactoring
  + quality-check
  + repository-structure-normalization
  + schema-and-config-drift-audit
  + skill-authoring-quality
  + skill-command-doc-parity
  + skill-manifest-sync
  + skill-trigger-testing
  + sync-manpage-docstrings
  + test-isolation-compliance
  + test-manpage-examples
  + validate-manpages
  = only-local (local-only, preserved)
ADR audit-check: ADR-0.0.23
PASS All linked OBPIs are completed with evidence.

Coverage: No REQs found for this ADR.
ADR audit-check: ADR-0.1.0
PASS All linked OBPIs are completed with evidence.

Coverage: No REQs found for this ADR.
ADR audit-check: ADR-0.1.0
PASS All linked OBPIs are completed with evidence.

Coverage: No REQs found for this ADR.
ADR audit-check: ADR-0.1.0
PASS All linked OBPIs are completed with evidence.

Coverage: No REQs found for this ADR.
ADR audit-check: ADR-0.1.0
PASS All linked OBPIs are completed with evidence.

Coverage: No REQs found for this ADR.
Backfill 1 covers-backfill warning(s):
  tests/x.py:1 REQ REQ-0.1.0-01-01 introduced @ aaaaaaa (0c / 0d before receipt
r1); see .claude/rules/tests.md § Invariant 6f for remediation
ADR audit-check: ADR-0.1.0
PASS All linked OBPIs are completed with evidence.

Coverage: No REQs found for this ADR.
Unresolvable 1 covers-backfill location(s) not resolvable in git:
  tests/x.py:1 unresolvable
ADR audit-check: ADR-0.1.0
PASS All linked OBPIs are completed with evidence.

Coverage: No REQs found for this ADR.
FAIL 1 covers-backfill finding(s):
  tests/x.py:1 REQ REQ-0.1.0-01-01 introduced @ aaaaaaa (0c / 0d before receipt
r1); see .claude/rules/tests.md § Invariant 6f for remediation
[uv run -m unittest -q] stderr:
Skipping unparseable file: /var/folders/7y/cvcpqqnj2_52yy4wl780kmqc0000gn/T/tmpn1i5xw92/test_broken.py
Malformed REQ line (skipped): - [ ] REQ-X-Y-Z: Malformed (non-numeric).
Malformed REQ line (skipped): - [ ] REQ-: Empty body.
----------------------------------------------------------------------
Ran 4049 tests in 31.243s

OK (skipped=1)
```

---

## 2026-05-22 Pass 4 — Catalog Indirection + Token-Block Compression

### Summary

Trimmed hot-path instruction weight without relaxing invariants:

- Replaced the generated skill-name catalog in `AGENTS.md` with the live discovery command `uv run gz skill list` and the canonical skill-body path.
- Compressed `.gzkit/agents.local.md` governance-doctrine and architectural-boundary rationale while keeping every binding boundary.
- Compressed `.gzkit/rules/token-block-discipline.md` railway-history rationale into pointers to `docs/governance/token-block-doctrine.md`, preserving all binding sub-invariants.
- Updated sync/template tests to assert the new skill-catalog indirection contract.

### Inventory

| Surface | Before | After | Delta |
|---|---:|---:|---:|
| `AGENTS.md` | 392 | 366 | -26 |
| `CLAUDE.md` | 27 | 27 | 0 |
| `.gzkit/rules/token-block-discipline.md` | 135 | 132 | -3 |
| Total measured surface | 2110 | 2081 | -29 |

Proof files:

- `baseline-2026-05-22.txt`
- `post-trim-2026-05-22.txt`
- `bullet-retention-audit.md` Run 5 section

### Validation

| Command | Result |
|---|---|
| `uv run gz validate --advisory-scorecard` | PASS |
| `uv run gz validate --surfaces` | PASS |
| `uv run gz validate --instructions-files-budget` | PASS |
| `uv run gz validate --invariant-coherence` | PASS |
| `uv run gz lint` | PASS |
| `uv run mkdocs build --strict` | PASS |
| `uv run -m unittest -q` | PASS, 5432 tests |
| `uv run gz validate --documents --surfaces` | FAIL, 1736 known legacy ADR document-corpus errors present before this pass |
## 2026-05-22T05:52:54-05:00
- Status: FAIL
- Chore: instructions-files-diet
- Title: Instructions & Memory Files Diet (Progressive Disclosure)
- Lane: lite
- Version: 1.0.0
- Criteria Results:
  - [PASS] `uv run gz validate --advisory-scorecard` => exit 0
  - [FAIL] `uv run gz validate --documents --surfaces` => exit 1 (known 1736 legacy ADR document-corpus errors present before this pass)

Full failure output intentionally omitted from this proof log; see `baseline-2026-05-22.txt` and `post-trim-2026-05-22.txt` for the tracked blocker summary.
