🧱
The Framework
Agent Evaluation Stack

Six layers β€”
add each one as your system matures.

A practical framework for evaluating AI agents. Start with baseline correctness, then layer on coverage, error analysis, reproducibility, multi-dimensional quality, and data-driven experiments.

The Framework

The Six Layers

How the Layers Build on Each Other

flowchart LR L1["πŸ… 1 Β· Golden Sets
baseline"] --> L2["🧭 2 · Behavioral
Coverage"] L2 --> L3["πŸ”Ž 3 Β· Error
Analysis"] L3 --> L4["🎬 4 · Replay
Harnesses"] L4 --> L5["πŸ“‹ 5 Β· Rubrics"] L5 --> L6["πŸ§ͺ 6 Β· Experiments"] L6 -.improve.-> L1

Each layer assumes the ones before it. You cannot measure coverage without a dataset, cannot analyze errors without measurable outputs, and cannot run trustworthy experiments without reproducible, multi-dimensional scoring. The loop closes when experiment insights feed back into your golden sets.

A Maturity Path, Not a Checklist

Starting Out

Layers 1–2

Define correctness with golden sets and make sure they cover the behaviors that matter. This alone catches most regressions.

Scaling Up

Layers 3–4

Systematically analyze failures and freeze sessions into replayable fixtures so evaluation is cheap, fast, and reproducible.

Maturing

Layers 5–6

Grade nuanced quality with rubrics and make every change a measured experiment with statistical confidence.