API design has always had one reader in mind: a human developer. However agents are the new reader that looks at things a bit different. Here are some of the tenets that we now hold our API to:
1. Errors are guidance
2. Budget the reader's context
3. Self-description beats documentation
4. Safe at machine tempo
5. Access without a human in the loop
6. The agent surface is a product, not a mirror
Read more: