spring-boot-migration
/spring-boot-migration
Use when preparing a Spring Boot 3 application for Boot 4, upgrading to Boot 3.5 first, removing deprecated APIs, auditing dependencies, or planning a staged Framework 7 migration.
- Author
- rrezartprebreza ↗
- Repository
- spring-boot-skills ↗
- Licence
- MIT
- Last repository change
- 22.10.2026
Assessment and security
- Files in this package
- 4
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 22.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Use when preparing a Spring Boot 3 application for Boot 4, upgrading to Boot 3.5 first, removing deprecated APIs, auditing dependencies, or planning a staged Framework 7 migration.
Original author description
Use when preparing a Spring Boot 3 application for Boot 4, upgrading to Boot 3.5 first, removing deprecated APIs, auditing dependencies, or planning a staged Framework 7 migration.
How it works
- Establish the baseline
- Prepare for Boot 4
- Migrate dependencies deliberately
- Verify the result
- Examples
- Gotchas
SKILL.md preview
--- name: spring-boot-migration description: > Use when preparing a Spring Boot 3 application for Boot 4, upgrading to Boot 3.5 first, removing deprecated APIs, auditing dependencies, or planning a staged Framework 7 migration. --- # Spring Boot 3 to 4 Migration Migrate in controlled stages. Keep behavior changes separate from the framework upgrade. ## Establish the baseline 1. Upgrade to the latest Boot 3.5 maintenance release. 2. Run unit, slice, integration, startup, and migration tests before changing the major version. 3. Remove Boot 3 deprecations and record all explicitly versioned dependencies. 4. Compare the Boot 3.5 and Boot 4 dependency-management reports. 5. Verify Spring Cloud and other portfolio release-train compatibility independently. ## Prepare for Boot 4 - Require Java 17 or newer; prefer Java 21 for application builds. - Replace `javax.*` remnants with Jakarta APIs before the upgrade. - Remove Undertow assumptions; Boot 4 requires a Servlet 6.1-compatible container. - Inventory Jackson 2 custom modules, serializers, `ObjectMapper` beans, and package imports. - Inventory test annotations, especially `@MockBean`, `@SpyBean`, and implicit MockMvc setup. - Add `spring-boot-properties-migrator` temporarily after changing the Boot version, then remove it. ## Migrate dependencies deliberately Boot 4 is more modular. Prefer dedicated starters over relying on incidental transitive dependencies. Expect dedicated starters for web MVC, security tests, Flyway/Liquibase, and technology-specific tests. Use the classic starters only as a temporary diagnostic bridge, never as the final dependency model. ## Verify the result - Run the application with every supported profile. - Exercise schema migration against a production-like database copy. - Verify JSON contracts, security failures, pagination, and error responses. - Confirm actuator exposure, logging, metrics, and tracing behavior. - Remove the properties migrator and all classic starters before declaring the migration complete. ## Examples - See `examples/good-migration-plan.md` for a staged migration. - See `examples/bad-migration-plan.md` for a risky one-step upgrade. ## Gotchas - Agent jumps from an old Boot 3 minor directly to Boot 4 - upgrade to current 3.5 first. - Agent changes framework versions and business behavior together - isolate the migration diff. - Agent assumes all Boot 3 starters keep the same names and transitive dependencies - audit each one. - Agent leaves `spring-boot-properties-migrator` in production - remove it after configuration cleanup. - Agent treats passing compilation as completion - verify runtime wiring, JSON, security, and tests.
Files in this package (4)
- SKILL.md 3 KB
- agents/openai.yaml 1 KB
- examples/bad-migration-plan.md 1 KB
- examples/good-migration-plan.md 1 KB
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · rrezartprebreza/spring-boot-skills | 100 | MIT |
| rrezartprebreza/spring-boot-skills | 100 | MIT |
Database snapshot: 13.11.2026 · package version b41907dcfa02 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100spring-boot-verify
Verify Spring Boot 4.x projects for correct dependencies, configuration, and migration readiness. Use when analyzing pom.xml, build.gradle, application.yml, discussing Spring Boot project setup, dependency versions, configuration validation, version compatibility, migration to… - 100spring-boot-expert
Expert-level Spring Boot, Spring Framework, REST APIs, and microservices development. Use when the user mentions Java, Spring framework, REST APIs, or microservices, or when the task involves Spring Boot Fundamentals. - 90spring-boot
Use when modifying a Java application that actually uses Spring Boot, Spring MVC, Spring Security, Spring Data, or Spring-managed configuration. - 100spring-boot
Spring Boot 4.x development - REST APIs, JPA, Security, Testing, and Cloud-native patterns. Use for building enterprise Java applications with Spring Boot. - 100spring-boot-testing
Write unit, integration, and slice tests for Spring Boot 3 applications. Use when writing unit tests, integration tests, or slice tests for Spring Boot 3 applications. - 100spring-boot-architecture
Structure Spring Boot 3+ projects with feature packaging and clean layering. Use when structuring Spring Boot 3 projects, defining layers, or applying architecture patterns.