What problem does it solve?
This Skill reduces the risk of framework and dependency upgrades by enforcing an evidence-first process, incremental execution, rollback planning, and post-upgrade verification.
Core Features & Use Cases
- Upgrade assessment and planning: Audits current versions, researches official migration guides and changelogs, and produces a structured upgrade plan with prerequisites, steps, and a timeline.
- Safe execution and change management: Uses a dedicated branch, snapshots dependencies/lockfiles, applies an upgrade order (framework → official packages → third-party → dev deps → custom/config → data migrations), and avoids mixing upgrades with feature work.
- Verification and data migration guardrails: Defines post-upgrade acceptance gates, smoke/E2E expectations, and data migration rules (idempotency, backups, production-size testing, validation, rollback readiness).
Use case: upgrade a Next.js or Laravel application across a major version while handling breaking changes and ensuring tests and critical flows still work before deployment.
Quick Start
Use this skill to produce a full migration report and step-by-step upgrade plan for upgrading your app from version X to version Y, including breaking changes, risk assessment, and a rollback strategy.