upgrade-breaking-change-navigator

Plan staged Kotlin/Spring upgrades with compatibility checkpoints and rollback criteria.

302|22|Updated Feb 12, 2026
One-click install
npx skills add https://github.com/JetBrains/skills --skill upgrade-breaking-change-navigator-jetbrains
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: upgrade-breaking-change-navigator
Source: https://github.com/JetBrains/skills/tree/main/upgrade-breaking-change-navigator
Command: npx skills add https://github.com/JetBrains/skills --skill upgrade-breaking-change-navigator-jetbrains

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps teams plan and coordinate high-risk platform upgrades (Spring Boot, Spring Framework, Kotlin, Gradle, JDK, and major dependencies) with explicit compatibility checkpoints and rollback thinking to minimize downtime and regressions.

Core Features & Use Cases

  • Provides a structured upgrade pathway across toolchains and libraries (JDK, Gradle, Kotlin plugin, Spring Boot/Framework, and related dependencies).
  • Establishes stepwise validation gates (build, test, startup, deprecation reports) after each upgrade increment.
  • Supports risk-aware decision making for namespace migrations (javax to jakarta) and ecosystem compatibility hotspots.

Quick Start

Outline a staged upgrade plan for my project including target versions, intermediate steps, and rollback criteria.

Frequently Asked Questions about upgrade-breaking-change-navigator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I plan a major Spring Boot upgrade across multiple framework versions?

Plan major Spring Boot upgrades by defining a staged upgrade pathway across toolchains, establishing stepwise validation gates for builds and tests after each increment, and documenting rollback criteria to minimize downtime and regressions.

What is the best way to handle javax to jakarta namespace migration during a platform upgrade?

Handle javax to jakarta namespace migrations by applying risk-aware decision making within your upgrade pathway, ensuring ecosystem compatibility hotspots are addressed at the correct stage with validation gates verifying startup and deprecation reports before proceeding.

Can I coordinate JDK, Gradle, and Kotlin version jumps in a single upgrade plan?

Yes, you can coordinate JDK, Gradle, and Kotlin version jumps by defining an ordered upgrade path with BOM-driven dependency management, ensuring plugin compatibility and explicit verification gates after each toolchain increment to prevent build failures.

How do I set rollback criteria for risky framework and toolchain upgrades?

Set rollback criteria for risky framework upgrades by documenting explicit compatibility checkpoints and validation gate thresholds, ensuring that any failed build, test, or startup verification triggers a documented rollback to the last stable configuration.

When do I need BOM-driven upgrades for large Kotlin projects?

You need BOM-driven upgrades for large Kotlin projects when executing major version jumps across JDK, Gradle, and Spring frameworks, requiring an ordered upgrade path to manage ecosystem compatibility and plugin dependencies safely.

Does upgrading Gradle and the Kotlin plugin require intermediate validation steps?

Upgrading Gradle and the Kotlin plugin requires intermediate validation steps to ensure ecosystem compatibility, using stepwise validation gates to verify builds, tests, and startup reports after each incremental toolchain change before moving forward.