Evaluation

Build an evaluation loop that improves the product.

Evaluation becomes valuable when it turns a real workflow failure into the next durable product improvement.

It is easy to collect a score and hard to learn from it. A useful evaluation loop connects a representative task, a clear definition of success, an observable path through the workflow, and a decision about what to improve next.

Start with a real job

Choose a task that matters to an actual user or operator. Give it a concrete outcome and the context needed to attempt it. Broad demonstrations are entertaining, but bounded jobs reveal whether the product surface is usable when the work has constraints.

Use more than one kind of check

Some conditions should be deterministic: did the system use an allowed capability, produce the required format, or respect a boundary? Other questions require judgment: was the result appropriate, was the path understandable, and did the handoff happen at the right moment? Keep those checks distinct.

Compare the change, not just the score

Preserve a clear record of each evaluation run so that a team can compare a change against a meaningful baseline. The important question is not “what is the number?” It is “what became better, what got worse, and why?”

Promote failure patterns into the next test

When a workflow fails in an instructive way, turn that case into a recurring check. This keeps a fixed improvement from quietly returning and makes the evaluation set more representative over time.

Close the loop in the product

An evaluation should result in an edit to a tool description, a clearer constraint, a better recovery path, or a revised approval point. If the loop stops at a dashboard, it is reporting—not learning.

The most valuable evaluation is the one that changes the next version of the experience.

Read this guide as markdown