My Project Docs Aren't For Humans Anymore. They're For an Agent That Re-Reads Them Every Session.

I used to write docs/ the way I was taught: prose paragraphs, a little context, a "why we did this" narrative you'd hand to a new hire. Then I noticed something. The only reader opening those files every single day wasn't a human. It was an agent, loading them fresh at the start of every session, with a token budget and zero memory of yesterday.

That changes what "good documentation" means, and I didn't actually update my writing style until a stale line in one of these files caused a real bug.

The setup

In my my-git-manager repo, CLAUDE.md points an agent at docs/project_notes/ on every session start:

## Project Memory System