[nephanth]

It is files that are meant to be read by software, not humans. From my point of view this seems like a prime candidate for a hidden directory?

[fleebee]

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.

[nephanth]

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

[numpad0]

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.

[skybrian]

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.

[nephanth]

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"?

[deadbabe]

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

[overfeed]

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"

[grim_io]

Yeah. Claude writes my CLAUDE.md

I don't really care what's inside.