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 the contradiction is easily explained: the culture didn't actually change. most always those files are written by bots, for bots. Claude literally prompts you "hey you should start by running /init" the first use you use it. LLMs will take a simple "use a regex to customize a behavior in these cases" prompt and spit out a bonus 200 lines of slop.md regurgitating its context into your repository. If you don't catch that during code review, that becomes more write-only garbage no human will read, much less update, but still counts as technical debt when LLMs just choose to git grep random strings to see what they find