CLAUDE.md and AGENTS.md improvement

Audit and improve the memory files AI agent harnesses (Claude Code, OpenAI Codex, etc.) load at the start of every session. The root memory file (CLAUDE.md or AGENTS.md) is a map plus rules: where am I, what runs this project, which conventions differ from defaults, which mistakes have actually happened. It is not a changelog and not a log of the codebase.

The levers, in order of payoff: shorten bullets, combine overlapping ones, audit each line against the removal test, and separate by altitude, with deep context in .claude/docs/, module facts in a memory file inside that module, occasional workflows in a command or skill, and open work in TODO.md. The repository's own docs/ is the project's documentation and stays out of this by default: agent context filed there litters the codebase. A memory file over roughly 40,000 characters, the ceiling commonly recommended for one, should be broken down rather than trimmed.

No grades and no scores. Findings are named failure modes with evidence, and every piece of content gets one of eight dispositions: keep, tighten, merge, move-to-docs, move-to-module, move-to-skill, move-to-todo, or delete. references/criteria.md defines both vocabularies.

Paths. ${CLAUDE_PLUGIN_ROOT}/skills/ means the directory holding this skill and its siblings (rabbit-writes, voice-setup, rabbit-readme-improver, rabbit-reads, rabbit-rewrites, rabbit-claude-md). Claude Code expands the variable. On a host that doesn't, such as Codex, resolve it that way by hand.

Modes

Mode	Trigger	Deliver
audit	"audit my CLAUDE.md", "check AGENTS.md", "is this any good", open-ended ask	Findings plus a disposition table, no edits
improve	"fix it", "tighten it", "update it"	The audit, then targeted diffs applied after approval
restructure	The file is oversized or mixed-altitude, or "split this up"	The audit, then a move plan: new `.claude/docs/` files, nested memory files, commands or skills, a `TODO.md`, and link-backs, applied after approval

Default to audit. Improve and restructure both pass through the audit report and the approval gate first, never straight to edits.