Part 4 · Engineering Patterns for Reliable Agents

Build Your First Eval Set

Before/after score demo; three tasks: collect ten real cases, write pass criteria and run a baseline, let the numbers talk

THE QUESTION THIS PAGE ANSWERS

ANSWER FIRST

What is the key idea behind “Build Your First Eval Set”?

Before/after score demo; three tasks: collect ten real cases, write pass criteria and run a baseline, let the numbers talk

DECISION RULE

Follow the handoffs, not the demo. A system becomes dependable at the boundaries between model, tools, state, permissions, and people. Read each handoff as a place where you can observe, test, and recover.

TRY NEXT

Name the input, owner, approval, and recovery action for one automated step.

WATCH FOR

A successful run that cannot explain what happened or be safely repeated.

Hands-on track, fourth square: it can work now — make every change evidence-based.
M0
Know what you want it to do for you
M1
Talks like a human, reliably
M2
Actually gets work done
M3
Better or worse, measurably
M4
Runs long without losing memory
M5
The process is reproducible
See it first · One change, five cases, five different fates

An eval set isn’t mysterious. It’s a pile of fixed inputs, each with a “what counts as pass” criterion. The magic is the moment you score: what you thought was an across-the-board win is often three up, two down. Without an eval set, those two drops stay invisible forever.

Same cases, before and after a prompt change

#1
Regular weekly report, three-part structure correct
Pass
#2
Monthly report with numbers, all numbers correct
Pass
#3
Extra-long doc, missed a key conclusion in the second half
Fail
#4
Short doc, normal summary
Pass
#5
Missing info, made up a number
Fail
3 / 5 cases passed
Baseline of the first prompt: 3 / 5. Long-doc and missing-info cases failed. Remember this number — it’s the reference for every later change.

Three eval pitfalls this chapter already covered

First, quietly editing cases while you score. Change a case and the before/after scores aren’t comparable. Adding cases is fine; changing cases means re-running the full baseline.

Second, looking only at the total. Is 4/5 better than 3/5? First check whether the failing case used to pass.

Third, writing the criterion as “high-quality answer”. That can’t be judged. Write “includes next week’s plan” or “numbers match the source” — sentences you can decide at a glance. Only when you can’t judge that way does LLM-as-Judge come in.

Hands-on checklist · Pick one, start it, tick it off

This Chapter's Hands-on Checklist

0 / 3 done

Collect 10 real cases

15 min Everyone

Pick 10 inputs you’ve actually used and save them in a file, one per line. The mix matters: seven everyday, three nasty. Pull the nasty ones from the M1 five-run streak and the M2 stuck records — the inputs that already crashed it are the most valuable.

What counts as done
The file exists, all 10 are real inputs (not ones you just made up), and at least 2 are ones that already crashed it.

Write a pass criterion for each, run a baseline

1 hour If you want changes to be evidence-based

Each case gets one “what counts as pass,” written so you can decide at a glance: “output is exactly three sections,” “the conclusion includes XX,” “no numbers invented beyond the source.” Then run all 10 and write down the first baseline score.

What counts as done
Anyone with your criteria and the output would judge the same as you. Baseline is recorded, e.g. 6 / 10.

Change one prompt version, let the score talk

Half a day If you want to keep iterating

Change the prompt against the failing cases. Don’t touch a single case. Re-run the full set and compare. Watch two things: how much the total moved, and whether any case that used to pass now fails. A regression isn’t shameful — write down which case and why. You’re already doing the real engineering Anthropic talks about.

What counts as done
You can say a sentence like: “This change moved the score from 6/10 to 8/10, at the cost of #4 going from pass to fail, because the new rule is too conservative.” If you can say that, M3 is standing.

Log the baseline in the Build Log

For M3, record: where the eval set lives, what the baseline is, and what the first comparison run concluded. From this square on, when you say “it got better,” you have a number in hand.

Fill in M3

How “See it first · One change, five cases, five different fates” becomes executable

“An eval set isn’t mysterious.” is not about a magic phrase. It is about giving the model enough information to know who the work is for, what must be done, and what counts as acceptable.

Background sets direction; constraints set the boundary

“First, quietly editing cases while you score .” shows why a useful request separates the task, audience, source material, output format, and constraints. Without background, the model guesses. Without acceptance criteria, fluent text is not evidence that the task is complete.

More words do not guarantee a better result

Turn “For M3, record: where the eval set lives, what the baseline is, and what the first comparison run concluded.” into a small experiment: change only one of background, requirements, or constraints while keeping the rest fixed, then observe which layer actually changes the output.

From “See it first · One change, five cases, five different fates” to “Hands-on checklist · Pick one, start it, tick it off”

“See it first · One change, five cases, five different fates” grounds the problem in “An eval set isn’t mysterious. It’s a pile of fixed inputs, each with a “what counts as pass” criterion . The magic is the moment you score: what you thought was an across-the-board win is often three up, two do…”. “Hands-on checklist · Pick one, start it, tick it off” then moves it toward “Pick 10 inputs you’ve actually used and save them in a file, one per line. The mix matters: seven everyday, three nasty . Pull the nasty ones from the M1 five-run streak and the M2 stuck records — the inputs th…”. Together, they show that the lesson is not just a conclusion to remember, but a claim with conditions.

Carry the judgment into the next situation

Build a request layer by layer: task and audience first, material and output rules next, constraints and acceptance checks last. Change one layer at a time so you know what actually helped.

  • “See it first · One change, five cases, five different fates”: An eval set isn’t mysterious. It’s a pile of fixed inputs, each with a “what counts as pass” criterion . The magic is the moment you score: what you thought was an across-the-board win is often three up, two do…
  • “Hands-on checklist · Pick one, start it, tick it off”: Pick 10 inputs you’ve actually used and save them in a file, one per line. The mix matters: seven everyday, three nasty . Pull the nasty ones from the M1 five-run streak and the M2 stuck records — the inputs th…
  • “The closing point”: For M3, record: where the eval set lives, what the baseline is, and what the first comparison run concluded. From this square on, when you say “it got better,” you have a number in hand

The final “The closing point” brings the discussion to “For M3, record: where the eval set lives, what the baseline is, and what the first comparison run concluded. From this square on, when you say “it got better,” you have a number in hand”. The useful thing to carry forward is knowing which judgments must be revisited when input, scale, or risk changes.

Mark as learned Your reading progress updates automatically
← PreviousNext →

Keep reading

The next useful article in the thread.

ARTICLE DISCUSSION

Leave one useful thought here.

Keep the idea that clicked, the question that stayed open, or a small note for the next learner.

Discussing Build Your First Eval Set Engineering Patterns for Reliable Agents
3discussionsArticle discussion · synced with the Circle
View in the learning circle
AM
Asha MorganContent editor
INSIGHTField note

I turned one judgment from this article into a small experiment I could run today. Knowing what to observe next is more useful than simply remembering the conclusion.

ARTICLE DISCUSSION7 helpful
LH
Lin HarperIndie developer
INSIGHTInsight

After reading this, I first looked for the conditions behind the idea instead of copying the method into a project. That order made the later trade-offs much clearer.

ARTICLE DISCUSSION5 helpful
KM
Kiki MooreProduct operations
QUESTIONQuestion

When this judgment reaches real work, which constraint should be added first? I am curious which step matters most between reading and the first practical attempt.

ARTICLE DISCUSSION4 helpful