Writing, trimming or refreshing the CLAUDE.md or AGENTS.md file that loads for every session in a repository, keeping only what every session needs and cannot infer from the repository, sending conventions for one kind of work to project ways, and keeping status and history out of the file
vocabulary
claude.md agents.md guidance file at the root of the repo project instructions file loaded every session what belongs too long bloated trim prune stale agents ignore it forget how to run tests conventions commands gotchas
pattern
\b(claude|agents).md\b
refire
0.15
scope
agent, subagent
An instruction file such as CLAUDE.md or AGENTS.md loads into every session that opens in its directory. Each line costs context in every one of those sessions, so a line earns its place only when it saves the agent work it could not do from the files alone.
Run each command an instruction describes and confirm it works today (delivery/groundwork). Where fixing the step is smaller than documenting a workaround, fix the step. When observed behaviour contradicts the file, say so in one line and offer to fix the file or the script.