Evaluating Model Performance on Realistic Test Sets
Lead with the bad news directly, because the customer needs the headline before any context.
Why the Headline Comes First
Most people who have worked on a project have faced the moment when a target was missed and someone has to explain why. The natural impulse is to soften the message, lead with what went well, and hope the listener reaches the problem on their own. This lesson takes a different approach. State the problem plainly, take specific responsibility for it, explain what caused it, and then show a route forward that keeps the customer's exposure under control.
The reason this matters is that the customer already knows something is wrong. A delivery that is behind its target is visible to them, so the question is not whether they will learn the bad news but how they will hear it. When the headline is buried under background, the customer spends the first part of the conversation waiting for the point, and every sentence of context starts to sound like an excuse. When the headline comes first, the customer can stop guessing and start evaluating the team's response.
What the Customer Is Really Asking
The setting for this skill is usually a project or product development relationship. A vendor has committed to a result, and the customer is relying on it. When the result falls short, the customer is no longer only asking whether the work is good. They are asking two harder questions: does the vendor understand the problem well enough to fix it, and will the vendor be honest about its own part in it?
A delivery that is structured well answers both questions within the first minute. That is the design goal behind every move in a strong response. The headline shows the vendor is not hiding the gap. The specific ownership shows the vendor knows its own part. The cause shows the vendor understands the problem. The plan shows the vendor can limit what happens next.
Diagnosing the Failure Before Explaining It
Before a team can explain a failure, it has to know what kind of failure it is. A model that performs poorly on some kinds of input and well on others is not necessarily a bad model. The first question is whether the test used to judge it fairly represents the work the model will actually face. An evaluation set is the collection of cases used for that judgment. If its mix of cases does not match the real mix, the measured pass rate can mislead everyone, including the team that built the model.
The concrete technique for checking this is stratifying the evaluation set against the case-class distribution. You start from the real distribution of incoming cases. Then you make sure the evaluation set samples each class in proportion to that distribution, so the score it produces is a fair summary of how the system will behave in practice.
When a team says that a problem is in the labels or in the test set rather than in the model, it is making a claim about this calibration. The claim can be checked against the real distribution, and that is part of why it is useful to bring to a customer. It turns a vague feeling that the test was off into a specific statement that someone can verify. A diagnosis like this should be backed by evidence, not asserted.
Checking a stratified evaluation set for scanned invoices
Illustrative numbers only. Suppose a document routing system receives incoming documents, and 20 percent of them are scanned invoices. The team's evaluation set has 100 cases, and only 2 of them are scanned invoices. Does the evaluation set match the real distribution for this class, and what should it contain instead?
- 1Find the real share of the class
Scanned invoices make up 20 percent of incoming documents, so that is the target proportion for the evaluation set.
- 2Compare against the evaluation set
The evaluation set has 2 scanned invoices out of 100 cases, which is 2 percent. That is far below the real 20 percent, so the set does not represent this class in proportion.
- 3Compute the proportional count
To sample the class in proportion in a 100-case set, about 20 cases should be scanned invoices. The set is underrepresenting the class by roughly 18 cases.
- 4Interpret the pass rate
A high overall pass rate on this set can hide poor performance on scanned invoices, because those cases carry very little weight in the score.
The evaluation set is miscalibrated for scanned invoices. The team can state this as a checkable claim: the test set underrepresents the class, so its overall score does not reflect performance on that class.
The Order of Moves in a Strong Response
A strong response to a setback tends to follow a recognizable order, and the order matters because each move sets up the next. The customer hears the headline before the details, hears the ownership before the explanation of cause, and hears the cause before the plan. Reversing the order usually makes the explanation sound like a defense.
- Headline: the customer is not surprised later, because the gap is named before anything else is said.
- Ownership: must be specific. A general apology does not tell the customer what went wrong.
- Cause: named concretely enough that the customer can see it is real.
- Evidence that the cause is already being addressed: shows the problem is under management.
- Path forward: should protect the customer from further loss rather than asking them to absorb more risk.
Burying the Headline Versus Leading With It
Compare two versions of the same delivery conversation. In the first, the team opens with background, then mentions the delay, then explains the cause. In the second, the team states the delay first, then moves through the same background. The facts are identical. The customer's experience is not.
In the buried version, every sentence of background sounds like a defense, because the listener does not yet know what the background is explaining. In the leading version, the same background reads as the reason for a gap the customer already knows about. The bad news does not change. What changes is whether the listener feels informed or managed.
The Case of the Behind-Schedule Delivery
The following case comes from an interview-style exchange. A candidate is asked about a delivery that is behind its target, and the customer has already noticed the gap. The response below is paraphrased from the source and broken into its moves so you can see how each one does its job.
- 1Headline: the response states that the agreed result has not been met, without first pointing to progress elsewhere.
- 2Ownership: the response names the exact error in the evaluation process rather than admitting that mistakes occurred in general.
- 3Cause: the response explains that the evaluation set did not match the real distribution of case classes, and says this is checkable against that distribution.
- 4Evidence: the response reports a measured result on re-labeled cases, showing the cause is already being addressed.
- 5Path: the response defines the success test and the outcome if the fix fails, so the customer's downside is fixed and known.
Notice what this response does not do. It does not ask the customer to trust the team's intentions. It gives a checkable claim about the evaluation set, a measured result, and a structure in which failure has a bounded and known cost. Those features are what make the response credible.
Specific Ownership Versus Hedged Ownership
The source is direct about ownership: take specific responsibility by naming the exact error, not making a general admission that mistakes occurred. The difference shows up most clearly when two versions of the same admission sit side by side. Both examples below are illustrative and were written for this lesson, built around the same situation.
| Feature | Specific ownership | Hedged or vague ownership |
|---|---|---|
| Example sentence | We did not test scanned invoices, so the acceptance test passed while those cases were failing. | Some mistakes may have occurred in certain areas, and we are looking at whether testing could have been more thorough. |
| Names the error | Yes: scanned invoices were absent from the test set | No: refers to unnamed areas and possible mistakes |
| Ties to the result | Connects the error directly to the pass rate that misled the team | Leaves the link to the result unstated |
| Verifiable | The customer can check the test set composition | Nothing concrete to check |
| Effect on trust | Shows the vendor understands its own part | Sounds like the vendor is avoiding a commitment |
Two admissions about the same gap. Both contain some truth, but only one can be checked.
Why a Weak Response Can Still Be True
A weaker response to a delivery setback can still contain true information. The problem is in how that information is arranged and how much responsibility it accepts. Each sentence may be defensible on its own, yet the whole reads as hedging.
What do you think happens?
Consider a short weak response that does three things: it points to progress, mentions a possible calibration issue as a passing thought, and ends with a time estimate. Which of these moves comes first in the weak response, and what is the problem with that placement?
Reveal answer
The weak response opens by pointing to progress, so the headline is delayed. The calibration issue is mentioned only as a passing thought, so the cause is not owned, and the time estimate comes last, so no path forward is defined.
The source describes this weak response as opening with progress, mentioning the calibration issue in passing, and ending with a time estimate. Each sentence is defensible, but the arrangement and the lack of ownership make the whole read as hedging.
Common mistake Opening with what went well
What it looks likeWe have made good progress on several parts of the system before we reach the target.
Why it failsThe customer already knows the target was missed, so progress offered first reads as a way to delay the headline.
Do this insteadState the gap plainly first, then mention progress in context after the ownership and cause.
Common mistake Admitting mistakes in general terms
What it looks likeMistakes may have occurred, and we take that seriously.
Why it failsA general admission does not tell the customer what went wrong, so it cannot be checked or acted on.
Do this insteadName the exact error, such as a test set that lacked a class of cases the real work includes.
Common mistake Mentioning the cause as a passing thought
What it looks likeIt could possibly be a calibration issue, but we will see.
Why it failsA cause that is not stated concretely cannot be verified, so it does not give the customer a reason to believe the team understands the problem.
Do this insteadState the cause concretely and back it with a check against the real distribution of cases.
Common mistake Ending with a time estimate and no success test
What it looks likeWe expect to have this resolved in a few weeks.
Why it failsThe customer is left without a definition of success or a statement of what happens if the fix fails.
Do this insteadDefine the success test and the outcome of failure, so the customer's downside stays fixed.
Common mistake Treating a true sentence as a complete answer when the order of the sentences is wrong
Structuring a Response to a Document Routing Failure
Use the scenario below, which was written for practice. A team building a document routing system has found that its acceptance test passed most document types but failed on scanned invoices, because the test set contained very few scanned samples. Work through how you would structure the response to the customer.
Write the response as a sequence of five moves: headline, ownership, cause, evidence that the cause is being addressed, and path forward. For each move, write one or two sentences. Make the ownership move name the exact error, and make the cause move state a claim the customer could check against the real distribution of incoming documents.
Hints
- Start with the headline. What did not happen, stated plainly?
- For ownership, name the test set gap itself rather than saying mistakes occurred.
- For the cause, connect the very few scanned samples to the proportion of scanned invoices in real incoming documents.
- For the path forward, state what success on scanned invoices would look like and what the team will do if the fix does not meet it.
Key Takeaways
- Lead with the bad news directly. The customer needs the headline before any context, and a delayed headline makes the explanation sound like a defense.
- Specific ownership names the exact error and can be checked. A general or hedged admission gives the customer nothing concrete to verify.
- The moves in a strong response depend on each other: headline, ownership, cause, evidence the cause is being addressed, then a path that bounds the customer's risk.
- Checking whether an evaluation set matches the real distribution of case classes, through stratification, turns a claim about the test set into something that can be verified.
- A response can be made of true sentences and still fail if the order is wrong or the responsibility is hedged.