Evaluation, Testing & Optimization·Task 4.1·Bloom: understand·Difficulty 2/5·8 min read·Updated 2026-07-14

Evals as Pre-Build Acceptance Criteria

Define evaluation metrics (accuracy, latency, cost, safety, security)

SUBy Solomon UdohReviewed by Solomon UdohAI-assisted · human-reviewed
In short
Evals as acceptance criteria means the evaluation suite is defined at the start of the build, before production code is written, so success is stated in measurable terms up front. Writing evals first forces the team to name what good looks like, exposes design assumptions while they are still cheap to change, and creates the gate that every later model swap, prompt revision, or retrieval change must pass. If a behavior cannot be expressed as an eval, there is no reliable way to verify it changed.

The order of operations decides whether evals help

The instinctive way to build a system is to write the code, look at the output, decide it seems right, and add some tests later if there is time. The Claude Certified Architect - Professional (CCAR-P) exam treats that order as a mistake. An eval suite is only fully useful when it exists before the production code, because its real job is not to grade a finished system but to define what "finished" means in the first place.

Putting evals first is an understand-level skill: you need to grasp why the timing changes what the eval can do for you, not just that it should happen early. Written first, the eval suite is a specification. Written last, it is a rubber stamp on whatever the system already happens to do.

Evals as acceptance criteria
The practice of defining the evaluation suite at the start of the build, before production code, so that success is stated in measurable terms up front and every later change to the system, model swaps, prompt revisions, retrieval changes, must pass the suite before it ships. The eval suite functions as both the specification and the gate.

Three things writing evals first forces

Defining evals before code forces three things that are otherwise easy to defer indefinitely.

First, it forces the team to state success in measurable terms. "The assistant should summarize well" is not something you can build against or verify. Turning it into an eval forces the harder question of what a good summary actually contains and how you would check it, and that question is far cheaper to answer before implementation than after.

Second, it exposes design assumptions early, while changing them is still cheap. The act of writing checks surfaces the places where the requirement is ambiguous or the architecture is making a bet. Discovering that bet on day one costs a conversation; discovering it after the system is built costs a rebuild.

Third, it gives you a gate that can tell whether any later change actually improved the system. Without a suite defined in advance, a prompt tweak or a model swap is a guess: it might be better, it might be worse, and there is no instrument to say which.

The gate that every change must pass

Once the suite exists, it becomes the checkpoint for every subsequent change to the production system. Swap the model to a cheaper tier? Run the suite. Revise the system prompt? Run the suite. Change the retrieval configuration? Run the suite. This is the only reliable way to know whether a change moved the system forward or quietly broke something, because an LLM system rarely announces a regression, it just starts producing subtly worse output on inputs nobody re-checked.

The deeper principle is that verifiability is a property you have to design in. If a behavior cannot be written as an eval, then every change you make to the system is unverifiable with respect to that behavior. You are flying on the assumption that it still works, and assumptions are exactly what production erodes.

before code
when the eval suite is defined
the gate
every model or prompt change must pass it
not spot-checks
manual checks only cover inputs you tried

What the exam trips candidates on

The first trap is building the system first and writing evals afterward as a QA formality. A scenario will present a team that shipped, then added evals to document what the system does. The credited reading recognizes that an eval written to match existing behaviour cannot catch the design flaws an eval written first would have exposed, and it cannot serve as an honest gate because it was fitted to the answer.

The second trap is trusting manual spot-checks. A scenario will show a team that tried the system on a handful of familiar inputs, saw it respond correctly, and declared it validated. Spot-checks only confirm behaviour on the inputs already tried; they say nothing about the inputs nobody thought of, which is precisely where production surfaces failures. Recognizing spot-checks as an anecdote rather than a suite is the point.

Worked example

A team built a contract-review assistant, tested it live against a few contracts they knew well, and declared it ready. A reviewer objects that there is no eval suite. The team offers to write one now, matching what the deployed system currently produces. Why is that not the same as evals-first, and what should they do?

Writing the eval suite now, fitted to what the system already produces, gives up most of the value of an eval suite. An eval written to match current output cannot expose a design assumption, because it was built from the design's output rather than from an independent statement of what good looks like. It also cannot honestly gate the current system, since it was calibrated to pass it by construction. The suite becomes a description of the status quo, not a specification.

What the team actually did was rely on manual spot-checks. Trying a few well-known contracts confirms the system handles those specific contracts, but it says nothing about the contract classes nobody tested, unusual clause structures, non-standard layouts, the long tail. That untested distribution is where the regression will come from.

The correct move is to define the acceptance criteria independently: state, from the business requirement, what a correct review is, build a representative golden dataset that includes the awkward contract classes, set thresholds derived from the requirement rather than from current output, and only then judge the deployed system against that suite. Some of it now looks like closing the barn door late, but doing it properly still beats enshrining current behaviour as the definition of correct. Going forward, every prompt or model change runs through that suite as a gate.

Common misreadings to avoid

Misconception

Evals are a QA step, so they belong at the end of the build once there is a system to test.

What's actually true

Written last, evals can only confirm the system already does what it does. Written first, they define success, expose assumptions while they are cheap to change, and become the gate for every later change. The timing is what gives them their value.

Misconception

If the system passes a set of manual spot-checks on real inputs, it is validated.

What's actually true

Spot-checks confirm behavior only on the specific inputs tried. They cannot certify behavior on the inputs nobody thought to test, which is where production failures appear. A representative eval suite is what validation requires.

How this shows up on the exam

Domain 4 questions on this knowledge point describe a team that either wrote evals too late or leaned on spot-checks, then hit a regression. The dependable reading is that the eval suite belongs at the start of the build as the acceptance criteria and the gate, and that manual checks are not a substitute for a representative suite.

This builds directly on the five evaluation dimensions, which are the axes the acceptance criteria are written against, and it leads into translating a business requirement into a measurable threshold, which is the mechanics of writing the criteria. It also underpins the five-stage eval workflow and pairs with diagnosing a stale eval suite, the failure that appears when a suite defined early is never kept current.

Check your understanding

A team is about to start building a Claude summarization feature. When should they define the eval suite, and why?

People also ask

When should you write the eval suite for a Claude system?
At the start of the build, before production code, so it defines success in measurable terms and gates every later change rather than serving as an end-of-project formality.
Why write evals before production code?
It forces a measurable definition of success, exposes design assumptions while they are cheap to change, and creates the gate for every model swap or prompt revision.
Are manual spot-checks a substitute for an eval suite?
No. Spot-checks confirm behavior only on the inputs tried and cannot certify behavior on untested inputs, which is where production failures occur.

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