You know that feeling when no one reads the documentation you wrote? I bet we've all experienced that moment when, after spending a lot of time crafting a README file, you realize nobody gives a fuck.
But how do you know nobody reads your Readme, I hear you ask?
Well, come on, remember when your colleague or manager asks for a call to quiz you on things you already carefully detailed in the docs?
And now? AI agents - which are basically LLMs trained on human data - expect you to have an `AGENTS.md` file. This is on top of the `README.md`, `CONTRIBUTING.md`, `STYLEGUIDE.md`, and `TESTING.md` files you've already written. It's happening all over again.
So "tu quoque," Claude? My friend Claude, you want me to create an `CLAUDE.md` file because you don't want to read my docs either...
This is why I propose we create an `AGENTS.md` file containing nothing but this:
But how do you know nobody reads your Readme, I hear you ask?
Well, come on, remember when your colleague or manager asks for a call to quiz you on things you already carefully detailed in the docs?
And now? AI agents - which are basically LLMs trained on human data - expect you to have an `AGENTS.md` file. This is on top of the `README.md`, `CONTRIBUTING.md`, `STYLEGUIDE.md`, and `TESTING.md` files you've already written. It's happening all over again.
So "tu quoque," Claude? My friend Claude, you want me to create an `CLAUDE.md` file because you don't want to read my docs either...
This is why I propose we create an `AGENTS.md` file containing nothing but this:
RTFRA
(Read The Fucking Readme, Agent)