Compatible with Cursor, Claude Code, Cline, Roo Code, Antigravity

Major Framework & Dependency Upgrade Migration

Generate a step-by-step upgrade strategy for major framework shifts (e.g. Next 12 to 15, Spring 2 to 3).

MigrationSpring BootNext.jsReactDependenciesRefactoring

v1.0.0 · Updated 2026-08

Skill Objective

Execute safe, step-by-step framework migrations with AST codemods, breaking change inventories, and stepping-stone upgrade paths.

Execution Workflow Procedure

Ordered steps the coding agent executes when performing this skill.

Breaking Change & Deprecation Audit

Catalog all removed APIs, configuration property renames, and required runtime/JDK bumps.

Execute Automated Codemods

Run automated AST codemod recipes (OpenRewrite, next-codemod) to rewrite 90% of imports and namespace transitions.

Phased Execution & Verification

Execute compiler fixes, update configuration files, and run full test suites across migration milestones.

Agent Safety Guardrails & Anti-Hallucination Rules

DO NOT skip intermediate LTS versions when upgrading across multiple major versions.
DO NOT upgrade dependencies without validating compatibility in lockfiles.

Expected Output Format

Phased checklist with codemod commands and compatibility matrices.

📋 Breaking Changes Inventory: List of removed/deprecated APIs.

🛠️ Execution Checklist & Commands: Step-by-step upgrade instructions.

Domain Verification Checks

Namespace Transition: Tracks major package updates (e.g. javax.* to jakarta.*).

Automated Codemod Application: Uses OpenRewrite/jscodeshift for automated bulk changes.

Zero Test Regressions: Verifies test suite remains green post-migration.

Example Agent Invocations

"Create a migration plan to upgrade our Spring Boot 2.7 app to Spring Boot 3.3 (Java 21)."

"Plan the migration of our Next.js 12 Pages Router app to Next.js 15 App Router."

Install / Configure This Skill

# Place in .cursorrules or create .cursor/rules/major-framework-upgrade-migration.mdc
# Trigger: Whenever you perform major framework & dependency upgrade migration

---
name: major-framework-upgrade-migration
description: Plan and execute major framework upgrades using automated codemods and phased verification.
version: 1.0.0
compatibility: [Cursor, Claude Code, Cline, Roo Code, Antigravity]
---

# Major Framework & Dependency Upgrade Migration

## Objective
Modernize legacy framework versions safely using automated codemods and stepping-stone upgrade paths.

## Workflow
1. **Deprecation Audit**: Inventory all breaking changes and removed APIs between versions.
2. **Automated Codemods**: Run OpenRewrite or next-codemod to automate bulk import and configuration rewrites.
3. **Phased Verification**: Fix compiler errors, update property configs, and verify test suites.

Complementary Agent Prompt

Need a quick one-time prompt for chat?

Try the Deprecated Dependency & Framework Upgrade Migration Plan — a lightweight version designed for 1-click copying directly into Claude, ChatGPT, or Cursor chat.

View Prompt