Evaluating the Evaluation Pipeline
An evaluation pipeline must be iterated on as user needs and behaviors change, since fixed criteria can stop measuring what matters.
The Fixed Measuring Stick Problem
Many people who build an evaluation for an AI application treat it like a finished product. They write the criteria, design a scoring rubric, choose a handful of examples, and then assume the job is done. The evaluation becomes a fixed measuring stick that never needs recalibration. This is a common and understandable belief, but it breaks down quickly once the application is used by real people.
This lesson follows one idea through the whole pipeline: the evaluation is itself something you must keep checking. You will trace how a change in user behavior moves through the evaluation, why the criteria, rubric, and examples may each need revision, and why revision has to be balanced against the need for consistent results.
Why the Evaluation Has to Change
The reason the evaluation has to change follows directly from what it is for. An evaluation exists to tell you how well your application is doing against the goals that matter. When the people using the application shift what they need, or start interacting with it in new ways, the goals that matter shift too.
The evaluation criteria describe what counts as good behavior. If users start caring about something the criteria never mention, or stop caring about something the criteria still reward, the criteria no longer describe what users care about. The correction is to iterate: adjust the criteria to match the current situation rather than holding on to the criteria you wrote at the start.
Read the loop as a cycle, not a one-time fix. Each pass through it asks the same question: do the current criteria still describe what counts as good for the people using the application today? Whenever the answer is no, the pipeline moves on to revision and then measures again.
The Three Parts That Can Be Revised
Iteration has three concrete levers. Each can be pulled independently, and a single change in user needs may call for several of them at once. The diagram below shows how the three parts sit inside the pipeline. Every part feeds the AI judges, and the judges' scores end up in the results.
Because changes to any of the three parts pass through the judges and show up in the results, a change to one part changes the outputs. This is exactly why changes need to be managed carefully. The three parts are examined one at a time below.
Tracing a Revision Through the Pipeline
A support assistant whose users start asking for brief answers
An evaluation was written for a support assistant. The criteria reward accurate, complete answers. Over several weeks, users begin asking the assistant for quick, short replies, and they complain when answers are long. The team must decide what to revise.
- 1Check the criteria first
The criteria describe what counts as good. They reward completeness but say nothing about length or brevity, so they no longer describe what these users care about. The criteria need an update, such as adding brevity as something that is judged.
- 2Update the rubric to match
A new criterion needs a way to become a score. The rubric is revised so that a reply that answers the question in a few sentences maps to a high brevity score, and a reply padded with unnecessary detail maps to a lower one.
- 3Revise the examples
The judges interpret the criteria through examples. The example set is updated to include short replies that are accurate and helpful, so the judges learn what a good short answer looks like rather than defaulting to rewarding long answers.
- 4Record the change and re-run
Before re-running, the revised criteria, rubric version, and example set are logged. The evaluation is then re-run so the results reflect current user goals.
One shift in user behavior moved through all three levers. The pipeline was revised as a whole, and the new results can be read against the current goals.
Notice that the team did not discard the original accuracy criterion. Iteration adjusts the criteria to match the current situation, and that can mean adding new criteria alongside existing ones. The aim is an evaluation that reflects what users care about now.
Why Consistency Still Matters
Revision alone is not enough. Iteration has to coexist with a reasonable level of consistency. An evaluation that changes constantly cannot reliably guide application development, because the people reading its results cannot tell what caused a difference between rounds.
Consider what a score change can mean. It might come from a change in the application, which is what you want to learn about. It might come from a change in the evaluation itself, such as a new rubric or a different judge configuration. If both happened at once and nothing was recorded, the score change cannot be attributed to either one.
In the left column, the rubric and the scores both changed, so a shift in results cannot be assigned to one cause. In the right column, the rubric and examples were held fixed and only the judge changed, so the difference can be traced to the judge. This is the sense in which a comparison is valid: you know which variable differed, and everything else you could have logged is the same.
Experiment Tracking as a Record
The practical tool for keeping revisions interpretable is experiment tracking. Experiment tracking means logging every variable that could change during an evaluation process. When you compare two rounds of evaluation, the log shows exactly what differed between them. Without a record, you are left guessing whether a difference came from the application, the data, the rubric, or the judge's own configuration.
| Variable | What it records | Why it matters for a reproducible result |
|---|---|---|
| Evaluation data | The examples and inputs used in the run | Changing examples changes how judges interpret the criteria |
| Scoring rubric | The version of the rubric that maps judgments to scores | The same judgment can produce a different score under a different rubric |
| Judge prompt and sampling configuration | The prompt and sampling settings used for the AI judges | Judge settings can shift scores even when everything else is held fixed |
| Judge model | Which model served as the judge | A different judge can produce different scores from identical inputs |
| Scores and date | The results of the run and when it was performed | Lets a result be matched back to the exact inputs that produced it |
Variables to log with each AI judge evaluation run. The source names evaluation data, the rubric, and the prompt and sampling configurations; the judge model, scores, and date are recorded alongside them so each run can be reproduced.
Mistakes in Maintaining an Evaluation
Common mistake Treating the evaluation as a finished product
What it looks likeThe team writes the criteria at launch and never revisits them, even after users begin asking for something the criteria do not mention.
Why it failsThe evaluation exists to measure goals that matter, and those goals shift when users shift what they need.
Do this insteadCheck the criteria whenever user needs or behaviors change, and revise them to match the current situation.
Common mistake Changing the criteria, rubric, and examples all at once without a record
What it looks likeA new rubric, a new example set, and a new judge model are introduced in the same round, and the scores move.
Why it failsA score change can no longer be attributed to the application, because several evaluation variables changed together and were not logged.
Do this insteadLog every variable that changes, and make changes in a way that lets you tell which one caused a difference.
Common mistake Revising the evaluation constantly
Why it failsAn evaluation that keeps shifting cannot serve as a reliable guide for deciding what to improve in the application.
Do this insteadBalance revision against consistency, so that results remain comparable across rounds.
Common mistake Logging only the scores
Why it failsScores alone do not show what produced them, so two rounds with different scores cannot be explained.
Predicting a Revision's Effect
What do you think happens?
Users stop complaining about accuracy and start complaining that answers are too long. Which part of the pipeline should you check first?
Reveal answer
The evaluation criteria, because they define what counts as good behavior.
The criteria describe what users care about. If users now care about brevity and the criteria do not mention it, the criteria are the first thing to revise. The rubric and examples may then need updating to support the revised criteria.
A team's evaluation of a writing assistant was built around one criterion, factual correctness. Their users now ask for a friendlier tone. Describe the revision you would make to each of the three parts: criteria, rubric, and examples. Then list at least three variables you would log before re-running the evaluation.
Hints
- Start with the criteria, since they define what is being judged.
- Think about how a tone judgment would be turned into a score, which is the rubric's job.
- Think about what examples would show the judges a friendly but correct response.
Summary of the Revision Cycle
- 1An evaluation pipeline must be iterated on as user needs and behaviors change, because fixed criteria can stop measuring what matters.
- 2Iteration has three levers: the evaluation criteria, the scoring rubric, and the examples. Each can be changed independently, and one change in user needs may call for several at once.
- 3Revision has to coexist with consistency, since an evaluation that changes constantly cannot reliably guide application development.
- 4Experiment tracking logs every variable that could change, including the evaluation data, the rubric, and the prompt and sampling configurations for the AI judges, so that results can be compared and reproduced.
At a glance
- An evaluation pipeline must be revised as user needs and behaviors change, because criteria that once matched real goals can go stale.
- The three levers of revision are the evaluation criteria, the scoring rubric, and the examples, and they can be changed independently or together.
- Consistency still matters: an evaluation that changes constantly cannot tell you whether a score change came from the application or from the evaluation itself.
- Experiment tracking records every variable that could change, including evaluation data, the rubric, and the judge prompt and sampling configurations, so each result can be explained and reproduced.