Skip to content

claude-md: evaluate every addition; add scope + nested-md destinations (0.11.0)#4

Merged
illinigirl merged 1 commit into
mainfrom
claude-md-every-addition
Jun 22, 2026
Merged

claude-md: evaluate every addition; add scope + nested-md destinations (0.11.0)#4
illinigirl merged 1 commit into
mainfrom
claude-md-every-addition

Conversation

@illinigirl

Copy link
Copy Markdown
Owner

Refines the v0.10.0 curator/audit per the official Claude Code memory docs and Megan's two refinements.

Curator hook

  • Prevention now fires on EVERY net addition (CLAUDE_MD_ADD_LINES default 1, was 10) — a 2-line paste can be misplaced reference just as easily as a big block.
  • The nudge checks the new content on two axes:
    • KIND — directive (keep) / reference (→ a skill) / area-specific (→ a nested CLAUDE.md or .claude/rules)
    • SCOPE — team convention (→ project CLAUDE.md) / personal (→ ~/.claude/CLAUDE.md) / sandbox-URL·test-data·secret (→ CLAUDE.local.md, gitignored)
  • Pure tweaks (net-0 lines) stay silent; the full audit stays gated to over-budget.

/claude-md-audit

  • Triage destinations expanded to keep / condense / extract-to-skill / move-to-nested-CLAUDE.md (+ .claude/rules) / re-scope / archive / remove, plus a Scope evaluation lens (flags personal prefs or secrets sitting in the shared file).
  • Notes that @import is eager (don't split with it) and that <!-- HTML comments --> are stripped from context.

Confirmed against the docs

Nested CLAUDE.md loads on-demand; @import is eager; .claude/rules/ path-scoping; the managed/user/project/local scope hierarchy. Added an AGENTS.md note (Claude reads it only via @import/symlink).

Verification

  • claude-md-curator 15/15 (every-addition, scope axis, net-0 silence, budget+debounce, target scoping, fail-safes).
  • All 5 hook suites green; ruff clean; manifests valid; claude plugin validate passes.

🤖 Generated with Claude Code

…s (0.11.0)

Refines the curator/audit per the official memory docs.

- curator hook: prevention now fires on EVERY net addition (CLAUDE_MD_ADD_LINES
  default 1, was 10) — a 2-line paste can be misplaced too. The nudge checks the
  new content on two axes: KIND (directive / reference→skill / area-specific→
  nested CLAUDE.md|.claude/rules) and SCOPE (team→project / personal→~/.claude /
  secret-or-local→CLAUDE.local.md). Pure tweaks (net-0) stay silent; full audit
  still gated to >budget.
- /claude-md-audit: triage destinations are now keep / condense / extract-to-
  skill / move-to-nested-CLAUDE.md (+ .claude/rules) / re-scope / archive /
  remove, plus a Scope lens. Notes that @import is eager (don't split with it)
  and that HTML comments are stripped from context.
- Confirmed against docs: nested CLAUDE.md loads on-demand; @import eager;
  .claude/rules path-scoping; the scope hierarchy. AGENTS.md note added (Claude
  reads it only via @import/symlink).
- Tests updated for every-addition behavior (15 cases); version 0.10.0 -> 0.11.0.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01D6pwpBdoug4tJRxxVrNNeL
@illinigirl illinigirl merged commit b18409f into main Jun 22, 2026
6 checks passed
@illinigirl illinigirl deleted the claude-md-every-addition branch June 22, 2026 14:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant