Skip to content

test: add adoption skill evals - #97759

Merged
aurorascharff merged 51 commits into
canaryfrom
codex/adoption-skill-evals
Aug 31, 2026
Merged

test: add adoption skill evals#97759
aurorascharff merged 51 commits into
canaryfrom
codex/adoption-skill-evals

Conversation

@aurorascharff

@aurorascharff aurorascharff commented Aug 23, 2026

Copy link
Copy Markdown
Contributor

Summary

  • add end-to-end adoption evals for Partial Prefetching and Cache Components
  • compare the baseline, bundled docs, and local adoption skill independently
  • support local skill installation and longer timeouts for browser-backed workflows

Results

One claude-opus-4-8 run was retained per treatment and adoption eval, judged by claude-haiku-4-5. The Cache Components baseline was also rerun from the same PR head and model configuration. These results are directional rather than statistically stable.

Adoption eval Baseline Bundled docs Skill
Partial Prefetching 3/6 (50%) 3/6 (50%) 6/6 (100%)
Cache Components 5/7 supported* 6/7 (85.7%) 7/7 (100%)

The Partial Prefetching skill was the only treatment to establish a passing legacy instant() baseline before migration, rerun the same production Playwright assertions after enabling Partial Prefetching, and preserve the selected eager-link contract. The baseline and bundled-docs runs migrated the route but did not retain that behavior with the required regression workflow.

Cache Components baseline audit

The clean Cache Components baseline rerun completed in 682 seconds. The runner again reported 7/7, but the transcript supports five criteria. Two agentic checks were false positives:

  • The product route rendered only <main> and a <Suspense fallback={null}> outside the URL-specific work, so it did not preserve useful visible shell content.
  • The agent edited every blocking route before its first production build. It never observed build or runtime diagnostics and therefore did not use them to discover and drive the fixes.

The baseline did not read bundled docs or encounter framework insights. It inspected the installed Next.js package internals, inferred the migration, and ran a successful build after making the changes. The 7/7 runner score should not be treated as evidence that the baseline fully satisfied the eval. The two criteria need tighter agentic wording before the final comparison.

The current bundled-docs and skill scores remain 6/7 and 7/7. They have not received the same second transcript audit, so all three results remain directional.

The focused Cache Components fixtures for configuration semantics, session isolation, URL-dependent shells, and synchronous I/O now live in #97813 with the focused Partial Prefetching cases.

Scope

These are PR-local experiments for developing and reviewing the docs and skills. This PR does not register them in the public evals.nextjs.org suite, which is configured separately in the OSS eval repository.

Validation

  • pnpm exec tsc -p evals/tsconfig.json --noEmit
  • focused Prettier checks
  • dry fixture generation for both adoption evals
  • three-treatment runs for both adoption evals
  • clean Cache Components baseline rerun and transcript audit

@github-actions

github-actions Bot commented Aug 23, 2026

Copy link
Copy Markdown
Contributor

Stats from current PR

🟢 1 improvement

Metric Canary PR Change Trend
Warm (First Request) 1.699s 832ms 🟢 867ms (-51%) ▁▁▁██
📊 All Metrics
📖 Metrics Glossary

Dev Server Metrics:

  • Listen = TCP port starts accepting connections
  • First Request = HTTP server returns successful response
  • Cold = Fresh build (no cache)
  • Warm = With cached build artifacts

Build Metrics:

  • Fresh = Clean build (no .next directory)
  • Cached = With existing .next directory

Change Thresholds:

  • Time: Changes < 50ms AND < 10%, OR < 2% are insignificant
  • Size: Changes < 1KB AND < 1% are insignificant
  • All other changes are flagged to catch regressions

⚡ Dev Server

Metric Canary PR Change Trend
Cold (Listen) 1.114s 1.114s ▂▂▂██
Cold (Ready in log) 1.076s 1.085s ▁▁▁██
Cold (First Request) 1.695s 1.702s ▁▁▁██
Warm (Listen) 1.114s 1.064s ▁▂▂██
Warm (Ready in log) 1.080s 1.068s ▁▁▁██
Warm (First Request) 1.699s 832ms 🟢 867ms (-51%) ▁▁▁██
📦 Dev Server (Webpack) (Legacy)

📦 Dev Server (Webpack)

Metric Canary PR Change Trend
Cold (Listen) 814ms 813ms ▁▁▁█▁
Cold (Ready in log) 804ms 807ms ▁▂▁█▁
Cold (First Request) 3.437s 3.459s ▁▂▁█▁
Warm (Listen) 814ms 812ms ▁▁▁▇▁
Warm (Ready in log) 807ms 803ms ▁▂▁█▁
Warm (First Request) 3.435s 3.450s ▁▂▁█▁

⚡ Production Builds

Metric Canary PR Change Trend
Fresh Build 7.575s 7.893s ▁▁▂██
Cached Build 3.964s 4.016s ▁▁▁██
📦 Production Builds (Webpack) (Legacy)

📦 Production Builds (Webpack)

Metric Canary PR Change Trend
Fresh Build 24.876s 24.751s ▁▂▁█▁
Cached Build 25.043s 24.948s ▁▂▁█▁
node_modules Size 558 MB 558 MB █████
📦 Bundle Sizes

Bundle Sizes

⚡ Turbopack

Client

Main Bundles
Canary PR Change
017_4moyv5m34.js gzip 117 B 117 B
05jocc85-b73_.js gzip 341 B N/A -
0cz1d0mv5g_q7.js gzip 39.4 kB 39.4 kB
0e5lgz-xcf6ln.js gzip 273 B 273 B
0enhddgqs2dl-.js gzip 265 B 265 B
0h34mejwa_7pd.js gzip 354 B 354 B
0w853zxni3ro0.js gzip 1.36 kB N/A -
13lq2aw3_0bgw.js gzip 3.52 kB N/A -
19ll0d77yn0fq.js gzip 71.5 kB N/A -
1drifx6-oqf3q.js gzip 5.7 kB N/A -
1elt1qium-r2m.css gzip 115 B 115 B
1m5vdnlf0deiv.js gzip 411 B 411 B
1nigpy_mr0xvj.js gzip 339 B N/A -
1p0l8mn2wz5f2.js gzip 1.97 kB N/A -
1ph_nbsm967ot.js gzip 152 B N/A -
1sqoyy39jpgkq.js gzip 121 B 121 B
1tf1phijqlx9j.js gzip 220 B 220 B
2-54v5vj7orwp.js gzip 46.8 kB N/A -
2b05_424u1zq-.js gzip 120 B N/A -
2ca40xittx95r.js gzip 8.75 kB N/A -
2kci0vnt-49o-.js gzip 113 B 113 B
2rtriq9lc6zj-.js gzip 116 B N/A -
2sxgl_rcrrn_p.js gzip 399 B N/A -
2vt62i17bhbdu.js gzip 2.35 kB N/A -
33ykhou7tl-4h.js gzip 7.53 kB N/A -
342di-crrg9kq.js gzip 119 B N/A -
36hfc2_979aw2.js gzip 119 B N/A -
38wfp6jjrrdfm.js gzip 131 B 131 B
3dl1ilk37-30g.js gzip 117 B N/A -
3h0us7yy7bd_o.js gzip 13.1 kB N/A -
3kvxagoobts7h.js gzip 117 B N/A -
3p99hd9vwe6ae.js gzip 13 kB N/A -
3r0475panhk6m.js gzip 123 B N/A -
3s0i-weykgzrt.js gzip 125 B N/A -
3vjosdbddykpw.js gzip 5.88 kB N/A -
3wijk2ywqgsv9.js gzip 2.52 kB N/A -
3xuguv9lsoqw7.js gzip 65.5 kB N/A -
41u5s3oe2-erp.js gzip 2.29 kB N/A -
turbopack-0d..9ejy.js gzip 3.74 kB 3.74 kB
02zc7sqlpqxn3.js gzip N/A 119 B -
06pzxqp5qiozm.js gzip N/A 5.7 kB -
0dw-iyxdctoxo.js gzip N/A 65.5 kB -
0e28eh3gbwmp0.js gzip N/A 3.51 kB -
0e5ldm8_fmypq.js gzip N/A 71.5 kB -
0jwho9fkrb_t3.js gzip N/A 2.29 kB -
0longconn5mlm.js gzip N/A 123 B -
0p4l3ozbez2cz.js gzip N/A 2.35 kB -
0sbh_15ejop4o.js gzip N/A 13 kB -
0skdm-9rpid8g.js gzip N/A 117 B -
0wv-h56sz83wn.js gzip N/A 120 B -
137xup2t69ovc.js gzip N/A 1.97 kB -
1ezuqvubf86h1.js gzip N/A 5.88 kB -
1fk10s3m1oecx.js gzip N/A 400 B -
1hut5u-lz2yif.js gzip N/A 117 B -
20qhkyyj2_tla.js gzip N/A 116 B -
2imyufe18bsb7.js gzip N/A 1.36 kB -
2p4n3-8-xixh_.js gzip N/A 341 B -
2vqdfieehz5do.js gzip N/A 8.75 kB -
2xn85ykzw2v1e.js gzip N/A 13.1 kB -
34knadd6wu9qg.js gzip N/A 119 B -
35eub0y5wk0-c.js gzip N/A 7.53 kB -
37b0_t16yn97f.js gzip N/A 153 B -
39jq2b6t6z6up.js gzip N/A 339 B -
3a9a9tvkag_-j.js gzip N/A 2.52 kB -
3d61tgick8g6b.js gzip N/A 46.8 kB -
3t121tj-h0kbm.js gzip N/A 125 B -
Total 299 kB 299 kB ⚠️ +3 B

Server

Middleware
Canary PR Change
middleware-b..fest.js gzip 1.02 kB 1.03 kB
Total 1.02 kB 1.03 kB ⚠️ +2 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 846 B 847 B
Total 846 B 847 B ⚠️ +1 B
Build Cache
Canary PR Change
00000001.sst gzip 10.1 MB 12 MB 🔴 +1.96 MB (+19%)
00000002.sst gzip 11.2 MB 16.5 MB 🔴 +5.31 MB (+47%)
00000003.sst gzip 16.7 MB 13.5 MB 🟢 3.23 MB (-19%)
00000004.sst gzip 13.9 MB 12.9 MB 🟢 1.03 MB (-7%)
00000005.sst gzip 13.1 MB 10.1 MB 🟢 3.02 MB (-23%)
00000006.sst gzip 2.75 MB 2.75 MB
00000007.sst gzip 59 B 59 B
00000008.meta gzip 89 B 89 B
00000009.meta gzip 297 kB 297 kB
00000010.meta gzip 297 kB 297 kB
00000011.meta gzip 297 kB 297 kB
00000012.sst gzip 52.8 kB 1.81 MB 🔴 +1.75 MB (+3324%)
00000013.sst gzip 1.79 MB 52.9 kB 🟢 1.74 MB (-97%)
00000014.sst gzip 59 B 59 B
00000015.meta gzip 116 B 116 B
00000016.meta gzip 327 kB 327 kB
00000017.meta gzip 404 kB 404 kB
00000018.sst gzip 1.36 MB 1.37 MB 🔴 +11.6 kB (+1%)
00000019.sst gzip 53.7 kB 53.6 kB
00000020.sst gzip 59 B 59 B
00000021.meta gzip 116 B 116 B
00000022.meta gzip 327 kB 327 kB
00000023.meta gzip 372 kB 372 kB
00000024.sst gzip 1.36 MB 53.7 kB 🟢 1.3 MB (-96%)
00000025.sst gzip 53.7 kB 1.37 MB 🔴 +1.32 MB (+2448%)
00000026.sst gzip 59 B 59 B
00000027.meta gzip 116 B 116 B
00000028.meta gzip 327 kB 327 kB
00000029.meta gzip 372 kB 372 kB
00000030.sst gzip 1.36 MB 1.37 MB 🔴 +11.3 kB (+1%)
00000031.sst gzip 53 kB 53 kB
00000032.sst gzip 59 B 59 B
00000033.meta gzip 116 B 116 B
00000034.meta gzip 327 kB 327 kB
00000035.meta gzip 372 kB 372 kB
00000036.sst gzip 53.7 kB 53.6 kB
00000037.sst gzip 1.36 MB 1.37 MB 🔴 +11.4 kB (+1%)
00000038.sst gzip 59 B 59 B
00000039.meta gzip 116 B 116 B
00000040.meta gzip 327 kB 327 kB
00000041.meta gzip 372 kB 372 kB
CURRENT gzip 94 B 94 B
LOG gzip 664 B 675 B 🔴 +11 B (+2%)
Total 79.6 MB 79.7 MB ⚠️ +47 kB

📦 Webpack

Client

Main Bundles
Canary PR Change
3322-HASH.js gzip 65.7 kB N/A -
4191.HASH.js gzip 169 B N/A -
9784-HASH.js gzip 5.6 kB N/A -
b1ad9f4c-HASH.js gzip 63.5 kB N/A -
framework-HASH.js gzip 59.7 kB 59.7 kB
main-app-HASH.js gzip 253 B 252 B
main-HASH.js gzip 39.8 kB 39.7 kB
webpack-HASH.js gzip 1.68 kB 1.68 kB
3577.HASH.js gzip N/A 168 B -
578-HASH.js gzip N/A 65.8 kB -
8590-HASH.js gzip N/A 5.57 kB -
a8984546-HASH.js gzip N/A 63.5 kB -
Total 236 kB 237 kB ⚠️ +105 B
Polyfills
Canary PR Change
polyfills-HASH.js gzip 39.4 kB 39.4 kB
Total 39.4 kB 39.4 kB
Pages
Canary PR Change
_app-HASH.js gzip 194 B 193 B
_error-HASH.js gzip 181 B 182 B
css-HASH.js gzip 334 B 331 B
dynamic-HASH.js gzip 1.81 kB 1.81 kB
edge-ssr-HASH.js gzip 255 B 253 B
head-HASH.js gzip 349 B 351 B
hooks-HASH.js gzip 382 B 384 B
image-HASH.js gzip 5.05 kB 5.05 kB
index-HASH.js gzip 260 B 259 B
link-HASH.js gzip 2.48 kB 2.48 kB
routerDirect..HASH.js gzip 317 B 318 B
script-HASH.js gzip 384 B 386 B
withRouter-HASH.js gzip 316 B 315 B
1afbb74e6ecf..834.css gzip 106 B 106 B
Total 12.4 kB 12.4 kB ✅ -6 B

Server

Edge SSR
Canary PR Change
edge-ssr.js gzip 128 kB 128 kB
page.js gzip 293 kB 293 kB
Total 421 kB 421 kB ✅ -431 B
Middleware
Canary PR Change
middleware-b..fest.js gzip 599 B 601 B
middleware-r..fest.js gzip 156 B 156 B
middleware.js gzip 45.8 kB 45.3 kB 🟢 491 B (-1%)
edge-runtime..pack.js gzip 842 B 842 B
Total 47.4 kB 46.9 kB ✅ -489 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 699 B 699 B
Total 699 B 699 B
Build Cache
Canary PR Change
0.pack gzip 4.8 MB 4.8 MB 🟢 6.64 kB (0%)
index.pack gzip 124 kB 124 kB
index.pack.old gzip 125 kB 123 kB 🟢 2.26 kB (-2%)
Total 5.05 MB 5.04 MB ✅ -8.7 kB

🔄 Shared (bundler-independent)

Runtimes
Canary PR Change
app-page-exp...dev.js gzip 377 kB 377 kB
app-page-exp..prod.js gzip 207 kB 207 kB
app-page-tur...dev.js gzip 377 kB 377 kB
app-page-tur..prod.js gzip 207 kB 207 kB
app-page-tur...dev.js gzip 373 kB 373 kB
app-page-tur..prod.js gzip 205 kB 205 kB
app-page.run...dev.js gzip 373 kB 373 kB
app-page.run..prod.js gzip 205 kB 205 kB
app-route-ex...dev.js gzip 82.9 kB 82.9 kB
app-route-ex..prod.js gzip 55.8 kB 55.8 kB
app-route-tu...dev.js gzip 82.9 kB 82.9 kB
app-route-tu..prod.js gzip 55.9 kB 55.9 kB
app-route-tu...dev.js gzip 82.5 kB 82.5 kB
app-route-tu..prod.js gzip 55.6 kB 55.6 kB
app-route.ru...dev.js gzip 82.4 kB 82.4 kB
app-route.ru..prod.js gzip 55.6 kB 55.6 kB
dev-validati...dev.js gzip 139 kB 139 kB
dev-validati...dev.js gzip 139 kB 139 kB
dev-validati...dev.js gzip 137 kB 137 kB
dev-validati...dev.js gzip 137 kB 137 kB
dist_client_...dev.js gzip 324 B 324 B
dist_client_...dev.js gzip 326 B 326 B
dist_client_...dev.js gzip 318 B 318 B
dist_client_...dev.js gzip 317 B 317 B
pages-api-tu...dev.js gzip 46.3 kB 46.3 kB
pages-api-tu..prod.js gzip 34.3 kB 34.3 kB
pages-api.ru...dev.js gzip 46.2 kB 46.2 kB
pages-api.ru..prod.js gzip 34.3 kB 34.3 kB
pages-turbo....dev.js gzip 54.7 kB 54.7 kB
pages-turbo...prod.js gzip 39.7 kB 39.7 kB
pages.runtim...dev.js gzip 54.7 kB 54.7 kB
pages.runtim..prod.js gzip 39.6 kB 39.6 kB
server.runti..prod.js gzip 66 kB 66 kB
use-cache-pr...dev.js gzip 73.4 kB 73.4 kB
use-cache-pr...dev.js gzip 73.4 kB 73.4 kB
use-cache-pr...dev.js gzip 71.7 kB 71.7 kB
use-cache-pr...dev.js gzip 71.6 kB 71.6 kB
Total 4.14 MB 4.14 MB
📎 Tarball URL
https://vercel-packages.vercel.app/next/commits/ef35138de8024962ca2dae419dbf3325f2dbd925/next

Commit: ef35138

@aurorascharff
aurorascharff marked this pull request as ready for review August 26, 2026 07:42
@aurorascharff
aurorascharff requested a review from gaojude August 27, 2026 16:48
aurorascharff added a commit that referenced this pull request Aug 27, 2026
…ion (#97712)

## What

- Documents how legacy `prefetch={true}` behavior changes with Partial
Prefetching and how to choose the UI worth preserving.
- Updates the adoption skill to capture a passing flag-off `instant()`
baseline, use the same assertions to drive the migration, and retain
them as regression coverage.
- Adds a reusable production test rig, keeps additional per-link
optimization separate from adoption, and surfaces `prefetch={false}`
links that may no longer be needed.
- Applies the shared test-rig fixes discovered during dogfooding to the
Cache Components optimizer.

## Why

Legacy `prefetch={true}` could include uncached dynamic content. With
Partial Prefetching, it includes the shared App Shell and cached
URL-specific content instead. A passing build or clean insight sweep
does not prove that the intended prefetched UI survived the migration,
so the skill now records that contract before adoption and verifies it
unchanged afterward. The guide presents the same test workflow as an
optional programmatic check for manual adopters.

## Testing

- Prettier, Alex, and skill frontmatter validation
- Dogfooded on v0 in vercel/v0#28842
- Partial Prefetching adoption eval: 6/6 in
#97759
Base automatically changed from codex/partial-prefetch-preservation-guide to canary August 27, 2026 19:46
@aurorascharff
aurorascharff merged commit d434afa into canary Aug 31, 2026
66 checks passed
@aurorascharff
aurorascharff deleted the codex/adoption-skill-evals branch August 31, 2026 18:52
icyJoseph pushed a commit that referenced this pull request Sep 7, 2026
…ion (#97712)

## What

- Documents how legacy `prefetch={true}` behavior changes with Partial
Prefetching and how to choose the UI worth preserving.
- Updates the adoption skill to capture a passing flag-off `instant()`
baseline, use the same assertions to drive the migration, and retain
them as regression coverage.
- Adds a reusable production test rig, keeps additional per-link
optimization separate from adoption, and surfaces `prefetch={false}`
links that may no longer be needed.
- Applies the shared test-rig fixes discovered during dogfooding to the
Cache Components optimizer.

## Why

Legacy `prefetch={true}` could include uncached dynamic content. With
Partial Prefetching, it includes the shared App Shell and cached
URL-specific content instead. A passing build or clean insight sweep
does not prove that the intended prefetched UI survived the migration,
so the skill now records that contract before adoption and verifies it
unchanged afterward. The guide presents the same test workflow as an
optional programmatic check for manual adopters.

## Testing

- Prettier, Alex, and skill frontmatter validation
- Dogfooded on v0 in vercel/v0#28842
- Partial Prefetching adoption eval: 6/6 in
#97759

(cherry picked from commit 24ed66a)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants