/memory-audit

Audit Claude Code memory hierarchy for a project. Shows what files load at session start, total context budget, and optimization hints.

Context

Claude Code loads memory files at session start in this order:

1. Managed policy (/Library/Application Support/ClaudeCode/CLAUDE.md)
2. User memory (~/.claude/CLAUDE.md)
3. User rules (~/.claude/rules/*.md)
4. Auto-memory (~/.claude/projects/{key}/memory/MEMORY.md, first 200 lines)
5. Project hierarchy (walk from / to CWD: CLAUDE.md, .claude/CLAUDE.md, .claude/rules/*.md)
6. Local overrides (CLAUDE.local.md at each level)

Rules with paths: frontmatter are conditional — loaded only when working on matching files. Rules without paths: always load and consume context budget.

Target: keep startup context under 40k chars. Large CLAUDE.md files should extract domain-specific sections into conditional .claude/rules/*.md files.

Steps