Really interesting perspective. The idea that every doc page now has two readers — the developer and the agent — feels very accurate.

What stood out to me most is that agent-first docs are not just about formatting content differently. They reduce wrong assumptions by giving agents cleaner, current, machine-readable context. For security or identity protocols, that matters even more because a small misunderstanding can turn into a real implementation risk.

I also like the split between llms.txt, llms-full.txt, Skills, and MCP. It makes the documentation layer feel less like static content and more like part of the developer tooling itself.