Documentation in the Era of AI Agents: How to Write for Machines and Humans

Large language models like ChatGPT and Claude are reshaping how we interact with text — including technical documentation. Traditionally written for human readers, documentation now has a new audience: AI agents.

This raises key questions:

• How should we write documentation so AI agents can understand and use it effectively?
• What steps can we take to make documentation more accessible to AI-driven tools?

To explore these questions, I engaged ChatGPT (with Internet research enabled) and shared the conversation here. Feel free to join the interactive chat and help take the discussion further.