Skip to content

v0.8.0 - project CLAUDE.md headroom

Choose a tag to compare

@ringo380 ringo380 released this 30 Jul 22:29
· 10 commits to main since this release
8e7c480

A project's own ./CLAUDE.md is no longer held to the global file's strict budget.

The global ~/.claude/CLAUDE.md loads into every prompt of every session, so it keeps its hard budget: net delta at or below zero on every audit run, and active reduction until it lands under the ~40,000-char warning threshold.

A repo's own ./CLAUDE.md only costs context inside that repo, so it now gets headroom instead:

  • Under 20,000 chars - silent. Not reported, not a finding. Most project files live here.
  • 20,000 to 40,000 - one advisory ledger line, zero findings. Growing into this band is expected for a large or long-lived codebase.
  • Over 40,000 - a real finding, but still advisory. Decline it and the audit accepts that.

There is no no-growth rule for a project file. When one does need to shed weight, its detail relocates to project-local homes - ./.claude/docs/, the repo's own docs, or project memory - never into ~/.claude/notes/, which is global and would leak one repo's specifics into every other session.

Strict enforcement is available on demand: ask for it ("audit this repo strictly") for a single run, or record the preference in that project's memory and it persists across sessions. A strict run always prints the project ledger line, at any size, and names which trigger produced it.