migration-upgrade

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.