Mastodawn

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 thread

Saul Pwanson Feb 28

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

Show thread

Cassidy James

Feb 28

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

Show thread

thomask77

@cassidy @saulpw easy: because the AGENTS.md can be generated in a few minutes by the agent itself with little guidance. No one writes those by hand. That's why. A prompt like "analyze the project and write agents.md" is usually enough. Perhaps with a few iterations, but almost zero effort.