Cassidy James   Feb 28

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

Show threadIvan Sagalaev 

@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.

Mar 1 at 10:03pmWeb
Show threadIvan Sagalaev Mar 1
@cassidy (mind you, I hate this entire AI shit with a burning heart, but I recognize what's happening.)
Show threadThomas SturmMar 1

@isagalaev @cassidy That is certainly part of the problem.

I try to provide a maximum of documentation in various formats, and I can't count the meetings where I show up and none of the involved people across the company bothered to read any of it.