New

Kestrel now writes your weekly QA report for you.

Weekly QA reports, written for you.

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.

Create a free website with Framer, the website builder loved by startups, designers and agencies.