# Upgrade Rspack > Upgrade `@rspack/core` in this repository, validate compatibility, and prepare a pull request. - Skill: `web-infra-dev/upgrade-rspack` (Agent Skill) - Install (CLI): `npx skillmds@latest add web-infra-dev/upgrade-rspack` - Raw SKILL.md: https://api.skillmd.com/api/skills/web-infra-dev/upgrade-rspack/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: web-infra-dev (https://skillmd.com/u/web-infra-dev) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/web-infra-dev/upgrade-rspack --- # Upgrade Rspack Resolve the requested target version; ask if it is unspecified and cannot be inferred from the request. If the user limits the task to local changes or inspection, honor that scope. ## Dependency update - Inspect the branch and worktree. Preserve unrelated edits and use an isolated checkout if needed. Create a task branch before committing when on the default branch; never commit directly to it. - Change the default catalog's `@rspack/core` entry in `pnpm-workspace.yaml` to `~`, preserving package dependencies as `catalog:`. - Run `pnpm update @rspack/core --recursive` to update dependencies and the lockfile. A separate install is only needed if dependency resolution or installation remains incomplete. - Review the catalog and lockfile diff for unintended dependency changes. If already at the requested version with no changes, report that instead of creating an empty commit or PR. ## Validation Rspack affects the entire build pipeline, so run `pnpm build`, `pnpm test`, and `pnpm e2e` once for the upgrade. Investigate failures and fix compatibility issues within the requested scope, then rerun the affected checks. Rebuild when source changes require fresh outputs. Do not commit or create the PR while required checks remain failed or incomplete. Report an unresolved blocker with its evidence; ask only when resolution requires a scope or compatibility decision from the user. ## Pull request Commit only the task changes, push the task branch, and create the PR. Read `.github/PULL_REQUEST_TEMPLATE.md` when drafting the description and follow its current headings and guidance. Prefer the Codex GitHub connector when available; otherwise use `gh`. Consult [pr-creator](../pr-creator/SKILL.md) only when additional PR guidance is needed. Use: - Commit and PR title: `feat(deps): update @rspack/core to ` - Explain why the upgrade matters to Rsbuild using verified upstream changes, and describe the update to `@rspack/core` at `` and any relevant compatibility changes. - Include the upstream release link: `https://github.com/web-infra-dev/rspack/releases/tag/v`.