Java Architect guides Claude through Spring Boot work in six steps: analyze the architecture, design the domain, implement services, tune the data layer, apply security and configuration, and verify quality. Steps name the build command to run, such as ./mvnw verify, and what to check when tests fail or coverage falls below the target.
Five reference files cover Spring Boot setup, reactive WebFlux, JPA optimization, Spring Security and testing patterns.
What You Get
- Domain models, services, repositories and REST controllers laid out in a clean architecture
- WebFlux endpoints with Project Reactor and R2DBC repositories
- JPA entities, DTO projections, batch operations and second-level cache settings
- Spring Security with a JWT filter, OAuth2 resource server setup and method-level checks
- JUnit 5, Mockito and TestContainers tests, with a target of 85 percent coverage
Common Use Cases
- Starting a Spring Boot 3 microservice with migrations and OpenAPI docs
- Tuning slow JPA queries and removing N+1 fetches
- Adding OAuth2 and JWT security to a REST API
- Writing a reactive WebFlux service on R2DBC
- Raising test coverage with TestContainers integration tests
What Makes It Unique
The workflow ties each step to a Maven or Gradle command and a recovery action: read the Hibernate SQL log when integration tests fail, check the SecurityFilterChain bean order when security tests fail, and read the JaCoCo report when coverage is short. The constraints also forbid blocking calls in reactive code and deprecated Spring APIs.
Under The Hood
The skill is a SKILL.md with five reference files and no scripts, and the references load by topic. The workflow tells the agent to run ./mvnw verify or ./gradlew check and to read the JaCoCo report, so it uses the shell and writes Java source, configuration and test files. The examples read database passwords and the JWT secret from environment variables, hash passwords, issue and verify tokens, and point a WebClient and an OAuth2 resource server at external URLs. The testing reference starts database containers. The skill does not tell the agent to browse the web.