dependency-upgrade-scout

name	dependency-upgrade-scout
description	Plan safe dependency upgrades by identifying version jumps, breaking changes, migration steps, and validation needs. Use when upgrading libraries, frameworks, or runtimes.

Dependency Upgrade Scout

Overview

Plan safe dependency upgrades by identifying version jumps, breaking changes, migration steps, and validation needs.

Core Workflow

1. Gather goals, constraints, current state, and the relevant systems or stakeholders involved.
2. Identify the main options, dependencies, risks, and sequencing constraints before proposing a path.
3. Build a staged plan, comparison, or checklist that makes tradeoffs explicit instead of hiding them.
4. Attach the validation, rollback, or decision checkpoints needed to execute safely.

Deliver

• A staged plan, scorecard, or checklist that can actually be executed.
• The assumptions, tradeoffs, and blockers that matter most.
• Clear next actions, decision points, and validation steps.

Guardrails

• Do not collapse risky work into a single step when sequencing matters.
• Keep assumptions explicit and highlight missing information early.
• Prefer reversible steps and clear checkpoints when the task has operational risk.
• Prefer repository evidence, command output, and nearby tests over vague intuition.