Skip to module content
Module 06 ยท ~14 min

Basic Evals for Your Own Workflows

"Seems good" is not a metric. Ten golden examples are.

Reading progress
0/5 ยท 0%

The big idea

๐Ÿ’กKey idea
Quality drifts silently as prompts, models, and inputs change, and "it seems fine" catches none of that drift. A golden set of ten real inputs with known-good outputs, scored against a simple binary rubric, turns quality from a vibe into a number you can track, defend, and improve.
Quick check
1 question ยท instant feedback
0/1
  1. Evals exist because:

Deep dive

7/7 open

AI-powered workflows don't stay static โ€” prompts get tweaked, the underlying model gets updated, and the kinds of inputs you feed it shift over time. Any one of these can quietly degrade quality without triggering an obvious alarm, because a subjective "it seems fine" impression doesn't reliably catch small, gradual regressions.

Evals exist to replace that vague impression with a number. Without one, you're flying blind โ€” you might not notice a workflow has gotten worse until a client complains, by which point you have no idea which change caused it or how long it's been broken.

A golden set is simply 10 real inputs โ€” not synthetic, not hypothetical โ€” paired with the output you already know is correct or acceptable for each. These become your fixed benchmark: any time you want to know if a workflow still works, you run it against the same 10 inputs and compare.

Building the golden set is itself valuable work, because it forces you to define, concretely, what "correct" looks like for your workflow โ€” something many people have never actually written down, relying instead on an unexamined gut sense.

A useful rubric has 3 to 6 checks, each answerable with a clear yes or no by someone who wasn't involved in building the workflow. "Correct category assigned?" and "draft tone acceptable?" are checkable; "is this good?" is not, because two people could disagree without a shared standard.

Keep the rubric short on purpose โ€” a 20-item checklist becomes tedious to apply consistently and each additional vague item adds noise rather than signal. Three to six sharp, binary checks beat twenty fuzzy ones.

You don't need special tooling to start. A spreadsheet with one row per golden example and one column per rubric check, filled in by hand as you review each output, is a completely legitimate first version of an eval system. Total the checks passed and you have a score out of however many total checks exist.

The manual version also forces you to actually look at every output closely at least once, which itself often surfaces problems you wouldn't have noticed from a passive skim. Don't let the absence of fancy tooling be an excuse to skip evals entirely โ€” the spreadsheet is the whole point at this stage.

Once you're running evals repeatedly, having an AI apply your rubric to each output can save real time โ€” feed it the rubric, the golden example, and the actual output, and ask it to score each check as pass or fail with a one-line reason. This scales the process well beyond what manual grading can sustain.

The catch: an AI grader can itself be wrong or inconsistent, so periodically spot-check a sample of its grades against your own judgment. If the grader and your judgment disagree often, tighten the rubric's wording rather than trusting either blindly โ€” ambiguous rubric language causes both human and AI graders to disagree with themselves over time.

Evals only pay off if you actually look at them regularly. A short, recurring 15-minute review โ€” checking the current score, noting any specific failures, and picking exactly one fix to make before the next review โ€” keeps quality trending upward instead of drifting down unnoticed.

The discipline of "one fix per week" matters as much as the review itself: trying to fix everything at once makes it hard to tell which change actually helped, while one fix at a time lets you attribute improvement (or regression) directly to a specific, known change.

Run your golden set before and after any prompt change, before and after a model switch, and whenever you start feeding the workflow a genuinely new type of input it hasn't seen before. This turns every change into a measured decision rather than a hopeful guess.

A model-switch decision is a good example of evals removing anxiety: run the same golden set on the current model and a candidate model. If both score 9 out of 10 but the candidate is cheaper or faster, you switch with evidence in hand instead of worrying whether quality will silently suffer.

Quick check
1 question ยท instant feedback
0/1
  1. A golden set is:

Pitfalls & takeaways

Failure modes

  • Relying on "it seems good" instead of measuring against a golden set
  • Building a golden set entirely out of easy cases that always score perfectly and teach nothing
  • Skipping evals before a prompt change, model switch, or new input type โ€” and being surprised later
  • Writing rubric checks that are vague or require special expertise a stranger wouldn't have
  • Trusting an AI grader without ever spot-checking a sample of its grades

Durable takeaways

  • A golden set of 10 real inputs with known-good outputs turns 'seems good' into a measurable, trackable score
  • Rubric checks must be binary and applicable by a stranger โ€” vague criteria produce unmeasurable results
  • The most valuable golden examples are historical edge cases and past failures, not easy softballs
Quick check
1 question ยท instant feedback
0/1
  1. Rubric checks should be:

Do the work

๐Ÿ‹๏ธProve you learned it

Build a golden set of 10 real inputs for your most-used AI workflow, including at least a few historical edge cases that broke things before. Write a rubric of up to 6 binary pass/fail checks. Score today's baseline output in a spreadsheet, and put a recurring 15-minute weekly review on your calendar to re-score and track drift.

0 chars
Quick check
1 question ยท instant feedback
0/1
  1. The most valuable golden examples are:

Sources

  • ยท OpenAI Cookbook (cookbook.openai.com โ€” evals)
  • ยท Anthropic docs (docs.claude.com โ€” evaluating outputs)
  • ยท Latent Space (latent.space) practitioner episodes on evals