Decide how you’ll judge it before you build it

Exit

Lesson 2 · 14 min

Decide how you’ll judge it before you build it

By the end

A test set under way: real examples, what good looks like for each, and the bar your tool must clear.

  1. 1Learn
  2. 2Try it
  3. 3Human check
  4. 4Quick check

Learn · 4 min

Set the bar before you build

Once you’ve built something, it’s hard to judge it fairly. You’ve put in the time, the first few answers look impressive, and it’s tempting to call it done. Deciding what “good” means before you build keeps you honest, and gives you a fair way to compare one version with the next. It also settles arguments: when someone says the tool is great or useless, you can point at the sheet.

The way to do it is a test set: real examples of the task, each with a note on what a good result looks like. People who build AI tools call these evals, short for evaluations. Yours can live in a spreadsheet.

Twenty real examples, not ten perfect ones

Start with 20 real examples from the last month or two, pulled from your sent folder, order history or work orders, not written from memory. Real examples carry the mess that invented ones leave out: missing details, two questions in one, the customer who writes in all caps. Replace names, emails, phone numbers and account numbers (Customer A, Order 1) before any of it goes near an AI tool.

Twenty is a rule of thumb: enough to show patterns, few enough to check by hand. Make about a quarter of them the awkward ones:

  • A request with a key detail missing
  • One that looks routine but isn’t, like an emergency or a complaint
  • Something you don’t offer
  • One where the right answer is “a person should handle this”

Write checks, not perfect answers

For each example, write two or three short checks instead of a model answer. A model answer tempts you to judge on style; checks give a clear pass or fail, and anyone on the team can mark them. If you have the reply you actually sent, keep it alongside for reference.

For a plumbing firm’s quote replies, the checks might be: includes the current service-call fee; asks for the details needed to quote; flags anything that sounds like an emergency for a person to call back.

Then write your red lines: two or three things that must never happen in any example, such as a firm price for a job that needs a site visit, a promise you can’t keep or the wrong customer’s name. One red-line failure matters more than several small misses.

Write the bar down

Decide now what result means “ready to pilot.” A sensible first bar: at least 16 of the 20 pass, and none break a red line. Raise it if mistakes are costly. Write it at the top of the sheet with today’s date, so it can’t quietly slide later.

Hold on to the test set. You’ll rerun all of it after every change, because a fix for one example can break another. And if a vendor ever offers to sell you a tool for this job, it’s the fairest test you can give them.

Try it on your business

10 min

Start your test set with five real examples. The AI drafts the checks and spots the awkward cases you’re missing; you decide what good looks like.

  1. 1

    Start a spreadsheet with these columns: #, Example, What good looks like, Awkward? (yes or no), v1 result, Notes.

  2. 2

    Add five real examples from last month’s work, with names, emails, phone numbers and account numbers replaced (Customer A, Order 1).

  3. 3

    Run the prompt, paste the table into your sheet, then rewrite each check until it matches your standard, not the AI’s.

  4. 4

    Write your red lines and your bar at the top of the sheet with today’s date: how many of the 20 must pass, and that no red line may break.

  5. 5

    Put the list of missing awkward cases on your to-do list, and collect the other 15 examples this week, at least five of them awkward.

I’m building a small AI tool that does one job: [THE TASK, FROM YOUR SCOPE]. Before I build it, I’m writing a test set.

Here are five real past examples, with names and contact details removed, and what we actually sent or did each time: [PASTE THE FIVE EXAMPLES AND WHAT YOU DID].

For each example, draft 2 or 3 short pass/fail checks for a good result: what it must include, and anything it must flag for a person. Then suggest 3 red lines: things that must never happen in any example. Finally, list 5 kinds of awkward case my examples don’t cover yet, so I can go and find real ones. Don’t write model answers or invent facts about my business. Put the checks in a table I can paste into a spreadsheet.

Human check: before you use it

Quick check · question 1 of 2No grades

Why build the test set from real examples instead of writing your own?

Ask the Distillery

Answers come from The Distillery’s own pages, with sources.

If the Distillery doesn’t know, it says so and points you to a person.