You're right about that and I totally hate it as well. I had originally written it myself and then it got revamped along the way as I tried to change the positioning of the system from a personal home server to tools for agents.
Root agents.md should be human authored. Even if you copy and paste into it. That's your only lasting thread into having any intuition on the behavior that will result
Comments
I think if nothing else the technical facing value proposition should be human written.
Communicating is hard but that’s the point, takes a lot of effort to close the gap between a new and skeptical user and your vision.
Devs will not be able to bypass the PTSD of reading Claude prose.
You're right about that and I totally hate it as well. I had originally written it myself and then it got revamped along the way as I tried to change the positioning of the system from a personal home server to tools for agents.
Good observation thank you.
Amen. If i see a 5000 line README i am closing the tab.
I have in my CLAUDE/AGENTS.md to be concise with both chat output and documentation.
Yet still I get walls of text often. It's so fatiguing.
Root agents.md should be human authored. Even if you copy and paste into it. That's your only lasting thread into having any intuition on the behavior that will result