Ah yes. Agents.md is a magical file that just appears out of thin air. No one creates it, no one keeps it updated, and LLMs always, without fail, not only consult it but never forget it, and in every new session know precisely what changed in the project and how to continue.
All of them often can't even find/read relevant docs in a new session without prompting
Literally every single CLI-based Agent will show you a suggestion to run /init at startup.
And of course it's up to the developer to keep the documentation up to date. Just like when working with humans. Stuff don't magically document itself.
Yes "good code is self-documenting", but it still takes ages to find anything without docs to tell you the approximate direction.
It's literally a text file the agent can create and update itself. Not hard. Try it.
> Just like when working with humans. Stuff don't magically document itself.
Humans actually learn from codebases they work with. They don't start with a clean slate every time they wake up in the morning. They know where to find information and how to search for them. They don't need someone to constantly update docs to point to changes.
> but it still takes ages to find anything without docs to tell you the approximate direction.
Which humans, unsurprisingly, can do without wiping their memory every time.
All of them often can't even find/read relevant docs in a new session without prompting