Skip to content
evals reliability governance

Write the evals before the prompt

An eval suite isn't QA you add at the end. It's the specification — and the only thing that lets a CXO answer 'is it working?' with a number instead of an opinion.

AtomsAI editorial 2 min read

Written by

Daniel Okafor Engineering lead, evals and reliability

Builds the labelled set before the prompt, and keeps a cost ceiling in CI on every workflow we hand over.

Illustrative author profile. Attribution and biography are fictional.

Most teams build the thing, then try to measure it. That order is why so many systems get quietly switched off.

The labelled set is the spec

An eval suite written first is a specification. Before we ingest a document or write a prompt, we sit with practitioners and collect the real inputs: the top 200 questions a support team gets asked, the last 600 exceptions from an AP mailbox, 400 historical underwriting decisions with their outcomes. Labelling that set takes two days and it decides the whole design. In one AP engagement, categorising exceptions showed 82% fell into four mechanical buckets — which changed what we built entirely.

It also changes what “good” means. Without a labelled set, quality is whatever the last demo felt like. With one, you have a pass rate, and you can set the threshold yourself. That threshold belongs to the customer, not the vendor. We’ve had clients start at 98% on a decision workflow and 85% on a drafting workflow, and both were right, because the cost of being wrong differed by two orders of magnitude.

Three things beyond accuracy

Cost per run, with a ceiling. A system that works and costs $3.40 per item is a system finance will kill. Put the ceiling in CI.

Malformed and adversarial input. Missing fields, wrong currencies, duplicate submissions, a document in an unexpected language. Each becomes a test and a documented behaviour.

Drift. Scores move — model updates, document changes, seasonal input shifts. An alarm on a moving score is what separates a system you trust from one you hope about.

Why it is a commercial argument

The commercial argument matters more than the engineering one. A CXO cannot defend a system they can’t measure. Hand them a scoreboard — accuracy, cost, latency, per workflow, per month — and the conversation about expanding to the next workflow takes ten minutes.

Evals from day one. Not later.

Without a labelled set, quality is whatever the last demo felt like. With one you have a pass rate — and the threshold belongs to the customer, not the vendor.
Write the evals before the prompt

The posts argue it. The studies price it.

The same workflows from the other end: what the baseline was, what we built, and what moved once it was live.

Book a call

Request a thirty-minute session.

Tell us about your workflow. We’ll reply to arrange a time; submitting this form does not book a calendar slot.

We'll only use this to schedule your session. See our privacy policy.