Guides · 14

The one-shot prompt

A vague prompt costs five rounds of "no, not like that." A complete one gets the right result the first time. This is the checklist, with the research behind it.

1 minute 53 seconds · animated infographic · sound on

Why this matters

A model fills every gap with a guess

Whatever you leave out of the prompt, the model invents: the goal, the audience, the definition of done. One-shot prompting is just leaving no gaps worth guessing about. It is not a talent. It is a habit with a checklist.

The four-part anatomy

  1. Goal. What you want, and where. Which file, which page, which account. "Improve the email" is a wish; "shorten the follow-up email to under 100 words" is a goal.
  2. Context. The facts the model cannot guess: the exact error message, who the audience is, what was already tried, the constraint that matters.
  3. Output spec. The shape of done: format, length, tone, what to include and what to leave out. If you want a table, say table.
  4. Done check. How you will know it worked: a test you can actually run. "Done when the checkout page loads without the error."

Miss one part and the model fills that gap for you, confidently. The why-AI-guesses explainer covers what happens next.

The context rules

These come from research, not taste (both studies are on the AI safety hub):

The worked example

The F: fix it. No target, no context, no way to tell when the job is done. This earns the five rounds it causes.

The A: Fix the checkout bug on cart.js: clicking Pay throws TypeError line 41. Done when the checkout page loads without the error.

Same request. The A version has all four parts in two sentences: goal (fix the checkout bug on cart.js), context (clicking Pay throws TypeError line 41), and a done check you can run. A one-shot prompt does not need to be long. It needs to be complete.

Verify before you send

The last habit: grade the prompt, not just the answer. In the Cronus composer, the button grades your draft A to F against exactly this anatomy: clarity, context, output spec, structure, examples, constraints. Each grade tells you which part is missing in plain words.

Fix it for me then writes the A-standard rewrite, and you choose: use it, or keep yours. It never replaces your words on its own. The composer guide shows the whole flow on screen.

The checklist, to keep

← Guide 13: The composer All guides →