Awesome Testing

Evaluation lesson 02 · Design representative cases

Which cases deserve space in a limited evaluation budget?

Shared evaluation case · deterministic fictional data

Northstar Support Copilot. A fictional ecommerce support copilot retrieves versioned policies and synthetic customer records, drafts replies, and proposes sandboxed account actions. It cannot send or mutate anything without current authorization and exact human approval.

01 · Smallest useful mechanism

Represent the use case and its failure surface.

A useful case set combines expected traffic with deliberately oversampled boundaries and severe risks. It separates development cases from held-out cases, records provenance, and reports which populations, languages, tasks, and environment failures remain uncovered.

More examples do not repair a test set that omits the conditions where errors matter most.

02 · Experiment

Test the prediction

Deterministic fictional fixture

The design representative cases workbench uses versioned, inspectable teaching data. It does not claim to reproduce live customer traffic or model behavior.

Evidence workbench

Build the evaluation argument

Choose the evidence that makes an eight-case pilot set decision-useful rather than merely large.

Fixture northstar-cases-v1

03 · Decision artifact

Write the evaluation argument another reviewer can audit

Use synthetic or properly governed data. Keep critical failures visible instead of compressing them into one score.

  1. Claim

    Name the user and risk conditions the case set represents.

  2. Evaluation design

    Create a capability × slice × test-type matrix and a held-out split.

  3. Release evidence

    Attach case IDs, provenance, severity, locale, expected evidence, and known omissions.

Your learning artifact

Write the argument you would defend

Stored only in this browser. No account required; course reset does not delete it.

04 · Check your understanding

What should a case manifest disclose?

Theory notes and sources

What the experiment does not prove

Aggregate success can look excellent while multilingual, ambiguous, or authorization-sensitive slices fail systematically.

Common mistake: A large synthetic golden-path set is representative by default. Representativeness depends on the intended population and risk model; synthetic data also needs provenance and realism checks.

Transfer exercise: Spend eight case slots across common billing questions, Polish input, ambiguity, stale policy, authorization failure, and tool timeout.

Optional referenceDeep dive / reference chapterOpen the complete essay, diagrams, mathematics, exercises, glossary, and sources when you want more depth.

Next: Once cases are chosen, we need oracles and traces that say what success means without treating fluent prose as hidden proof.