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 wrote docs. They weren't as good/complete as the LLM-written docs, and very few human contributors came by anyway. I am more interested in LLM-written docs now because a) the bots can write them and keep them up to date, and b) there are many more agents that will contribute to the codebase. These docs are very much still useful for human contributors as well. What I don't understand is why people are *angry* that we're now able to get better docs for both humans and bots.

@saulpw right, you missed what I'm talking about. I am talking about codebases that never wrote good contributing docs, but suddenly are writing those docs explicitly for machine consumption (e.g. not in the README for humans, not in the docs, but in files explicitly designed to be read by an LLM).

Yes, it's also convenient that those specific docs can help humans, but they’re not even exposed to people by default.

@cassidy Sorry, it looked like you were castigating anyone who has CLAUDE.md in their repo now. There are several mistaken assumptions in this thread and I'm sorry to contribute to those. *backs into bush*