AI agents changed who writes the documents in my repositories. They didn't change who has to find them later.
Over the past year, agents have written most of the plans, specs, and work logs in my projects. They write them fast, they write them well enough — and they write them wherever they were pointed at that day. docs/, notes/, planning/, the repo root, a gist someone pasted into a ticket. Every file made sense the day it was created.
Then you come back six weeks later and try to answer a simple question: why did we decide this? The decision exists. It's written down somewhere. Neither you nor the agent that wrote it can find it — and an agent that can't find a decision doesn't stop. It confidently re-litigates it, or refactors it away.
That was the failure that kept repeating for me. Not missing documentation — unfindable documentation, written faster than anyone could organize it.
The fix is one file
