300-frameworks-spring-boot-create-project

name	300-frameworks-spring-boot-create-project
description	Use when you need to create a new Maven-based Spring Boot 4.0.x project using SDKMAN-managed Java and Spring Boot CLI tooling. This should trigger for requests such as Create a Spring Boot Maven project; Bootstrap Spring Boot project with SDKMAN; Generate a new Spring Boot service; Create Spring Boot 4 Maven project; Scaffold Spring Boot service with Java 25. Part of Plinth Toolkit
license	Apache-2.0
metadata	{"author":"Juan Antonio Breña Moral","version":"0.18.0"}

Create Spring Boot Maven Project

Create a new Spring Boot Maven project through SDKMAN-managed tooling, aligned with Java 25 and the repository's Spring Boot 4.0.x baseline.

What is covered in this Skill?

• Verify SDKMAN and Java availability before project creation
• Install or select the required Java and Spring Boot CLI candidates through SDKMAN
• Gather project coordinates, package name, Java version, packaging, and dependencies
• Create a Maven project with Spring Initializr-backed Spring Boot CLI commands
• Prefer Maven wrapper commands for validation
• Verify the generated project with Maven before reporting completion

Constraints

Project creation must be explicit, reproducible, and Maven-based.

• PREREQUISITE: Verify SDKMAN is installed with sdk version; if missing, stop and provide setup guidance instead of installing it silently
• JAVA BASELINE: Prefer Java 25 unless the user requests another supported version
• FRAMEWORK BASELINE: Target Spring Boot 4.0.x by default
• BUILD TOOL: Generate a Maven project, not Gradle
• SAFETY: Do not overwrite an existing non-empty target directory without explicit user confirmation
• VERIFY: Run ./mvnw clean verify from the generated project when the Maven wrapper exists; otherwise run mvn clean verify
• BEFORE APPLYING: Read the reference for the full SDKMAN and Spring Boot CLI workflow

When to use this skill

• Create a Spring Boot Maven project
• Bootstrap Spring Boot project with SDKMAN
• Generate a new Spring Boot service
• Create Spring Boot 4 Maven project
• Scaffold Spring Boot service with Java 25

Workflow

1. Read reference and gather project inputs

Read references/300-frameworks-spring-boot-create-project.md, then gather project directory, group, artifact, package name, Java version, packaging, and initial dependencies.

2. Verify SDKMAN-managed tooling

Check SDKMAN, Java, and Spring Boot CLI availability. Install or switch candidates only after confirming the intended versions with the user.

3. Create the Maven project

Use Spring Boot CLI project creation backed by Spring Initializr, making Maven the selected build tool and Spring Boot 4.0.x the default baseline.

4. Verify and report

Run Maven verification in the generated project and summarize commands used, selected options, generated path, and any follow-up setup.

Reference

For detailed guidance, examples, and constraints, see references/300-frameworks-spring-boot-create-project.md.