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 We were all told how awful and onerous documentation was supposed to be.

In fit of creative productivity, I might code out ahead of my docs but I never felt like it was as big a chore as it was made out to be.

Re-documenting a giant codebase is a different situation and one I haven't had to do yet. I think *inheriting* undocumented legacy code was the real big bad but we let it be our excuse for new undocumented code.