Comment by vemv
3 days ago
I won't lie, this sounds like a recipe for context rot.
LLMs degrade as the context / prompt size grow. For that reason I don't even use a CLAUDE.md at all.
There are very few bits that I do need to routinely repeat, because those are captured by linters/tests, or prevented by subdividing the tasks in small-enough chunks.
Maybe at times I wish I could quickly add some frequently used text to prompts (e.g. "iterate using `make test TEST=foo`"), but otherwise I don't want to delegate context/prompt building to an AI - it would quickly snowball.
It's worth noting that the Claude Code team themselves add corrections to their CLAUDE.md file. So as long as you curate the corrections you're probably fine.
There is some amount of additions / corrections that can merge into simpler explanations over time.
Agree, thats why I did 2 things: 1) HITL - you review/approve changes 2) Added some instructions around limiting the claude.md size and keeping it concise