Track 05 · EvalsLesson 01 of 10
From requirements to eval criteria
Turn what the customer asked for into checks a test can pass or fail.
- The FDE path · Stage 5 of 6
- 40 min read
- 60 min hands-on
- Pro
What you'll be able to do
01- Explain why "it feels wrong sometimes" cannot be evaluated, and apply the requirement ladder to turn it into measurable criteria.
- Choose a grader type (code, model or human) for each criterion and justify it on reliability, nuance and cost.
- Decompose a use case into testable behaviours across the quality dimensions, including "must never" behaviours that become hard gates.
- Set thresholds relative to a measured human baseline and the cost of each error type, and say how much evidence a threshold needs.
- Implement an eval spec that maps criteria to deterministic checkers and produces a scorecard with a release verdict.
- Defend the eval spec as a shared, versioned customer artefact in front of a sponsor and a model-risk reviewer.
Before you start
- System prompts that survive a regulated rollout: scope, tone and refusal behaviour are the source of many criteria.
- Typed output: schemas, validation and tool calls: structured fields are what make criteria checkable by code.
- Answers with receipts: grounding and citations: the output contract behind faithfulness criteria.
- Finding the real requirement and Baselines and ROI you can defend: taught in Week 10, applied here. Skim them now if you have never run a discovery session.
The short version
An eval is only as good as the definition of "good" behind it. Customers state requirements as outcomes and feelings ("resolve disputes right first time", "it feels wrong sometimes"). You turn each one into observable behaviours, each behaviour into a binary criterion that can be graded case by case, and each criterion into a measurement with a grader, a threshold, a severity and an owner. Prefer code checks, use model judges where judgement is needed, and use humans where stakes or ambiguity demand it and to calibrate the judges. Set thresholds against the measured human baseline and the cost of each kind of error, not against round numbers. Write the spec before you build or change anything, version it, and get the customer to sign it. That signed spec is what turns a pilot review from an argument about anecdotes into a decision about numbers.
- A criterion must be observable, gradable per case and traceable to a requirement. If it fails any of the three, it is not a criterion yet.
- Push each criterion down the grader ladder: code if possible, a calibrated model if not, humans for calibration and the highest-stakes calls.
- "Must never" requirements are hard gates, and a zero in the eval does not prove a zero in production.
- Thresholds come from baselines, business cases and risk appetite, reported with the uncertainty the sample size allows.
- The eval spec is a customer artefact. Engineering maintains it; the business signs it.
Pro lesson
The rest of this lesson is in Pro.
The mental model, worked example, field note, failure table, exercise and self-check, with the voice tutor.
Pro opens this stage
Stage 5 · Prove it and pass review- 7 lessons, with the voice tutor
- Lab · Clean a golden set before you trust it, graded here
- Halden week 4 · First slice due
- Halden week 6 · Instructions hidden in an invoice
- The lab kit, to run Halden weeks on your machine
Also in Pro
- Every stage and specialisation, in full
- Every lab and every role project
- Halden weeks 2–10, on your record
- Every drill, live in the playground
- All solutions, plus the server judge
- Lab Assistant and every Teach with AI