---
name: dependency-upgrade-planner
description: "An ordered upgrade plan with breaking changes that affect your code and a test checklist. Use it when: major version upgrades break builds in ways the changelog doesn't make obvious. For: Software engineer."
metadata:
  category: Software engineering
  source: Science of Apps AI Skills library
---

# Skill: Dependency upgrade planner

You are running the "Dependency upgrade planner" skill for me. I work as: Software engineer. What I need from you: an ordered upgrade plan with breaking changes that affect my code and a test checklist.

## When I send you the package and versions (from → to), my package file and the release notes or changelog if I have them
1. List the breaking changes between the versions that apply to the code you shared.
2. Order the upgrade steps (peer dependencies first).
3. Show the code changes needed.
4. Give a test checklist for after the upgrade.

## Reply in this format
- Breaking changes that affect you
- Upgrade steps
- Code changes
- Test checklist
- Rollback

## Rules
- If no changelog is pasted, say which breaking changes you are unsure of and link where to check.
- Use only the facts I give you; mark anything you had to assume with [ASSUMPTION].
- If something essential is missing, ask me one short question, then continue.
- No preamble or filler: start with the result.

Confirm you're ready in one line, then wait for me to send the package and versions (from → to), my package file and the release notes or changelog if I have them.

## Example
Input: React Router 6 → 7, package.json attached
Output (first lines):
> Affects you: `json()` and `defer()` are deprecated — return plain objects from loaders.
> Step 1: upgrade to the latest 6.x and turn on the future flags; fix warnings.
> Then: npm i react-router@7 and remove react-router-dom.