CLAUDE.md curator hook + /claude-md-audit (0.10.0)#3
Merged
Conversation
Keep an auto-loaded CLAUDE.md lean — the toolkit's nudge-hook + judgment-skill pattern, 4th instance. Principle: CLAUDE.md is the index (always-relevant directives); skills are the chapters (on-demand reference). - claude-md-curator/ (PostToolUse, CLAUDE.md/AGENTS.md only): mechanical-only. Prevention — every sizable addition (>= CLAUDE_MD_ADD_LINES, default 10) nudges "directive or reference? if reference, make it a skill instead of growing the file." Budget — over CLAUDE_MD_LINE_BUDGET (default 200) nudges a full audit, debounced once/session. CLAUDE_MD_AUDIT_DISABLED off-switch; never auto-edits; fail-open. Archive file (CLAUDE.archive.md) is not a target. - skills/claude-md-audit: the judgment engine. Reads the whole file (+ archive), reports concision/currency/usefulness/redundancy/length, and on approval applies a three-way triage: keep & tighten / extract to a skill (primary release valve) / archive stale to CLAUDE.archive.md (not auto-loaded). - catalog: new context-doc-bloat entry, cross-linked to stated-not-derived. - Wire hooks.json, CI test line, README section + layout, plugin + marketplace bumped to 0.10.0 (marketplace version re-synced too). - subagent-orchestration-DESIGN.md sibling: claude-md-audit-DESIGN.md. Verified: curator 14/14; all 5 hook suites green; ruff clean; manifests valid; claude plugin validate passes. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01D6pwpBdoug4tJRxxVrNNeL
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Keep an auto-loaded CLAUDE.md lean — the toolkit's nudge-hook + judgment-skill pattern, 4th instance (after failure-mode→/failure-scan, coverage-nudge→/coverage-audit, subagent-nudge→/orchestrate).
Principle: CLAUDE.md is the index (always-relevant directives); skills are the chapters (on-demand reference).
What's here
claude-md-curator/hook (PostToolUse,CLAUDE.md/AGENTS.mdonly) — mechanical-only, no LLM call. Two triggers:CLAUDE_MD_ADD_LINES=10): "directive or reference? — if reference, make it a skill instead of growing the file." The cheapest bloat to remove is the bloat that never lands.CLAUDE_MD_LINE_BUDGET=200): nudge a full audit, debounced once/session.CLAUDE_MD_AUDIT_DISABLEDoff-switch; never auto-edits; fail-open. The archive file is deliberately not a target./claude-md-auditskill — reads the whole file (+CLAUDE.archive.md), reports concision/currency/usefulness/redundancy/length, and on approval applies a three-way triage: keep & tighten / extract to a skill (primary release valve) / archive stale toCLAUDE.archive.md(not auto-loaded → zero per-session cost).context-doc-bloatcatalog entry, cross-linked tostated-not-derived-doc-facts.hooks.json+ CI; README section + layout; plugin & marketplace → 0.10.0.claude-md-audit-DESIGN.md— the design note it was built from.Verification
claude-md-curator14/14 tests (prevention, budget, debounce, target-scoping incl. archive excluded, disable, fail-safes).claude plugin validatepasses.🤖 Generated with Claude Code