docs: add rebuild guidance and ICE troubleshooting to AGENTS.md #88337

lukesandberg · 2026-01-09T17:17:28Z

Update AGENTS.md with better instructions abotu rebuilding and handling rustc crashes

Also make the graphite instructions more emphatic

lukesandberg · 2026-01-09T17:17:46Z

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

This stack of pull requests is managed by Graphite. Learn more about stacking.

AGENTS.md

nextjs-bot · 2026-01-09T17:42:05Z

Stats from current PR

✅ No significant changes detected

📊 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)	454ms	455ms	✓	██▁█▁
Cold (First Request)	1.183s	1.176s	✓	▁▇███
Warm (Listen)	456ms	456ms	✓	▃▃▆▃▃
Warm (First Request)	342ms	349ms	✓	▆▄▆█▄

📦 Dev Server (Webpack) (Legacy)

📦 Dev Server (Webpack)

Metric	Canary	PR	Change	Trend
Cold (Listen)	456ms	455ms	✓	▁▁▁██
Cold (First Request)	1.802s	1.804s	✓	▅▄▅▅▄
Warm (Listen)	456ms	455ms	✓	▁▅▅▅▅
Warm (First Request)	1.810s	1.819s	✓	▄▄▅▄▅

⚡ Production Builds

Metric	Canary	PR	Change	Trend
Fresh Build	4.113s	4.122s	✓	▄▁▁▃▂
Cached Build	4.121s	4.104s	✓	▇▂▁▄▂

📦 Production Builds (Webpack) (Legacy)

📦 Production Builds (Webpack)

Metric	Canary	PR	Change	Trend
Fresh Build	13.811s	13.816s	✓	▁▁▃▁▁
Cached Build	13.882s	13.877s	✓	▁▁▃▁▁
node_modules Size	457 MB	457 MB	✓	█████

📦 Bundle Sizes

Bundle Sizes

⚡ Turbopack

Client

Main Bundles: **430 kB** → **430 kB** ✅ -26 B

82 files with content-based hashes (individual files not comparable between builds)

Server

Middleware

	Canary	PR	Change
middleware-b..fest.js gzip	788 B	792 B	✓
Total	788 B	792 B	⚠️ +4 B

Build Details

Build Manifests

	Canary	PR	Change
_buildManifest.js gzip	448 B	450 B	✓
Total	448 B	450 B	⚠️ +2 B

📦 Webpack

Client

Main Bundles

	Canary	PR	Change
2086.HASH.js gzip	169 B	N/A	-
2161-HASH.js gzip	5.41 kB	N/A	-
2747-HASH.js gzip	4.48 kB	N/A	-
4322-HASH.js gzip	52.7 kB	N/A	-
ec793fe8-HASH.js gzip	62.3 kB	N/A	-
framework-HASH.js gzip	59.8 kB	59.8 kB	✓
main-app-HASH.js gzip	250 B	254 B	🔴 +4 B (+2%)
main-HASH.js gzip	38.6 kB	39 kB	✓
webpack-HASH.js gzip	1.68 kB	1.68 kB	✓
1596.HASH.js gzip	N/A	169 B	-
2658-HASH.js gzip	N/A	52.5 kB	-
6349-HASH.js gzip	N/A	4.46 kB	-
7019-HASH.js gzip	N/A	5.43 kB	-
b17a3386-HASH.js gzip	N/A	62.3 kB	-
Total	225 kB	225 kB	⚠️ +158 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	182 B	182 B	✓
css-HASH.js gzip	336 B	335 B	✓
dynamic-HASH.js gzip	1.8 kB	1.8 kB	✓
edge-ssr-HASH.js gzip	256 B	256 B	✓
head-HASH.js gzip	352 B	349 B	✓
hooks-HASH.js gzip	385 B	384 B	✓
image-HASH.js gzip	580 B	580 B	✓
index-HASH.js gzip	259 B	258 B	✓
link-HASH.js gzip	2.5 kB	2.51 kB	✓
routerDirect..HASH.js gzip	319 B	317 B	✓
script-HASH.js gzip	385 B	387 B	✓
withRouter-HASH.js gzip	316 B	315 B	✓
1afbb74e6ecf..834.css gzip	106 B	106 B	✓
Total	7.97 kB	7.96 kB	✅ -8 B

Server

Edge SSR

	Canary	PR	Change
edge-ssr.js gzip	125 kB	125 kB	✓
page.js gzip	239 kB	239 kB	✓
Total	364 kB	364 kB	⚠️ +280 B

Middleware

	Canary	PR	Change
middleware-b..fest.js gzip	653 B	654 B	✓
middleware-r..fest.js gzip	155 B	156 B	✓
middleware.js gzip	32.7 kB	33.1 kB	🔴 +416 B (+1%)
edge-runtime..pack.js gzip	842 B	842 B	✓
Total	34.3 kB	34.8 kB	⚠️ +418 B

Build Details

Build Manifests

	Canary	PR	Change
_buildManifest.js gzip	738 B	738 B	✓
Total	738 B	738 B	✓

Build Cache

	Canary	PR	Change
0.pack gzip	3.6 MB	3.62 MB	🔴 +15 kB (+0%)
index.pack gzip	97.7 kB	98.9 kB	🔴 +1.13 kB (+1%)
index.pack.old gzip	99.3 kB	99.5 kB	✓
Total	3.8 MB	3.82 MB	⚠️ +16.4 kB

🔄 Shared (bundler-independent)

Runtimes

	Canary	PR	Change
app-page-exp...dev.js gzip	303 kB	303 kB	✓
app-page-exp..prod.js gzip	157 kB	157 kB	✓
app-page-tur...dev.js gzip	302 kB	302 kB	✓
app-page-tur..prod.js gzip	157 kB	157 kB	✓
app-page-tur...dev.js gzip	299 kB	299 kB	✓
app-page-tur..prod.js gzip	155 kB	155 kB	✓
app-page.run...dev.js gzip	299 kB	299 kB	✓
app-page.run..prod.js gzip	155 kB	155 kB	✓
app-route-ex...dev.js gzip	68.2 kB	68.2 kB	✓
app-route-ex..prod.js gzip	46.9 kB	46.9 kB	✓
app-route-tu...dev.js gzip	68.2 kB	68.2 kB	✓
app-route-tu..prod.js gzip	46.9 kB	46.9 kB	✓
app-route-tu...dev.js gzip	67.8 kB	67.8 kB	✓
app-route-tu..prod.js gzip	46.7 kB	46.7 kB	✓
app-route.ru...dev.js gzip	67.8 kB	67.8 kB	✓
app-route.ru..prod.js gzip	46.7 kB	46.7 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	41.1 kB	41.1 kB	✓
pages-api-tu..prod.js gzip	31.2 kB	31.2 kB	✓
pages-api.ru...dev.js gzip	41.1 kB	41.1 kB	✓
pages-api.ru..prod.js gzip	31.2 kB	31.2 kB	✓
pages-turbo....dev.js gzip	50.8 kB	50.8 kB	✓
pages-turbo...prod.js gzip	38.2 kB	38.2 kB	✓
pages.runtim...dev.js gzip	50.8 kB	50.8 kB	✓
pages.runtim..prod.js gzip	38.2 kB	38.2 kB	✓
server.runti..prod.js gzip	62 kB	62 kB	✓
Total	2.67 MB	2.67 MB	✓

codspeed-hq · 2026-01-09T18:12:36Z

Merging this PR will not alter performance

✅ 17 untouched benchmarks
⏩ 3 skipped benchmarks¹

_{Comparing 01-09-agents-md-updates (00722c2) with 01-09-niche-optimization-aggregation-number (fc6c9dd)}

3 benchmarks were skipped, so the baseline results were used instead. If they were deleted from the codebase, click here and archive them to remove them from the performance reports. ↩

AGENTS.md

Add documentation about: - When to rebuild before running Next.js integration tests - How to handle Rust internal compiler errors (ICE) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <[email protected]>

nextjs-bot added the created-by: Turbopack team PRs by the Turbopack team. label Jan 9, 2026

lukesandberg mentioned this pull request Jan 9, 2026

fix(turbo-tasks-backend): use correct TaskDataCategory for is_immutable check #88331

Open

lukesandberg mentioned this pull request Jan 9, 2026

perf(turbo-tasks-backend): use DefaultStorage for AggregationNumber to save memory #88336

Open

vercel bot reviewed Jan 9, 2026

View reviewed changes

AGENTS.md Outdated Show resolved Hide resolved

lukesandberg mentioned this pull request Jan 9, 2026

feat: add TaskStorage derive macro and schema infrastructure #88338

Open

lukesandberg force-pushed the 01-09-agents-md-updates branch from a98f5fa to 00722c2 Compare January 9, 2026 17:42

lukesandberg marked this pull request as ready for review January 9, 2026 21:12

lukesandberg requested a review from a team January 9, 2026 21:12

lukesandberg commented Jan 9, 2026

View reviewed changes

AGENTS.md Outdated Show resolved Hide resolved

bgw approved these changes Jan 9, 2026

View reviewed changes

lukesandberg and others added 3 commits January 9, 2026 16:07

emphasize graphite instructions

72da835

Update AGENTS.md

47d98d1

lukesandberg force-pushed the 01-09-niche-optimization-aggregation-number branch from fc6c9dd to cf617ff Compare January 10, 2026 00:08

lukesandberg force-pushed the 01-09-agents-md-updates branch from 1c882f9 to 47d98d1 Compare January 10, 2026 00:08

This was referenced Jan 10, 2026

feat: add typed serialization methods for TaskStorage #88355

Open

refactor: migrate to typed accessors and remove CachedDataItem adapter #88397

Open

perf: optimize cell_data serialization format #88401

Open

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

docs: add rebuild guidance and ICE troubleshooting to AGENTS.md #88337

docs: add rebuild guidance and ICE troubleshooting to AGENTS.md #88337

lukesandberg commented Jan 9, 2026 •

edited

Loading

Uh oh!

lukesandberg commented Jan 9, 2026 •

edited

Loading

Uh oh!

Uh oh!

nextjs-bot commented Jan 9, 2026 •

edited

Loading

⚡ Dev Server

📦 Dev Server (Webpack)

⚡ Production Builds

📦 Production Builds (Webpack)

Bundle Sizes

⚡ Turbopack

📦 Webpack

🔄 Shared (bundler-independent)

Uh oh!

codspeed-hq bot commented Jan 9, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

docs: add rebuild guidance and ICE troubleshooting to AGENTS.md #88337

Are you sure you want to change the base?

docs: add rebuild guidance and ICE troubleshooting to AGENTS.md #88337

Conversation

lukesandberg commented Jan 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

lukesandberg commented Jan 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

nextjs-bot commented Jan 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Stats from current PR

✅ No significant changes detected

⚡ Dev Server

📦 Dev Server (Webpack)

⚡ Production Builds

📦 Production Builds (Webpack)

Bundle Sizes

⚡ Turbopack

📦 Webpack

🔄 Shared (bundler-independent)

Uh oh!

codspeed-hq bot commented Jan 9, 2026

Merging this PR will not alter performance

Footnotes

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

lukesandberg commented Jan 9, 2026 •

edited

Loading

lukesandberg commented Jan 9, 2026 •

edited

Loading

nextjs-bot commented Jan 9, 2026 •

edited

Loading