AI

How to write a brief an AI agent can act on

Most disappointing AI results come from a vague request. A short brief with a goal, the facts, the limits and what done looks like changes that.

When an AI agent gets a task wrong, the instructions are usually the first place to look. People ask an agent for “a better menu page” the way they would ask a colleague who already knows the business. The agent does not.

The four parts of a good brief

The goal. One sentence about the outcome, not the activity. “More people book a table from the menu page” is a goal. “Rewrite the menu page” is an activity.

The facts. What the agent must know and cannot guess: opening hours, prices, the tone you use, who your customers are, what you never offer.

The limits. What it must not do: change prices, promise delivery times, use photos you do not own, contact customers directly.

Done. How you will judge it. “A page with the five dishes we sell most, each with one line, and a booking button at the top and the bottom.”

An example

Goal: more people book a table from the menu page. Facts: we are a small family restaurant, lunch and dinner, closed Mondays; regulars come for the daily soup and the grilled fish. Limits: do not change prices or invent dishes; keep our plain, friendly tone. Done: a draft page with the five best sellers, one line each, and the booking button at the top and the bottom.

That takes two minutes to write and saves several rounds of corrections.

Give it examples

If you like a certain style, paste one example you like and one you do not, and say why. Agents follow examples more reliably than adjectives like “modern” or “warm”.

Ask for questions first

For anything larger than a small task, end the brief with: “Before you start, list anything you need to know.” A good agent will ask about the gaps instead of filling them with guesses, and you will often find the gaps were in your own picture too.

Guides · AI

More on AI.
Real work, people in the loop.

What AI does well for a business, how agents do real work, and where people stay in the loop.