Page 1 of 8~112 min topic

Eval gates in code

Frame the CI eval release gate experiment

Page 1 sets a falsifiable claim for the release eval gate in CI before any implementation work begins.

~14 min this pageExperiment brief

1Try it yourself

Playground

Eval gate before ship

No agent or RAG change reaches prod without a golden task set. Deep mode opens the full Eval arena.

Ship readiness0%

2Learn the idea

Read

Name the deliverable and claim

Success is not “I followed the tutorial.” Success is producing evidence that: gate exits non-zero on regression and zero on the pinned baseline. The accepted input is narrow on purpose: golden cases, metric functions, threshold config, candidate outputs. That narrowness is what lets you inspect every field and prevents a toy demo from being narrated as a production system.

Record the baseline you must beat: last known good release metrics. If the finished artifact cannot beat that baseline on the fixture below, stop and revise the claim before writing more code.

Read

Inventory the fixture

{"id":"refund-window","question":"Can I return headphones after 20 days?","must_include":["30 days","receipt"],"must_not_include":["no returns"],"severity":"critical"}

Expected evidence: 0.90 overall and 1.00 for critical policy cases. Treat the printout as a claim about this fixture, not as proof that the toolchain merely started.

Read

Spot misleading success early

For the release eval gate in CI, a decorative win often looks like a clean run that never checks pass/fail exit code; metric deltas vs baseline; seed recorded. Write the metric down now so later pages cannot redefine success after the fact. Also note the operational threat you will eventually gate on: editing golden expected answers to greenwash a bad candidate.

Read

Lab notebook: claim before code

For eval-in-code, write the claim on a sticky note in this exact shape: “Given golden cases, metric functions, threshold config, candidate outputs, the CI eval release gate will …”. Fill the ellipsis with the observable part of: gate exits non-zero on regression and zero on the pinned baseline. Tape the baseline beside it: last known good release metrics. If someone later replaces your metric with a vibe check, the sticky note is how you push back.

Also sketch the one-sentence user story: a person uses this output to fail a candidate release when golden-task metrics regress past a pinned threshold. If that sentence needs a dashboard, a model zoo, or five services, the lab scope is too wide—shrink the fixture (golden JSONL + threshold.yaml) until the story fits on one screen.

Read

Worked judgment

Decide now whether live network calls are allowed on page 1. For this lab they usually are not; inventory and contracts should run offline against golden JSONL + threshold.yaml. Note the metric you will eventually require (pass/fail exit code; metric deltas vs baseline; seed recorded) so page 4 cannot invent a softer target. The characteristic failure to keep in mind is flaky eval that flips without seed control, or soft-fail that never blocks merge.

Read

Why this stage matters for the CI eval release gate

At the experiment brief stage for eval-in-code, the job is narrower than finishing a product demo. You are creating one progressive evidence piece about golden JSONL + threshold.yaml that later pages inherit without redefining success. Keep that fixture small enough to inspect by hand, keep outputs copy-pasteable as text, and refuse to narrate this baseline as if it were a production SLA: last known good release metrics.

For this page specifically, success looks like a falsifiable claim and baseline written before coding while still centering the user decision to fail a candidate release when golden-task metrics regress past a pinned threshold. If you cannot point to a file, command, or assertion that proves that for the CI eval release gate, stay on this page instead of advancing.

How-to: ship agent with eval gate · Glossary: eval set

Next

Go deeper

Before you start

Why this matters

On paper, write the user decision this lab supports: fail a candidate release when golden-task metrics regress past a pinned threshold. Then write one sentence naming what could look successful while actually being wrong for this claim—focus on flaky eval that flips without seed control, or soft-fail that never blocks merge. Keep both sentences beside the fixture inventory you run next.

In the wild

See how this idea shows up as a product and a company — then come back to the lesson. Skills transfer across vendors.

Check your understanding

Page assessment

Answer from memory. Completion is saved from this evidence, not from opening the next page.

1. What exact claim can this fixture disprove?
2. Which baseline prevents a decorative success story?
3. What result would make you stop before implementation?
4. Did you name the metric (pass/fail exit code) up front?

All responses are required.