Skip to content
bits
Prompting that works · Lesson 2 of 10

Say why

Tutor:

A rule tells Claude what to do. A reason tells it why, and the why is what lets it make good calls you didn't spell out.

Anthropic's guidance puts it simply: explain the motivation behind an instruction and Claude can generalise from it. A bare rule gets followed to the letter. A rule with its reason gets followed in spirit too.

Tutor:

Say you send appointment reminders by text. Compare a rule with a reason.

Rule only: “Keep it short.” Short compared to what? An essay? A tweet? Claude picks a length that seems short to it.

Rule plus reason: “It goes out as a single SMS, so it must fit in 160 characters, and most people read it on their lock screen, so put the day and time first.” Now Claude knows the real limit, and it knows what matters most in the first few words.

Rule only vs Rule plus reasonillustrative: made-up numbers that show the idea, not output from a real modelcompare

promptTurn this into a text reminder: Dentist, Tue 3pm, Dr Ali, Bright Smile Clinic, bring your insurance card.

Rule only

Hi there! Just a friendly reminder that you have an upcoming dental appointment with Dr Ali at Bright Smile Clinic on Tuesday at 3pm. Please remember to bring your insurance card with you. We look forward to seeing you!

Rule plus reason

Tue 3pm: dentist with Dr Ali, Bright Smile Clinic. Please bring your insurance card. Reply C to cancel.

Tutor:

Look at what the reason bought. The day and time lead, because of the lock screen. The greeting is gone, because every character counts. Neither of those was a rule in the prompt.

Tutor:

Good context answers a few quick questions. Who will read the output? What is it for, and what happens to it next? Why does each constraint exist? You don't need all of them every time. Add the ones a new colleague would ask about.

One more benefit: a reason makes your prompt easier to fix later. When a reply goes wrong, you can see which reason Claude misread, instead of staring at a list of rules that don't say what they're for.

Your turn. Write the prompt for the dentist reminder above. Say what it's for (a text message) and give a reason for at least one constraint.

Your turn

Run your prompt and the replies land here.

    • Includes the appointment, not yet
    • Says what it's for, not yet
    • Gives a reason, not yet
    • Ran at 1.0, not yet
    run at
    ~0 tokens

    Turn on JavaScript to run prompts.

    Tutor:

    Try deleting your reason and running it again. Does the reply still put the time first?