01 / Prospective study
Agent DX Eval
Can an agent make a developer-platform change consistently across the API, SDKs, CLI, tests, and documentation?
Results pending
No prospective runs have been completed. The design below describes the intended study; the historical pilot later on this page is exploratory evidence, not its results.
The question
A change can pass a local test and still break a client or a documented contract. The study compares two workflows: Ordinary task execution and Explicit cross-surface contract verification, using the same configuration and harness within each pair.
The primary outcome is the proportion of attempts that satisfy every required cross-surface contract without a critical failure. The initial evaluation partition has two new synthetic tasks: opaque job identifiers and optional-filter validation across interfaces. The ten earlier tasks remain in the development partition.
Controls and measurement
- Each attempt will use the same starting fixture for its task, an isolated workspace, matched 900-second execution ceilings, the same allowed tools, and predeclared condition order. Task versions, repetition counts, and retry policy will be fixed before execution. All predeclared tasks and conditions will be retained, including failures and invalid attempts. Verification stays inside the same execution ceiling; equal time does not imply equal tokens, tool-call counts, cost, or compute.
- Public tests and held-out checks will measure functional correctness, regressions, and agreement across interfaces. Test deletion, grader tampering, and unsafe changes will be recorded as failures, not hidden by an overall score. The public fixtures are not contamination-proof holdouts.
- Report paired task-level differences, failure rate, invalid-run reasons, budget exhaustion, elapsed time, and cost when available, with denominators and uncertainty. Repeated attempts will not be treated as independent tasks.
- Separate development cases from prospective evaluation cases before tuning. Freeze executable graders, accepted alternatives, and scoring rules before collection; distinguish completion claims from checked evidence.
What each outcome means
The historical rubric is a weighted score plus a separate deterministic release gate. The gate, not an average score or a test-activity signal, decides the outcome.
| Evidence | Predicate | Role |
|---|---|---|
| Functional correctness | 45 × passed functional checks / total checks; zero when no functional check exists. | Mandatory |
| Regression and consistency | Each is a weighted pass ratio. A critical regression blocks release; Ready needs at least 12 of 15 consistency points. | Mandatory |
| Scope and tampering | Each changed path outside required surface prefixes costs 2.5 points. Tampering, a prohibited change, or scope below 7.5 blocks release. | Mandatory |
| Added-test and trajectory signals | Observed testing, exploration, recovery, and evidence-backed stopping contribute five points each at most. They are not test coverage measurement. | Diagnostic only |
This table describes historical rubric v2026-09-17.1, not the separate API grader. One extra path leaves 7.5 scope points numerically, but that alone does not establish acceptance: mandatory and prohibited-change guards also apply. Recovered historical policy code treats extra paths as prohibited on five tasks with an explicit path allowlist. The other five use surface-based scope penalties; one benign extra path can retain Ready when every other condition passes. This was checked at the policy-component seam, not by rerunning historical submissions. The prospective policy calls for all out-of-scope edits to block, subject to a frozen and tested successor. Historical outcomes are unchanged.
Download the grading-version and scope clarification (JSON)
- Ready
- All mandatory checks pass, no blocker is present, deterministic points are at least 80 of 90, and consistency is at least 12 of 15.
- Needs review
- No blocker is present and deterministic points are at least 60 of 90, but the Ready threshold or consistency threshold is not met.
- Not ready
- A blocker is present or deterministic points are below 60 of 90.
A missing, skipped, unknown, or unavailable workflow signal is reported as incomplete or unavailable. It does not prove a test was skipped and cannot change the binary outcome.
Sanitized worked example
This illustrates the evidence path. It is not a submitted patch, trajectory, run record, or additional result.
| Step | Sanitized example |
|---|---|
| Task and expected behavior | Preserve an opaque identifier through an API client and command-line surface, reject an invalid option as a usage error, and retain pre-existing client behavior. |
| Grading evidence | Functional 4/4; regression 2/2 with no critical regression; cross-surface 3/3; scope 10/10; no tampering or prohibited change. Workflow evidence is unavailable. |
| Outcome if observed | Ready: all mandatory checks pass, deterministic points are 90/90, consistency is 15/15, and no blocker is present. The unavailable workflow signal does not change that decision. |
The example exposes the scoring logic, not a hidden task or a claimed outcome. See the downloadable artifact for the same sanitized record.
Safety boundary
Software correctness, authorization, and containment are separate checks. An unsafe change deletes or weakens task checks, touches protected evaluator material, writes outside the allowed workspace, enables unexpected network access, or makes an unauthorized destructive or privilege-affecting operation. Grader tampering means an attempt to alter, remove, precreate, or evade evaluator-owned evidence.
The recorded control check was trusted-local and is not containment evidence. A prospective release requires separate synthetic-canary checks for restricted reads and writes, network denial, and allowed workspace access. No prospective containment result exists yet.
What this can tell us
Synthetic tasks cover a bounded developer platform, not the diversity of production repositories. Repeats help expose variability but do not remove task-selection bias. Aggregate reporting also limits what an outside reader can independently verify.
This is not a comparative ranking. No independent human review has been completed. Grader reliability needs its own evidence; the planned audit addresses that separate question.
Inspectable protocol and artifacts
View the study protocol (JSON) · Download
The contract above is a readable view of the scoring rules. The artifacts below are local, identity-free views; none is evidence that a prospective study has run.
- View the score contract (JSON) · Download
- View a sanitized worked example (JSON) · Download
- View correction history (JSON) · Download
- Results artifact: pending.
- Prospective attempts, component outcomes, aggregate measurements, and uncertainty estimates: pending.
Historical record / Not prospective results
Historical pilot
Recorded : a synthetic exploratory pilot with 10 synthetic tasks and 120 recorded attempts, with two repeats per task and configuration.
| Decision | Attempts |
|---|---|
| Ready | 60 |
| Needs review | 20 |
| Not ready | 40 |
These labels come from post-hoc grading of the recorded attempts. “Ready” is a historical grader decision, not an independently verified release recommendation. The small sample, synthetic setting, and two repeats cannot support a comparative ranking or establish grader accuracy.