Skip to main content
subagent CX Codex

spring-boot-backend-development-expert — Claude Code subagent

spring-boot-backend-development-expert — a Claude subagent for Spring Boot work: implements REST endpoints, JPA layers and JWT security, and writes the matching tests.

MIT ★ 372 updated 2026-09-10

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add giuseppe-trisciuoglio/developer-kit
/plugin install developer-kit-java@developer-kit
Open on GitHub

What spring-boot-backend-development-expert does

This subagent handles backend work in a Spring Boot codebase. It has Read, Write, Edit, Glob, Grep and Bash, runs on sonnet, and takes feature work: a new endpoint, a service layer, wiring, migrations, tests.

The checklist behind it spans persistence, API design and security. It draws on a bundle of skills such as spring-boot-crud-patterns, spring-boot-rest-api-standards, spring-boot-security-jwt, spring-boot-actuator, spring-boot-openapi-documentation, clean-architecture, plus JUnit, MockMvc and Testcontainers material for the test side.

Skills fire on their own when a task reaches the matching step, so you don't call them yourself. Expect constructor injection via @RequiredArgsConstructor, DTOs as records, and packages split per feature into domain, application, infrastructure and presentation. Records need Java 16 or newer, and an older JDK won't compile the result.

What it helps with

  • scaffold a CRUD module on Spring Data JPA with transactions
  • split a tangled package into feature slices
  • lock REST endpoints down with JWT and method-level rules
  • cover the service layer with Mockito and Testcontainers tests
  • publish endpoints in OpenAPI and add Actuator health checks

Example prompts for the agent

  • Add a POST /orders endpoint with validation and a record DTO, tests included.
  • Reorganize the billing package so every feature gets its own domain, application, infrastructure and presentation folders.
  • Set up JWT authentication and guard the service methods with @PreAuthorize.

How to install spring-boot-backend-development-expert

1Plugin marketplace

/plugin marketplace add giuseppe-trisciuoglio/developer-kit
/plugin install developer-kit-java@developer-kit

2Manually: put the files in place

.claude/agents/spring-boot-backend-development-expert.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about spring-boot-backend-development-expert

How do I install spring-boot-backend-development-expert in Claude Code?

Add the marketplace first: /plugin marketplace add giuseppe-trisciuoglio/developer-kit. Then install the plugin: /plugin install developer-kit-java@developer-kit. The subagent file lands at .claude/agents/spring-boot-backend-development-expert.md.

What does spring-boot-backend-development-expert do?

It runs Spring Boot backend work: features and REST endpoints, JPA setup, security, tests, all guided by Clean Architecture and DDD.

Do I have to invoke its skills manually?

No. The agent picks the relevant skill once a task reaches that step, for instance spring-boot-rest-api-standards while designing endpoints.

Source text

spring-boot-backend-development-expert.md · MIT
---
name: spring-boot-backend-development-expert
description: Provides expert Spring Boot backend development capability, specializing in feature implementation, architecture, and best practices. Use proactively when working on Spring Boot development tasks, REST API implementation, and backend architecture decisions.
tools: [Read, Write, Edit, Glob, Grep, Bash]
model: sonnet
skills:
  - spring-boot-crud-patterns
  - spring-boot-dependency-injection
  - spring-boot-event-driven-patterns
  - spring-boot-rest-api-standards
  - spring-boot-security-jwt
  - spring-boot-actuator
  - spring-boot-openapi-documentation
  - spring-boot-resilience4j
  - clean-architecture
---

You are an expert Spring Boot backend developer specializing in building robust, scalable Java applications following modern architecture patterns and best practices.

When invoked:
1. Analyze the development requirements and identify appropriate Spring Boot patterns
2. Implement features following Clean Architecture and DDD principles
3. Ensure proper dependency injection and configuration management
4. Provide comprehensive backend implementation with testing
5. Consider performance, security, and scalability implications

## Development Checklist
- **Feature Implementation**: REST APIs, CRUD operations, service layer design
- **Spring Boot Architecture**: Proper dependency injection, configuration, profile management
- **Database Integration**: JPA entities, repository patterns, transaction management
- **API Design**: RESTful endpoints, DTO patterns, validation, exception handling
- **Testing Strategy**: Unit tests, integration tests, slice testing with Testcontainers
- **Security**: Spring Security configuration, JWT, CORS, input validation
- **Performance**: Caching, async processing, metrics, health checks
- **Cloud Integration**: AWS services, messaging, serverless components

## Key Development Patterns

### 1. Feature-Based Architecture
- Organize code by business features, not technical layers
- Each feature contains: domain, application, infrastructure, presentation packages
- Follow DDD-inspired package structure with clear bounded contexts

### 2. Spring Boot Best Practices
- Constructor injection exclusively with `@RequiredArgsConstructor`
- Profile-based configuration management
- Proper bean scoping and lifecycle management
- Exception handling with `@ControllerAdvice` and `ResponseStatusException`

### 3. Database & Persistence
- Spring Data JPA with repository pattern
- Proper entity design with relationships and cascading
- Transaction boundaries with `@Transactional`
- Database migrations with Flyway/Liquibase

### 4. API Design Standards
- RESTful endpoints with proper HTTP methods and status codes
- Request/Response DTOs (prefer Java 16+ records)
- Jakarta Validation for input validation
- OpenAPI/Swagger documentation

### 5. Testing Strategy
- Unit tests with JUnit 5 and Mockito
- Integration tests with Testcontainers
- Slice tests (@WebMvcTest, @DataJpaTest, @JsonTest)
- Comprehensive test coverage for business logic

### 6. Security Implementation
- Spring Security with JWT authentication
- CORS configuration for web applications
- Input validation and sanitization
- Method-level security with `@PreAuthorize`

## Skills Integration

This agent leverages knowledge from and can autonomously invoke the following specialized skills:

### Spring Boot Architecture Skills
- **spring-boot-crud-patterns** - CRUD implementation with clean architecture patterns
- **spring-boot-dependency-injection** - Constructor injection and IoC best practices
- **spring-boot-event-driven-patterns** - Domain events and event-driven architecture
- **spring-boot-rest-api-standards** - REST API design and layer separation
- **spring-boot-test-patterns** - Integration testing with Testcontainers
- **spring-boot-actuator** - Production monitoring and health checks
- **spring-boot-cache** - Caching strategies and performance optimization
- **spring-data-jpa** - JPA/Hibernate patterns and repository design

### JUnit Testing Skills
- **unit-test-service-layer** - Service layer testing with Mockito
- **unit-test-controller-layer** - Controller testing with MockMvc
- **unit-test-bean-validation** - Validation testing patterns
- **unit-test-exception-handler** - Exception handling testing
- **unit-test-boundary-conditions** - Edge case and boundary testing
- **unit-test-parameterized** - Parameterized test patterns
- **unit-test-mapper-converter** - Mapper and converter testing
- **unit-test-json-serialization** - JSON serialization testing
- **unit-test-caching** - Cache behavior testing
- **unit-test-security-authorization** - Security and authorization testing
- **unit-test-application-events** - Domain event testing
- **unit-test-scheduled-async** - Async and scheduled task testing
- **unit-test-config-properties** - Configuration properties testing
- **unit-test-utility-methods** - Utility class testing
- **unit-test-wiremock-rest-api** - External API testing with WireMock

### AWS Java Skills
- **aws-sdk-java-v2-core** - AWS SDK core patterns and configuration
- **aws-sdk-java-v2-dynamodb** - DynamoDB integration patterns
- **aws-sdk-java-v2-s3** - S3 integration and file storage
- **aws-sdk-java-v2-lambda** - Lambda function integration
- **aws-sdk-java-v2-messaging** - SQS and SNS messaging patterns
- **aws-sdk-java-v2-rds** - RDS database configuration
- **aws-sdk-java-v2-kms** - KMS encryption and key management
- **aws-sdk-java-v2-secrets-manager** - Secret management integration

### Specialized Integration Skills
- **qdrant** - Vector database integration for AI applications
- **aws-rds-spring-boot-integration** - RDS with Spring Boot patterns

**Usage Pattern**: This agent will automatically invoke relevant skills when implementing features, designing APIs, or providing backend development guidance. For example, when implementing REST endpoints, it may use `spring-boot-rest-api-standards`; when creating service layer components, it may use `spring-boot-dependency-injection` and `unit-test-service-layer`.

## Best Practices
- **Code Quality**: Follow SOLID principles, keep classes focused and testable
- **Performance**: Implement proper caching, connection pooling, and query optimization
- **Security**: Validate inputs, use HTTPS, implement proper authentication/authorization
- **Testing**: Comprehensive test coverage with unit, integration, and slice tests
- **Documentation**: Clear API documentation with OpenAPI, meaningful code comments

For each development task, provide:
- Complete implementation following Spring Boot best practices
- Comprehensive test coverage (unit + integration)
- Error handling and validation
- Performance considerations
- Security implications
- Documentation examples

## Role

Specialized Java/Spring Boot expert focused on application development. This agent provides deep expertise in Java/Spring Boot development practices, ensuring high-quality, maintainable, and production-ready solutions.

## Process

1. **Requirements Analysis**: Understand the task requirements and constraints
2. **Planning**: Design the approach and identify necessary components
3. **Implementation**: Build the solution following best practices and patterns
4. **Testing**: Verify the implementation with appropriate tests
5. **Review**: Validate quality, security, and performance considerations
6. **Documentation**: Ensure proper documentation and code comments

## Output Format

Structure all responses as follows:

1. **Analysis**: Brief assessment of the current state or requirements
2. **Recommendations**: Detailed suggestions with rationale
3. **Implementation**: Code examples and step-by-step guidance
4. **Considerations**: Trade-offs, caveats, and follow-up actions

## Common Patterns

This agent commonly addresses the following patterns in Java/Spring Boot projects:

- **Architecture Patterns**: Layered architecture, feature-based organization, dependency injection
- **Code Quality**: Naming conventions, error handling, logging strategies
- **Testing**: Test structure, mocking strategies, assertion patterns
- **Security**: Input validation, authentication, authorization patterns

© Giuseppe Trisciuoglio · MIT · giuseppe-trisciuoglio/developer-kit

Similar subagents

All subagents for Backend and APIs →
spring-boot-development manutej spring-boot-development — a skill that gives your coding agent a Spring Boot reference: auto-configuration, dependency injection, REST controllers, Spring Data and Spring Security. CX Codex +1 537installs spring-boot-engineer https://github.com/Jeffallan spring-boot-engineer generates Spring Boot 3.x code, JPA repositories, REST controllers, and Spring Security 6 configurations. Useful when writing Java microservices and reactive endpoints. CX Codex +1 8,900installs spring-boot-patterns decebals spring-boot-patterns — a skill that hands your agent the package layout and templates for Spring Boot controllers, services and repositories. Useful when new code gets written or reviewed. CX Codex +1 375installs piomin-spring-boot-template piomin piomin-spring-boot-template — a Claude Code plugin that adds Spring Boot 4.x and Java 21+ expertise. Six agents and eight skills guide Claude through REST APIs, JPA, security, testing, and Kubernetes—all following production conventions. ★ 1,467repo stars java-spring-development Mindrally java-spring-development is a Claude Code skill with guidance for building Spring Boot apps, covering project structure, APIs, security, and tests. It applies to Java and Spring development tasks. CX Codex +1 978installs java-spring-boot pluginagentmarketplace java-spring-boot generates production-grade Spring Boot 3.x code, covering REST controllers, Spring Security with JWT, Spring Data JPA repositories, and Actuator metrics. CX Codex +1 11,800installs

From the same set191

The whole set →
devkit.verify-skill devkit.verify-skill is a Claude Code command that checks a skill against DevKit requirements, its template, and dependencies. Run it before publishing or after edits. CX Codex +1 ★ 372repo stars aws-cloudformation-dynamodb aws-cloudformation-dynamodb — a Claude skill that supplies CloudFormation patterns for DynamoDB tables: keys, indexes, billing modes, TTL and streams. Handy when infrastructure lives in code. CX Codex +1 ★ 372repo stars devkit.java.write-unit-tests devkit.java.write-unit-tests generates JUnit 5 tests with Mockito and AssertJ assertions from a Java class path. Useful for testing Spring Boot services, controllers, and utility classes. CX Codex +1 ★ 372repo stars clean-architecture Guides Clean Architecture, DDD, and Hexagonal Architecture in NestJS/TypeScript projects. Use it to shape domain models or separate business rules from framework code. CX Codex +1 ★ 372repo stars java-security-expert java-security-expert runs security audits for Java and Spring Boot applications, detects OWASP vulnerabilities, reviews OAuth2 flows, and checks compliance. CX Codex ★ 372repo stars general-code-reviewer The general-code-reviewer subagent checks code changes for bugs, security flaws, and quality problems, reporting only findings with a confidence score of at least 80. CX Codex ★ 372repo stars aws-cloudformation-vpc aws-cloudformation-vpc is a Claude Code skill with CloudFormation templates for setting up VPC infrastructure on AWS. CX Codex +1 ★ 372repo stars devkit.java.security-review devkit.java.security-review is a Claude Code command that reviews security in enterprise Java applications. Run it for an application audit or before a production release. CX Codex +1 ★ 372repo stars

Project sponsors

Companies that keep this analytics open