Skip to content

docs(rules): verify agent-inferred membership tags against the index#341

Merged
laurigates merged 1 commit into
mainfrom
docs/offload-verify-membership
Jul 23, 2026
Merged

docs(rules): verify agent-inferred membership tags against the index#341
laurigates merged 1 commit into
mainfrom
docs/offload-verify-membership

Conversation

@laurigates

Copy link
Copy Markdown
Owner

What

Add one routing-table row to offload-to-deterministic-substrate.md: a subagent's membership/ownership/security tag is an inference to verify against the authoritative index, computed once and passed in as ground truth. Condensed the intro, three-claims table, litmus, and rationale so the net change keeps the always-loaded global-context budget under ceiling (the rule ends ~500 B leaner overall while gaining the row).

Why

Distilled from this session's $HOME-cleanup audit. The classification fan-out conflated live-directory presence with chezmoi-managed membership three times — most sharply, a live ~/.gemini/oauth_creds.json was reported as "chezmoi-tracked & public" (a false secret-leak finding) until verified against chezmoi managed, which showed only .gemini/GEMINI.md is managed. Same class hit ~/tmp ("1,710 tracked entries" — actually 4 unmanaged scratch files).

Ownership/membership is a deterministic lookup, so compute it (chezmoi managed, git ls-files, gh api) and hand it to the agent rather than letting a reasoning agent infer it from co-location.

Verification

  • claude-context-budget pre-commit hook passes (was blocking at +523 B; net edit now under ceiling).
  • Documentation only; folded into the existing rule per Update-Over-Add.

🤖 Generated with Claude Code

Add a routing row to offload-to-deterministic-substrate: a subagent's
membership/ownership/security tag (tracked-in-git? secret public?
managed-by-X?) is an inference to verify against the authoritative index
(chezmoi managed, git ls-files), computed once and passed in as ground
truth — not trusted from co-location. Condensed the intro, three-claims
table, litmus, and rationale so the net change stays under the
always-loaded global context budget (rule ends ~500B leaner overall).

Distilled from a $HOME-cleanup audit where classification agents
conflated live-directory presence with chezmoi-managed membership 3×,
once nearly reporting a live ~/.gemini/ credential as tracked-and-public
(a false secret leak) before it was checked against `chezmoi managed`.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@github-actions github-actions Bot added documentation Improvements or additions to documentation claude labels Jul 22, 2026
@github-actions

Copy link
Copy Markdown
Contributor

⚠️ Broken Links Detected

Summary

Status Count
🔍 Total 170
✅ Successful 159
⏳ Timeouts 0
🔀 Redirected 0
👻 Excluded 9
❓ Unknown 0
🚫 Errors 2

Errors per input

Errors in docs/adrs/0013-nixos-declarative-system-configuration.md

Errors in exact_dot_claude/docs/prds/daily-catchup.PRD.md


Please fix the broken links before merging.

@laurigates
laurigates merged commit e802bdf into main Jul 23, 2026
7 of 8 checks passed
@laurigates
laurigates deleted the docs/offload-verify-membership branch July 23, 2026 08:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

claude documentation Improvements or additions to documentation size/s

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant