@cassidy I’ve found that LLM focused docs have a terseness that is great to read and skim and would’ve been rejected when I was a tech writer. I think we have room to normalize a shared system for “man and machine” but that means being willing to let go of some converntions that some people may still find useful and others will wish to pearl-clutch over.

Also, if your AGENTS.md contains all that you should probably generalize it to be about the “relationship protocol” and put the codebase specific’s in a project context document. That way it’s even better for humans and still works for the machine.