Engineering
7 min read
Writing docs for machines, not just for people
Agents read your docs before they call you. A practical guide to llms.txt, OpenAPI descriptions and examples that actually run.
Lena Hart
Your documentation is now part of your API. If an agent can’t understand what an endpoint does from its description, it will either guess or leave.
Start with llms.txt
A short, plain-text map of your product at a predictable URL. What it does, how to authenticate, and the five calls that matter most.
Then make every example runnable. An agent that can copy, run and see a real response learns your product in seconds.