Skip to main content

Run the eval loop

The Unified Eval Loop (/eval-loop) carries a single production failure through 14 evidence stages, ending in a signed report. It does not manufacture success from aggregate counts — every stage must be backed by a real platform record.

Step 1 — Start from a real trace

Open /eval-loop, click Start from a trace, enter a workflow name and the numeric trace ID, and click Create evidence chain. The source trace becomes version 1. A screenshot of the eval-loop start dialog with a trace ID entered.

Step 2 — Advance each stage

Each stage requires canonical evidence from another surface. You do not type evidence in — you create it on the surface it belongs to, then the loop validates and advances.

Step 3 — Handle a stuck stage

If a stage will not advance, the page tells you what evidence is missing or invalid — stale, skipped, partial, foreign, mismatched, expired, revoked, or provenance-incomplete. Fix the referenced record on its native surface, then retry.
A completed stage is immutable. The workflow version increases by exactly one per accepted transition.

Step 4 — Seal the report

The final stage is a non-expired, non-revoked signed report that names the workflow and seals the evidence body. Until that report exists, the loop is not complete.

Up next

Share the signed report with reviewers.