# /upgrade - Dependency and Framework Upgrade

> Bump Next/React/Node/ORM. Tests stay green.

Canonical: https://www.agentickit.co/commands/upgrade
Last updated: 2026-11-18

Reads changelogs, bumps lockfiles, fixes breaking APIs, writes a rollback note. No feature work mixed in.

**Usage:** `Use for planned upgrades or a CI break from a dependency.`

## Pipeline
1. migration-engineer reads upstream breaking changes
2. Bump versions and lockfile
3. Fix compile and tests
4. Write docs/engineering/upgrade-....md

## Output files
- `docs/engineering/upgrade-....md`
- `package.json`
- `package-lock.json`

**Claude Code frontmatter:** `argument-hint: [package or framework and target version]` · `model: inherit`

## Related
- [migration-engineer](https://www.agentickit.co/agents/migration-engineer)
- [test-automator](https://www.agentickit.co/agents/test-automator)
- [devops-engineer](https://www.agentickit.co/agents/devops-engineer)
- [dependency-upgrades](https://www.agentickit.co/skills/dependency-upgrades)
- [testing-vitest](https://www.agentickit.co/skills/testing-vitest)
- [typescript-strict](https://www.agentickit.co/skills/typescript-strict)
