research31 min studyLesson 910 in Engineering

A release claim needs an immutable evidence bundle and visible regressions

Bind policy, environment, grader, budgets, and full outcomes to a release identity, then compare paired changes without treating aggregate gains or finite clean runs as universal guarantees.

On this page

What you’ll understand

  • Specify a reproducible release evidence manifest and artifact lineage.
  • Calculate paired improvements and regressions on a complete fixed cohort.
  • Separate regression development cases, untouched final evaluation, and the scope of a release claim.

A release report should let another evaluator determine what ran, what was measured, and which earlier capabilities changed. A model name and headline success percentage are insufficient when prompts, tools, environment state, graders, or budgets can move independently. Bind those components to an immutable evidence identity and preserve complete outcomes and failures. The resulting bundle supports a specific release decision under stated conditions; it does not turn one benchmark into a universal claim about agent capability, deployment reliability, or every behavioral property.

Bind the experimental components and result artifacts together

Record task IDs and families, initial snapshots, policy and model revisions, prompts, tool schemas and implementations, observation modes, user-simulator configuration, grader versions, resource limits, seeds where meaningful, and termination rules. Reference exact output artifacts, effect evidence, traces, and human adjudication records by stable identity. A model API label can change behind the same name, so record available version evidence and reproducibility limits. A complete manifest should also identify setup failures, missing results, and exclusions under the declared protocol instead of describing only the successful examples.

Use deterministic manifest serialization and suitable integrity digests for referenced bytes, while distinguishing integrity from trustworthy interpretation. A hash can detect a byte change under its assumptions but does not prove that a grader was correct or a trace truthful. Keep sensitive content behind appropriate access boundaries with minimal public metadata. Harness caches also need provenance: the official SWE-bench guide warns that reused run and instance identifiers can reuse earlier results. Check the pinned implementation and artifact identity before interpreting a rerun as evidence for a changed patch or policy.

hE=H(canon⁡(ME)),hj=H(bj)h_E=H(\operatorname{canon}(M_E)),\qquad h_j=H(b_j)
M_E is the release evidence manifest, canon its declared deterministic serialization, and b_j exact referenced artifact bytes. H is a suitable declared integrity digest under its collision assumptions. These identifiers have no physical units and do not certify outcome truth, provenance completeness, or universal agent behavior.↔ Scroll wide equations horizontally.

Compare paired cases rather than only headline totals

Evaluate old and new systems on the same task versions and resource protocol, with repeated conditions paired where appropriate. Build the joint table: both pass, old-only pass, new-only pass, and neither. An aggregate improvement can hide regressions in important task families or monitored constraints. Preserve counts and uncertainty at the task-cluster level. A release gate can require additional conditions beyond mean success, but it should name them explicitly and show their evidence rather than quietly redefining a task's outcome after the comparison.

A newly discovered failure should become a reproducible regression case with its original full trace and a validated reduced version when useful. Once engineers tune against it, it belongs to development coverage; it should not continue to count as untouched final holdout evidence. Keep a separate evaluation set or protocol for claims about generalization. Environment and grader updates can also change old labels, so version them and rerun comparable baselines when necessary. Otherwise a report can confuse a better checker or easier fixture with an improved agent.

S^new−S^old=n01−n10N\widehat S_{\rm new}-\widehat S_{\rm old}=\frac{n_{01}-n_{10}}{N}
On N fixed assessable paired cases under one protocol, n01 counts old-fail/new-pass and n10 old-pass/new-fail. The dimensionless difference is a paired accounting identity, not a significance test, severity-weighted utility, or guarantee that every task family improved.↔ Scroll wide equations horizontally.

State the release decision's scope and preserve contrary evidence

Publish the tested conditions, uncertainty, known regressions, unresolved cases, and evidence-access process alongside the claimed improvements. Distinguish a staged simulator result from target-system validation and a finite monitor pass from an unrestricted behavioral guarantee. Zero observed failures over a finite suite does not establish a zero failure probability, especially with clustered tasks and untested conditions. A release decision can still be justified for a specified use and operating point; its strength comes from explicit evidence and limits, not from calling the benchmark comprehensive.

The probability lab shows why a clean finite run is compatible with a nonzero assumed defect rate. Reset, explicitly set BOTH p=0.01 and n=30, predict zero observed defects with probability about 0.7397, then Play or Step. Reset and re-set BOTH p=0.1 and n=30; predict about 0.0424. Edits retain t and playback highlights exact iid counts. The toy has no release manifest, task coverage, real defect estimate, or regression gate. It illustrates one sampling fact without claiming that independent trials describe the actual task suite or that the slider measures deployment risk.

An aggregate gain can coexist with lost capabilities

A fixed one-hundred-case paired cohort has sixty both-pass cases, ten old-only passes, fifteen new-only passes, and fifteen both-fail cases. All versions, budgets, and outcome definitions are held fixed for this accounting.

  1. Old success is (60+10)/100=0.7. New success is (60+15)/100=0.75, a gain of five percentage points.

  2. There are fifteen improvements and ten regressions, giving(15−10)/100=0.05 as the same paired difference. The gain does not erase the ten lost cases.

  3. Among the old system's seventy passes, ten regress:10/70≈0.1429. Inspect their task families, severity, and trace properties, retain them as regression evidence, and make any release gate's additional criteria explicit rather than presenting only the net gain.

The result

A reproducible evidence bundle preserves both progress and contrary cases so a scoped release decision can be reviewed.

Explore the model

Interactive lab

Interactive lab · probability

A clean finite run does not imply a zero underlying defect rate

For EACH run Reset, set BOTH p and n, predict, then Play or Step. At n=30, assumed defect p=0.01 gives P(K=0)≈0.7397; p=0.1 gives≈0.0424. Edits retain t. This exact iid model has no release gate, task clusters, manifests, effect evidence, or empirical deployment-risk estimate.

A clean finite run does not imply a zero underlying defect rateThese are exact binomial probabilities for independent trials with one fixed success probability. Playback tours the distribution; it does not resample outcomes. Current readings: Mean · np: 5; Variance · np(1−p): 2.5; Total probability: 1. All parameters are adjustable with the labeled controls below.03581000.070.150.220.3Successes kP(X = k)k = 0 · P = 9.77e-4
Exact probabilityHighlighted outcomeMean np
Mean · np
5
Variance · np(1−p)
2.5
Total probability
1
t = 0 s

These are exact binomial probabilities for independent trials with one fixed success probability. Playback tours the distribution; it does not resample outcomes. Parameter changes pause playback and recompute the model at the current elapsed time. Reset restores both parameters and returns time to zero. Playback starts paused. Adjust either parameter, then choose Play or Step.

Look forRelease claims should preserve finite-sample uncertainty, known regressions, and the tested conditions.

Check your understanding

A new release improves aggregate success by five points but loses ten previously passing cases. Which report supports a reviewable decision?

Try it yourself

Forty paired cases have twenty both-pass, eight old-only, six new-only, and six both-fail outcomes. Calculate old and new success rates, net change, and the regression fraction among old passes. Does adding these failures to development preserve their untouched-holdout status?

Take a moment to make a prediction or work it out on paper. Open a hint when you need one.

Give me a hint

Use the forty-case denominator for rates and the old-pass count for conditional regression.

Compare with the solution

Old success is 28/40=0.7 and new success 26/40=0.65, so net change is−0.05. Conditional regression is 8/28=2/7≈0.2857. After tuning against these cases they are development regressions, not untouched final holdouts; preserve them and obtain separate evidence for broader generalization claims.

Take it with you

  • Release evidence binds task, policy, environment, grader, resource, and artifact identities.
  • Paired comparisons expose regressions hidden by aggregate improvements.
  • Development regressions and untouched final evaluation serve different roles in a scoped release claim.

Read further

Original sources and deeper explanations to follow at your own pace.

Optional progress, saved in this browser when available. Revisit any lesson at any time.

Lesson not marked complete.