Book 7 · Lesson 7.3

Agent evals and release criteria

  • Run evals/run_evals.py and interpret exit codes
  • Wire pass rate into team_metrics for radar
  • Define release criteria for enrichment changes

Prerequisites: 7.2

pydantic-evals style gate — borrowed from maverick, shipped in evals/.

IDLE

Pass rate: 0% · cases: 3

Run locally

pnpm evals:run
pnpm evals:write-metrics   # needs compose + psql
pnpm dev:radar             # Eval pass rate card updates

Golden cases cover sentiment scoring, high-risk detection, and secret-leak heuristics.

Release criteria

  • 100% pass on golden set before merge
  • No silent scorer changes without new cases
  • Radar KPI reflects latest run — managers see drift

Lab

Break a keyword in enrich.py, rerun evals, watch gate fail and KPI drop.

Teach-back prompt

Why exit code 1 in CI beats a Slack thread saying “looks fine”?

Run enrichment eval gate

Lesson 7.3 check

1. Eval pass rate is stored in…