docs: extend agent performance and Webpack guidance #8267
main fromdocs/agent-performance-audit·opened 🎯 Changes#
Stacked on #8258 and targeting agents-redone.
Adds scoped performance-review guidance for evidence, coverage, finding capture, and benchmark provenance. Webpack checks cover build phases, production mode versus host environment, source maps, cache invalidation, multiple compiler instances, and emitted chunks/side effects.
Adds lifecycle checks for disabled features, router replacement, hydration scheduling, script execution, devtools, and RSC diagnostics. Keeps the full bundle measurement and attribution workflow while replacing mandatory commits/stashing and a fixed reviewer count with isolated comparisons and explicit authority.
✅ Checklist#
- I have followed the steps in the Contributing guide.
- I have tested code changes locally with the relevant test commands, or tests do not apply to this pull request.
- I fully understand the code in this pull request, including any code generated with AI assistance.
🚀 Release Impact#
- This change affects published code, and I have generated a changeset.
- This change is docs/CI/dev-only (no release).
Summary by CodeRabbit#
- Documentation
- Updated repository guidance for troubleshooting, testing, formatting, and running project tools.
- Added performance review guidance covering benchmarks, supported build tools, runtime behavior, and deployment checks.
- Expanded testing guidance for hot updates, route changes, and test discovery.
- Updated bundle-size review guidance with instructions for comparing isolated builds and checking shipped output.
- 1
github-actions[bot](GitHub profile, opens in a new tab) added labelspackage: router-plugin
github-actions[bot](GitHub profile, opens in a new tab) added labelspackage: history
github-actions[bot](GitHub profile, opens in a new tab) added labelspackage: router-devtools-core
github-actions[bot](GitHub profile, opens in a new tab) added labelspackage: start-plugin-core
github-actions[bot](GitHub profile, opens in a new tab) added labelspackage: react-start-rsc
🚀 Changeset Version Preview#
No changeset entries found. Merging this PR will not cause a version bump for any packages.
View your CI Pipeline Execution ↗ for commit b84762f7247ac2d4d33403b3a650288e3a59ab60
Command Status Duration Result nx affected --targets=test:eslint,test:unit,tes...✅ Succeeded 13m 9s View ↗ nx run-many --target=build --exclude=examples/*...✅ Succeeded 1m 49s View ↗
☁️ Nx Cloud last updated this comment at
2026-10-24 22:08:48UTCBundle Size Benchmarks#
This pull request does not affect bundle size in any measured scenario.
More templates
- tanstack-router-solid-example-authenticated-routes
- tanstack-router-solid-example-authenticated-routes-firebase
- tanstack-router-solid-example-basic
- tanstack-router-solid-example-basic-default-search-params
- tanstack-router-solid-example-basic-devtools-panel
- tanstack-router-solid-example-basic-file-based
- tanstack-router-solid-example-basic-non-nested-devtools
- tanstack-router-solid-example-basic-solid-query
- tanstack-router-solid-example-basic-solid-query-file-based
- tanstack-router-solid-example-basic-ssr-file-based
- tanstack-router-solid-example-basic-ssr-streaming-file-based
- tanstack-router-solid-example-basic-virtual-file-based
- tanstack-router-solid-example-basic-virtual-inside-file-based
- tanstack-router-solid-example-deferred-data
- tanstack-router-solid-i18n-paraglide
- tanstack-router-solid-example-kitchen-sink
- tanstack-router-solid-example-kitchen-sink-file-based
- tanstack-router-solid-example-kitchen-sink-solid-query
- tanstack-router-solid-example-kitchen-sink-solid-query-file-based
- tanstack-router-solid-example-large-file-based
- tanstack-router-solid-example-location-masking
- tanstack-router-solid-example-navigation-blocking
- tanstack-router-solid-example-quickstart
- tanstack-router-solid-example-quickstart-esbuild-file-based
- tanstack-router-solid-example-quickstart-file-based
- tanstack-router-solid-example-quickstart-rspack-file-based
- tanstack-router-solid-example-quickstart-webpack-file-based
- @tanstack/router-solid-mono-simple
- router-solid-mono-simple-lazy
- router-solid-monorepo-solid-query
- tanstack-router-solid-example-scroll-restoration
- tanstack-solid-router-search-validator-adapters
- tanstack-solid-start-example-basic
- tanstack-solid-start-example-basic-auth
- tanstack-solid-start-example-basic-authjs
- tanstack-solid-start-example-basic-cloudflare
- tanstack-solid-start-example-basic-netlify
- tanstack-solid-start-example-basic-nitro
- tanstack-start-example-basic-solid-query
- tanstack-solid-start-example-basic-static
- tanstack-solid-start-bun-hosting
- tanstack-solid-start-example-convex-better-auth
- tanstack-solid-start-example-counter
- tanstack-solid-start-i18n-paraglide
- tanstack-solid-start-example-large
- tanstack-solid-start-streaming-data-from-server-functions
- tanstack-solid-start-example-supabase-basic
- tanstack-solid-start-tailwind-v4
- tanstack-router-solid-example-view-transitions
- tanstack-router-solid-example-with-framer-motion
- tanstack-router-solid-example-with-trpc
- tanstack-router-vue-example-basic-jsx
- tanstack-router-vue-example-basic-file-based-jsx
- tanstack-router-vue-example-basic-file-based-sfc
- tanstack-router-react-example-authenticated-routes
- tanstack-router-react-example-authenticated-routes-firebase
- tanstack-router-react-example-basic
- tanstack-router-react-example-basic-default-search-params
- tanstack-router-react-example-basic-devtools-panel
- tanstack-router-react-example-basic-file-based
- tanstack-router-react-example-basic-non-nested-devtools
- tanstack-router-react-example-react-query
- tanstack-router-react-example-basic-react-query-file-based
- tanstack-router-react-example-basic-ssr-file-based
- tanstack-router-react-example-basic-ssr-streaming-file-based
- tanstack-router-react-example-basic-virtual-file-based
- tanstack-router-react-example-basic-virtual-inside-file-based
- tanstack-router-react-example-deferred-data
- tanstack-router-i18n-paraglide
- tanstack-router-react-example-kitchen-sink
- tanstack-router-react-example-kitchen-sink-file-based
- tanstack-router-react-example-kitchen-sink-react-query
- tanstack-router-react-example-kitchen-sink-react-query-file-based
- tanstack-router-react-example-large-file-based
- tanstack-router-react-example-location-masking
- tanstack-router-react-example-navigation-blocking
- tanstack-router-react-example-quickstart
- tanstack-router-react-example-quickstart-esbuild-file-based
- tanstack-router-react-example-quickstart-file-based
- tanstack-router-react-example-quickstart-rspack-file-based
- tanstack-router-react-example-quickstart-webpack-file-based
- router-monorepo-react-query
- router-mono-simple
- router-mono-simple-lazy
- tanstack-router-react-example-scroll-restoration
- tanstack-search-validator-adapters
- tanstack-start-example-bare
- tanstack-start-example-basic
- tanstack-start-example-basic-auth
- tanstack-router-react-example-basic-authjs
- tanstack-start-example-basic-cloudflare
- tanstack-start-example-basic-react-query
- tanstack-start-example-basic-rsbuild
- tanstack-start-example-basic-static
- tanstack-start-bun-hosting
- tanstack-start-example-clerk-basic
- tanstack-start-example-convex-trellaux
- tanstack-start-example-counter
- tanstack-start-i18n-paraglide
- tanstack-start-example-large
- tanstack-start-example-material-ui
- tanstack-start-example-next-migration
- tanstack-start-example-rscs
- tanstack-start-streaming-data-from-server-functions
- tanstack-start-example-supabase-basic
- tanstack-start-tailwind-v4
- tanstack-start-example-trellaux
- tanstack-start-example-workos
- tanstack-router-react-example-view-transitions
- tanstack-router-react-example-with-framer-motion
- tanstack-router-react-example-with-trpc
- tanstack-router-react-example-with-trpc-react-query
@tanstack/arktype-adapter
npm i https://pkg.pr.new/@tanstack/arktype-adapter@8267@tanstack/eslint-plugin-router
npm i https://pkg.pr.new/@tanstack/eslint-plugin-router@8267@tanstack/eslint-plugin-start
npm i https://pkg.pr.new/@tanstack/eslint-plugin-start@8267@tanstack/history
npm i https://pkg.pr.new/@tanstack/history@8267@tanstack/react-router
npm i https://pkg.pr.new/@tanstack/react-router@8267@tanstack/react-router-devtools
npm i https://pkg.pr.new/@tanstack/react-router-devtools@8267@tanstack/react-router-ssr-query
npm i https://pkg.pr.new/@tanstack/react-router-ssr-query@8267@tanstack/react-start
npm i https://pkg.pr.new/@tanstack/react-start@8267@tanstack/react-start-client
npm i https://pkg.pr.new/@tanstack/react-start-client@8267@tanstack/react-start-rsc
npm i https://pkg.pr.new/@tanstack/react-start-rsc@8267@tanstack/react-start-server
npm i https://pkg.pr.new/@tanstack/react-start-server@8267@tanstack/router-cli
npm i https://pkg.pr.new/@tanstack/router-cli@8267@tanstack/router-core
npm i https://pkg.pr.new/@tanstack/router-core@8267@tanstack/router-devtools
npm i https://pkg.pr.new/@tanstack/router-devtools@8267@tanstack/router-devtools-core
npm i https://pkg.pr.new/@tanstack/router-devtools-core@8267@tanstack/router-generator
npm i https://pkg.pr.new/@tanstack/router-generator@8267@tanstack/router-plugin
npm i https://pkg.pr.new/@tanstack/router-plugin@8267@tanstack/router-ssr-query-core
npm i https://pkg.pr.new/@tanstack/router-ssr-query-core@8267@tanstack/router-utils
npm i https://pkg.pr.new/@tanstack/router-utils@8267@tanstack/router-vite-plugin
npm i https://pkg.pr.new/@tanstack/router-vite-plugin@8267@tanstack/solid-router
npm i https://pkg.pr.new/@tanstack/solid-router@8267@tanstack/solid-router-devtools
npm i https://pkg.pr.new/@tanstack/solid-router-devtools@8267@tanstack/solid-router-ssr-query
npm i https://pkg.pr.new/@tanstack/solid-router-ssr-query@8267@tanstack/solid-start
npm i https://pkg.pr.new/@tanstack/solid-start@8267@tanstack/solid-start-client
npm i https://pkg.pr.new/@tanstack/solid-start-client@8267@tanstack/solid-start-server
npm i https://pkg.pr.new/@tanstack/solid-start-server@8267@tanstack/start-client-core
npm i https://pkg.pr.new/@tanstack/start-client-core@8267@tanstack/start-fn-stubs
npm i https://pkg.pr.new/@tanstack/start-fn-stubs@8267@tanstack/start-plugin-core
npm i https://pkg.pr.new/@tanstack/start-plugin-core@8267@tanstack/start-server-core
npm i https://pkg.pr.new/@tanstack/start-server-core@8267@tanstack/start-static-server-functions
npm i https://pkg.pr.new/@tanstack/start-static-server-functions@8267@tanstack/start-storage-context
npm i https://pkg.pr.new/@tanstack/start-storage-context@8267@tanstack/valibot-adapter
npm i https://pkg.pr.new/@tanstack/valibot-adapter@8267@tanstack/virtual-file-routes
npm i https://pkg.pr.new/@tanstack/virtual-file-routes@8267@tanstack/vue-router
npm i https://pkg.pr.new/@tanstack/vue-router@8267@tanstack/vue-router-devtools
npm i https://pkg.pr.new/@tanstack/vue-router-devtools@8267@tanstack/vue-router-ssr-query
npm i https://pkg.pr.new/@tanstack/vue-router-ssr-query@8267@tanstack/vue-start
npm i https://pkg.pr.new/@tanstack/vue-start@8267@tanstack/vue-start-client
npm i https://pkg.pr.new/@tanstack/vue-start-client@8267@tanstack/vue-start-server
npm i https://pkg.pr.new/@tanstack/vue-start-server@8267@tanstack/zod-adapter
npm i https://pkg.pr.new/@tanstack/zod-adapter@8267commit:
b84762fMerging this PR will degrade performance by 8.47%#
2 warnings, 1 note
:warning: 36 benchmarks are dominated by system calls
System calls cannot be simulated consistently and are left out of the measure. The reported value understates the real cost. Switch to the Walltime instrument to measure them.
:warning: Base and head ran on different runner types
Some benchmarks with significant performance changes were compared across different runner types, so the changes might not come from the code. Run base and head on the same runner type, or use CodSpeed Macro Runners for more stable results.
Learn more about Macro Runners
Open the report in CodSpeed to investigate
:information_source: 3 benchmarks have no flamegraph
The flamegraph wasn't generated: most of the time was spent in runtime internals, which would leave nothing useful to analyze.
❌ 1regressed benchmark✅ 193untouched benchmarks⏩ 3skipped benchmarks1Warning
Please fix the performance issues or acknowledge them on CodSpeed.
Performance Changes#
Mode Benchmark BASEHEADEfficiency ❌ Memory mem client navigation-churn (solid)107.4 KB 117.3 KB -8.47% Tip
Investigate this regression by commenting
@codspeedbot fix this regressionon this PR, or directly use the CodSpeed MCP with your agent.
Comparingdocs/agent-performance-audit(b84762f) withmain(6b9fe6d)[^unexpected-base]Footnotes#
-
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. ↩
-
- skills/bundle-size-optimization/SKILL.md line 3Outdated@@ -1,3 +1,3 @@11 ---22 name: bundle-size-optimization3-description: Use when working in this repository on JS bundle size, gzip regressions, benchmark scenarios, source attribution, treeshaking, dead code elimination, or Rolldown annotations.3+description: Use when working in this repository on JS bundle size, gzip regressions, benchmark scenarios, source attribution, treeshaking, dead code elimination, or bundler annotations, including Webpack.
mention both rolldown and webpack or none of them
⚠️ No Changeset found#
Latest commit: b84762f7247ac2d4d33403b3a650288e3a59ab60
Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.
This PR includes no changesets
When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types
Click here to learn what changesets are, and how to add one.
Click here if you're a maintainer who wants to add a changeset to this PR
Sign in to join this conversation.
No actionable comments were generated in the recent review.
9ae868c6-a93a-41c7-822b-0a1de31af89fReviewing files that changed from the base of the PR and between 50f0728b58a1743a6aab52e3235d5a736fe4eb8f and b84762f7247ac2d4d33403b3a650288e3a59ab60.
AGENTS.mdskills/bundle-size-optimization/SKILL.mdIncluded review availability: This review used your included allowance. Your plan provides up to 10 included reviews per hour; 7 remain after this review.
Walkthrough
The pull request updates repository and package guidance, revises the bundle-size optimization skill, and adds a performance-review skill with procedures for selecting checks, comparing measurements, and validating runtime and build behavior.
Changes: Review and Validation Guidance
AGENTS.md,e2e/AGENTS.md,packages/AGENTS.md,packages/router-plugin/AGENTS.mdskills/performance-review/SKILL.md,skills/performance-review/references/checks.mdskills/bundle-size-optimization/SKILL.mdEstimated code review effort: 2 (Simple) | ~10 minutes
Change: Other
Possibly related issues
Possibly related PRs
Suggested labels:
documentationSuggested reviewers:
schiller-manuelMerge Risk:
Minimal · up to
b8476No actionable merge-blocking risk is established in the documentation and guidance changes.
Pre-merge checks:
4
Full details: Title check
Explanation
The title "docs: extend agent performance and Webpack guidance" matches the main change. The PR adds performance-review guidance (new skill and references) and extends the bundle-size and AGENTS.md guidance with Webpack-specific checks. The title is specific and follows the conventional-commit style. It omits the replacement of commit/stash steps and the benchmark-provenance changes, but those are secondary details.
Full details: Docstring Coverage
Explanation
No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0 files. (2 skipped: 2 unsupported.)
Finishing Touches
🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.
❤️ Share