Upgrade Breaking Change Navigator

Plan and execute risky Spring Boot, Spring Framework, Kotlin, Gradle, JDK, and major dependency upgrades with explicit compatibility checkpoints and rollback thinking. Use when preparing or diagnosing a major version jump, navigating `javax` to `jakarta`, K2 adoption, plugin compatibility, auto-configuration drift, behavior changes in Hibernate or Security, or project-specific upgrade sequencing.

398 stars 35 forksSecurity

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add JetBrains/skills --skill upgrade-breaking-change-navigator
Manual install
git clone --depth 1 https://github.com/JetBrains/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/upgrade-breaking-change-navigator ~/.claude/skills/upgrade-breaking-change-navigator

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Upgrade Breaking Change Navigator

Source mapping: Tier 3 specialized skill derived from `Kotlin_Spring_Developer_Pipeline.md` (`SK-22`).

## Mission

Turn a risky platform upgrade into a controlled sequence of small, verifiable moves.
Optimize for incremental confidence, not for a single giant leap that hides the source of breakage.

## Read First

- Current Gradle wrapper, Kotlin plugin, Spring Boot plugin, JDK, and key dependency versions.
- Version catalogs, convention plugins, and BOM ownership.
- Build failures, test failures, runtime startup failures, and deprecation reports.
- The actual libraries and features in use: Security, Data JPA, WebFlux, AOT/native, messaging, serialization, cloud config.
- Official upgrade notes when available.

## Upgrade Strategy

1. Identify the target version and the last known good current version.
2. Identify mandatory intermediate steps. Do not skip major lines casually.
3. Separate upgrade layers:
   - JDK
   - Gradle wrapper
   - Kotlin plugin and compiler
   - Spring Boot and Spring Framework
   - ecosystem libraries
4. Upgrade one authority at a time whenever possible.
5. After each step, verify:
   - dependency resolution
   - compile
   - tests
   - startup smoke
6. Record breakages by layer so the root cause stays attributable.

## Advanced Upgrade Hotspots

- `javax.*` to `jakarta.*` is both source migration and dependency compatibility migration.
Read the full skill on GitHub

Details

Skill name
upgrade-breaking-change-navigator
Path
upgrade-breaking-change-navigator/SKILL.md
Repo updated
21 October 2026

FAQ

What does the Upgrade Breaking Change Navigator skill do?

Plan and execute risky Spring Boot, Spring Framework, Kotlin, Gradle, JDK, and major dependency upgrades with explicit compatibility checkpoints and rollback thinking. Use when preparing or diagnosing a major version jump, navigating `javax` to `jakarta`, K2 adoption, plugin compatibility, auto-configuration drift, behavior changes in Hibernate or Security, or project-specific upgrade sequencing.

How do I install the Upgrade Breaking Change Navigator skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add JetBrains/skills --skill upgrade-breaking-change-navigator. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Upgrade Breaking Change Navigator popular?

It lives in JetBrains/skills, which has 398 GitHub stars and 35 forks.

Related skills

Deploy to Vercel

398

JetBrains/skills

Deploy applications and websites to Vercel. Use when the user requests deployment actions like "deploy my app", "deploy and give me the link", "push this live", or "create a preview deployment".

DevOps & CloudIn 2 lists35

Vercel React Native Skills

398

JetBrains/skills

React Native and Expo best practices for building performant mobile apps. Use when building React Native components, optimizing list performance, implementing animations, or working with native modules. Triggers on tasks involving React Native, Expo, mobile performance, or native platform APIs.

Mobile DevelopmentIn 2 lists35

Vitest

398

JetBrains/skills

Vitest fast unit testing framework powered by Vite with Jest-compatible API. Use when writing tests, mocking, configuring coverage, or working with test filtering and fixtures.

Testing & QA35

Dep Lib Review

423

mizchi/skills

Periodic dependency review for Node.js/pnpm projects — outdated package triage, security audit, update batching strategy (patch/minor/major), validation checklist. Run monthly or before major releases. Use when asked to review or update dependencies in a repo.

Security

Spring Security Configurator Auditor

398

JetBrains/skills

Design and audit Spring Security configurations for Kotlin plus Spring services, including filter chains, JWT or OAuth2 resource server setup, method security, CORS, CSRF rationale, and public endpoint exposure. Use when adding or reviewing authentication and authorization, narrowing access rules, validating token handling, or checking for insecure defaults and accidental exposure.

Security35

Frontend Review Security

423

mizchi/skills

Use when conducting a frontend security review — static analysis (risky HTML patterns, env var exposure), authentication/authorization audit (token storage, route guards, logout), and AI self-penetration testing. Runs `scripts/audit-security.sh`. For CVE triage and deprecated library detection, use `frontend-review-deps`.

Security

Browse the most popular Claude skills, all security skills, or write your own with the skills generator.