Evaluation, Testing & Optimization·Task 4.2·Bloom: apply·Difficulty 3/5·9 min read·Updated 2026-07-14

The Five-Stage Eval Workflow

Design evaluation datasets and test frameworks using mixed methodologies

SUBy Solomon UdohReviewed by Solomon UdohAI-assisted · human-reviewed
In short
The five-stage eval workflow runs sequentially: define the task in specific measurable terms, build a golden dataset with labelled expected outputs, run automated code-based checks, score interpretive behaviours with a judge, then interpret and act on the results. Each stage produces an artifact that feeds the next, from a task specification through to an overall score with a per-category breakdown. A golden dataset must include labelled expected outputs, not just raw inputs, and a change that raises the mean while degrading edge-case performance does not make the system better.

Five stages, each feeding the next

An eval is not a single action; it is a pipeline, and the stages have to run in order because each one produces the artifact the next one needs. Skip a stage or run them out of sequence and the workflow produces a number that does not map to anything. The apply-level skill this knowledge point tests is running the workflow end to end, knowing what each stage takes in, what it hands off, and where the workflow quietly breaks if a stage is shortchanged.

The five-stage eval workflow
A sequential pipeline: (1) define the task in specific, measurable terms with a test prompt and pass criteria; (2) build a golden dataset of inputs with labelled expected outputs, including edge cases; (3) run automated code-based checks for unambiguous behaviours; (4) score interpretive behaviours with a judge; (5) interpret and act on the overall score and its per-category breakdown. Each stage's output is the next stage's input.

Stage 1 and 2: define the task, then build the dataset

Stage one defines the task. You state the behaviour being evaluated in specific, measurable terms, write the prompt you will test it with, and set the pass criteria. A vague task definition produces a vague eval, so the concreteness of both the behavioural specification and the prompt is what makes every later number meaningful. The artifact is a task specification with a test prompt and pass criteria.

Stage two builds the golden dataset. You assemble the inputs the system will face, including edge cases and counterexamples, and, critically, label each with its expected output. The order matters: the dataset is built to match the task defined in stage one, not before it, because the task specification tells you what inputs and expected outputs are relevant. The artifact is a labelled dataset. Skip the labels and the dataset is just raw inputs with nothing to grade against.

Stage 3 and 4: automated checks, then judge scoring

Stage three runs the automated code-based checks. Each prompt goes through the system and its output is compared against the expected output for the unambiguous behaviours, format compliance, schema validation, exact-match lookups. These are fast and cheap, so they run across the whole dataset. The artifact is a pass/fail record per item.

Stage four scores the behaviours that need interpretation with a judge. Tone, reasoning quality, appropriateness of edge-case responses, anything a function cannot assess, goes to a calibrated LLM judge that returns a score and its reasoning per item. Stages three and four are the grading ladder in action: cheap deterministic checks first, judge only where the behaviour demands it. The artifact is a score with reasoning per item.

Stage 5: interpret and act, past the mean

Stage five aggregates everything into an overall score and, just as importantly, a per-category breakdown. The aggregate tells you roughly where the system stands and whether a change moved it; the breakdown tells you where. This distinction is the heart of the stage. A change that raises the mean score while quietly degrading performance on edge-case or adversarial categories has not made the system better, it has traded away the cases that matter for a nicer average. Only the per-category breakdown reveals that trade, which is why reporting the mean alone is a stage-five failure.

5 stages
define, build, check, judge, interpret
labelled outputs
the dataset must have expected outputs, not just inputs
per category
the breakdown, not the mean, reveals edge-case regressions

What the exam trips candidates on

The first trap is building the golden dataset before defining the task and pass criteria. A scenario will show a team that collected a dataset first, then tried to fit a task to it, producing a dataset that does not map to a specific measurable behaviour. The credited reading restores the order: define the task, then build the dataset to match it.

The second trap is reporting only the aggregate mean after a change and concluding the system improved. A scenario will present a change that lifted the mean and ask whether it is an improvement; the correct answer withholds that conclusion until the per-category breakdown is checked for edge-case regressions, because a higher mean can hide a worse system on the categories that matter.

Worked example

A team wants to evaluate a new summarization prompt. They already have a large pile of documents from an unrelated project, so they run the prompt over those, average a judge's scores, see the mean rise from 7.9 to 8.3 versus the old prompt, and prepare to ship. Walk through what the workflow should have looked like.

Two stages were mishandled, at the start and at the end.

At the start, the team skipped the define-the-task stage and reached for a dataset they happened to have. The workflow runs define-then-build for a reason: the task specification, what a good summary is, what fields or points it must contain, what the pass criteria are, is what tells you whether those pile-of-documents inputs and their expected outputs are even relevant. Worse, an "unrelated project" pile likely has no labelled expected outputs for this task, so the judge is scoring against nothing anchored to the actual requirement. The correct order is to define the summarization task and its pass criteria first, then build a golden dataset whose inputs are representative of production summaries and whose expected outputs are labelled.

At the end, the team read only the aggregate mean and concluded improvement. The mean rose, but stage five requires the per-category breakdown. If the dataset had proper failure-mode categories, long multi-clause documents, unusual formats, edge cases, the breakdown might show the new prompt lifted easy summaries while degrading the hard ones, so the higher mean masks a regression exactly where it is costly. The correct interpretation checks each category and only declares improvement if no important category went backwards.

Run properly, the workflow defines the task, builds a representative labelled dataset, runs cheap automated checks plus a calibrated judge, and interprets the result by category, not by a single reassuring average.

Common misreadings to avoid

Misconception

You can build the golden dataset first from whatever inputs you have, then define the task around it.

What's actually true

The workflow runs define-then-build. The task specification and pass criteria determine which inputs and expected outputs are relevant. A dataset assembled first does not map to a specific measurable behaviour and often lacks the labelled expected outputs the later stages need.

Misconception

If a change raises the aggregate mean score, the system improved.

What's actually true

A higher mean can hide degraded edge-case or adversarial categories. Only the per-category breakdown shows whether the change traded away the cases that matter for a better average. Interpret by category, not by the mean alone.

How this shows up on the exam

Domain 4 questions on this knowledge point either scramble the stage order, usually building the dataset before defining the task, or stop at the aggregate mean. The reliable moves are to run the stages in sequence with each artifact feeding the next, insist the dataset carry labelled expected outputs, and always read the per-category breakdown before declaring an improvement.

This workflow operationalizes translating a requirement into a threshold as stage one and stitches together the three eval types via the grading ladder in stages three and four. Its interpret-and-act stage is where a stale eval suite should be caught, its judge stage relies on a calibrated rubric, and it extends to whole conversations in multi-turn eval design.

Check your understanding

A team ran a new prompt over an existing dataset, saw the mean judge score rise, and wants to ship. What two workflow problems most likely undermine this?

People also ask

What are the stages of an eval workflow?
Define the task, build the golden dataset, run automated checks, score with a judge, and interpret and act, run in that order with each stage feeding the next.
Why must a golden dataset include expected outputs?
Checks and judges compare system output against a known-correct expected output; without labelled expected outputs there is nothing to grade against.
Why check the per-category breakdown, not just the mean score?
A change can raise the mean while degrading edge-case categories. Only the breakdown reveals that trade, so the mean alone can hide a regression on the cases that matter.

Watch and learn

Official Anthropic Academy lessons first, then hand-picked walkthroughs. Videos load only when you press play.

No videos curated for this concept yet

We are still curating the best official and community videos for this topic.

Official prep for this domain

Anthropic's own free prep module for this part of the syllabus, on the official prep course. Free with an Anthropic Academy sign-in.

References & primary sources

Adaptive study

Master this concept with Archie

Practice it inside an adaptive study session. Archie, your Socratic AI tutor, tracks your mastery with Bayesian Knowledge Tracing and schedules the perfect next review.

Start studying