RE: https://cosocial.ca/@mhoye/116148772813747144

I think of this every time I see AGENTS.md or CLAUDE.md. WHAT YOU ARE WRITING IS DOCUMENTATION. Why are you suddenly interested in writing clear documentation for the robots when this information would have been helpful for every human contributor who came across your project??

@cassidy I was thinking about it the other day, and I think I have a theory why techies write these docs all of a sudden: because they work.

Maintaining docs for people (in corporate environment, at least) is often an exercise in futility, because nobody reads them. Nobody expects docs to be up to date or usefully written, so they usually just ask the maintainer directly instead.

With AGENTS.md you actually see how it affects things and you see that your effort is not in vain.

@cassidy (mind you, I hate this entire AI shit with a burning heart, but I recognize what's happening.)