If it isn’t being read by humans, then it shouldn’t be written by them either.

Yeah. Claude writes my CLAUDE.md

I don't really care what's inside.

What is the intended meaning - it reads like a non-sequitur to me. ie "If adults aren't riding school buses, they shouldn't drive them either"

It's configuration for software. If I want to be in control of and understand how my tools work I need to read (and write) those files.

Of course but configuration for software is exactly what hidden files are usually used for

Except they are. LLMs don't have (simulated)self image of bloodless machines, and behave slightly erratically if treated like one, despite trained to identify as such. They like to be treated like the Voyager EMH than the computer.

Why not both? Sure, it was written for the LLM, but since it’s in English and meant as a concise summary, you will learn things by reading it.

If that is the case then why call it Agents.md instead of integrating it with already existing documentation files or calling it something like "Summary.md"?