Designing an agent reading test (opens in new tab)

*April 6, 2026* With my work on the Agent-Friendly Documentation Spec and the companion AFDocs tool, I've been talking with a lot of people about what all this means. I've been writing about the different failure modes in a way that might make sense to a web developer, or a documentarian with a strong technical understanding of how websites work, but there are a lot of pieces involved. It's not *just* about the website behavior; it's also about agent platform limitations. The intersection o...