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.

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.

	▲	4b11b4 25 minutes ago \| parent [-]
		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