"If you write succinct, explicit, up-to-date instructions and provide complete examples, you may already be giving agent...

"If you write succinct, explicit, up-to-date instructions and provide complete examples, you may already be giving agents what they need. You don’t need to call them by their name nor degrade the quality of your docs by stamping “For agents” all over, because it doesn’t provide any advantage. The irony, I think, is finally improving your docs because you want agents to do well.These are the things that I would recommend that you do in your docs:1. Write explicit, updated operational guidance for all audiences (human and artificial). Complete docs with easy to parse structures and complete end-to-end examples are useful to all.2. Use evals to check if your docs are delivering against their objectives. Then, improve them accordingly. Consider encoding a doc objective in the frontmatter and run routine evaluations using several models.3. If you think raw code samples or compressed prose are too much for humans to digest, provide them in ways that don’t interfere with human consumption, li...