Why does Claude Code ignore rules in a long CLAUDE.md?
A long CLAUDE.md loads whole into every session, so each rule competes with every other rule and with the task. Clyde keeps rules as separate short notes and recalls only the small packet that matches what the agent is doing.
Why the file grows
Every time an agent gets something wrong, someone adds a line. After a few months it's a few thousand words about everything, and the rule you need is somewhere in the middle.
Split it into notes
- Keep CLAUDE.md for what every session in the repo needs, like how to build and test.
- Move the rest into Clyde, one rule per note, under 500 characters each.
- Recall picks them by what the agent is doing. Notes used together get linked, so a related rule comes along.
Next
Install it with the coding agent setup, and read why Claude Code forgets between sessions.
Questions
Should I delete CLAUDE.md?
No. Keep the repo's build and test steps there. Move the long tail of lessons into Clyde.
How does recall pick the rules?
It matches words and meaning, then follows links between notes that were used together before. How it works has the details.
Do the notes work in Codex too?
Yes. Codex reads the same notes, so AGENTS.md can stay short as well.