What problem does it solve?
It solves the slow, error-prone setup of modern Java service projects by providing a consistent structure and baseline configuration for frameworks like Spring Boot, Quarkus, or Micronaut.
Core Features & Use Cases
- Framework-ready project structure: organizes code into clear layers (web, message, domain, infrastructure, core) to support long-term maintainability.
- Modern Java best practices: recommends records, sealed interfaces, pattern matching, and (when applicable) virtual threads and structured concurrency patterns.
- Production-minded configuration & conventions: includes essential settings such as
spring.jpa.open-in-view: false, graceful shutdown, actuator/health exposure, and sensible Jackson defaults.
- Quality-focused testing guidance: suggests JUnit 5, AssertJ, Testcontainers, and ArchUnit to validate architecture boundaries.
- Use case example: when starting an order-processing API, apply the structure and configuration so controllers, domain logic, persistence, and messaging are separated and testable from day one.
Quick Start
Use the java-project-setup skill to create a new Java 21+ service scaffold using the recommended package structure, production-ready configuration conventions, and the suggested testing approach.
