New
INSTRUCTIONS
Guides
7 min read
Writing agent instructions people can read
A practical guide to scenarios, rules and tone that your whole team can review.
By
Kenji Mori
The best agent instructions read like a good runbook. A new teammate should be able to follow them, and so should an agent.
Start with the scenario
Describe when the scenario applies, what the agent should check first and what a good outcome looks like. Keep each step to one action.
Name the tools
Refer to tools by name and say when to use them. If a step needs approval, say so plainly. Clear instructions make reviews faster and behavior easier to predict.