Seeing all the questions in this thread, I strongly recommend Dachary Carey's post on the topic of agent-ready docs: https://dacharycarey.com/2026/02/18/agent-friendly-docs/