Loading interactive tool…

This page in plain text

How to write a brief for AI

Treat AI like a new employee. Tell them “build me a shed” and you get a shed, some shed, any shed. Tell them the size, which way the door opens and what it is for, and you get the one you wanted. The result depends on the brief.

Why one-line prompts disappoint

A short ask leaves most of the job unsaid, and the AI fills every gap with a guess. It guesses the reader, so it writes for nobody in particular. It guesses the facts it cannot know. It guesses the shape, so you get an introduction, bullet points and a closing paragraph. And because nobody said what good looks like, the first draft that sounds fine is the one you get.

The five parts of a brief

  1. Role. Who the AI is for this job, and the standard it works to. “You are an editor at a trade magazine who cuts hard.”
  2. Goal. The one thing you want made, and what it is for. “Turn my notes into an article that gets shop owners to try a weekly stock count.”
  3. Context. The facts it cannot guess: the reader, what you know, what you tried. “Readers run small shops and have ten minutes.”
  4. Output. The shape of what comes back: length, format, tone, what to leave out. “600 words, plain language, no bullet points.”
  5. Check. How either of you can tell it worked. “It works if a reader could do their first count tomorrow.”

The order matters less than having all five. Write them all first and delete what a small job does not need.

Let it ask before it guesses

You will not think of everything. One sentence fixes that: “Before you start, ask me about anything important that is missing.” Every prompt in our library is built this way.

After the first draft

Two or three rounds beat one long prompt. Read the draft as the person receiving it, say exactly what is off (“too formal, cut the introduction, give me two real examples”) and ask again. Then check facts, numbers and names against a source you trust, and take out anything private.

The template

  • You are [role, and the standard they work to].
  • Goal: [the one thing to make], so that [what it is for].
  • Context: The reader is [who]. They already know [what]. I have tried [what]. Facts you need: [facts].
  • Output: [length], [format], [tone]. Leave out [what].
  • It works if [how we can both tell].
  • Before you start, ask me about anything important that is missing.

It works in ChatGPT, Claude, Gemini or any other chat assistant. Finished briefs for each kind of job are in the prompt library.

Ask Another AI Guy

I'm just Another AI Guy.

You're chatting with our fast model. Create a free account for the more thorough one, and more messages.