Find a codebase that you wrote that you enjoy, ask Claude to analyse it and write an agents.md based off of it.

Yes of course, have the AI write the agents.md file which the AI can then use to make changes to the project. This of course works better than just having the AI write changes to the project directly.

Seeing an AI competently summarize my codebase is one of the least boring things I do as a developer.

Do you not write documentation for what you build? Or guidelines for others on how to build it?

Are writing docs for humans using what you built anything like writing docs for what you want an ai to build?

Do you need to write long-ass, hyper-detailed instructions for your coworkers?

I do not, but I don't do that for LLMs either. Conventions and documentation I write and present are as succinct or lengthy as they need to be, no matter if the recipient is human or machine.

I mean I had my LLM generate most of my AGENTS.md, and I tweak it maybe once every week or two. It's minimal investment, and it's a gift that keeps on giving.