The inversion is real, but it surfaces an organizational problem most teams haven't solved: documentation has no clear owner. It falls between engineering, product, and whoever handles developer relations, and everyone assumes someone else is keeping it current. If docs become the authoritative source of intent for agents, that ownership gap becomes a production risk, not just a hygiene issue.
The inversion is real, but it surfaces an organizational problem most teams haven't solved: documentation has no clear owner. It falls between engineering, product, and whoever handles developer relations, and everyone assumes someone else is keeping it current. If docs become the authoritative source of intent for agents, that ownership gap becomes a production risk, not just a hygiene issue.
Facts
You might want to check out Manny Silva's Docs as Tests and AI ... seems like that's where you are heading.
https://www.isophist.com/p/every-doc-makes-a-promise
I'll check it out!