Generates complete CRUD workflows for Spring Boot 3 services with feature-focused architecture, Spring Data JPA aggregates, repositories, DTOs, controllers, and REST APIs. For modeling Java backend services, REST endpoints, and database operations.
From developer-kit-javanpx claudepluginhub giuseppe-trisciuoglio/developer-kit --plugin developer-kit-javaThis skill is limited to using the following tools:
assets/specs/product.jsonassets/specs/product_with_rel.jsonreferences/crud-reference.mdreferences/examples-product-feature.mdreferences/generator-usage.mdreferences/spring-official-docs.mdreferences/templates/Controller.java.tplreferences/templates/CreateService.java.tplreferences/templates/DeleteService.java.tplreferences/templates/DomainModel.java.tplreferences/templates/DomainRepository.java.tplreferences/templates/DomainService.java.tplreferences/templates/DtoRequest.java.tplreferences/templates/DtoResponse.java.tplreferences/templates/EntityExceptionHandler.java.tplreferences/templates/ErrorResponse.java.tplreferences/templates/ExistException.java.tplreferences/templates/GetService.java.tplreferences/templates/GlobalExceptionHandler.java.tplreferences/templates/JpaEntity.java.tplSearches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.
Searches prompts.chat for AI prompt templates by keyword or category, retrieves by ID with variable handling, and improves prompts via AI. Use for discovering or enhancing prompts.
Compares coding agents like Claude Code and Aider on custom YAML-defined codebase tasks using git worktrees, measuring pass rate, cost, time, and consistency.
Provides complete CRUD workflows for Spring Boot 3.5+ services using feature-focused architecture. Creates and validates domain aggregates, JPA repositories, application services, and REST controllers with proper separation of concerns. Defer detailed code listings to reference files for progressive disclosure.
Follow this streamlined workflow to deliver feature-aligned CRUD services with explicit validation gates:
Create feature/<name>/ directories with domain, application, presentation, and infrastructure subpackages.
Validate: Verify directory structure matches the feature boundary before proceeding.
Create entity classes with invariants enforced through factory methods (create, update). Keep domain logic framework-free.
Validate: Assert all invariants are covered by unit tests before advancing.
Declare repository interfaces in domain/repository describing persistence contracts without implementation details.
Validate: Confirm interface signatures match domain operations.
Create JPA entities in infrastructure/persistence that map to domain models. Implement Spring Data repositories.
Validate: Run @DataJpaTest to verify entity mapping and repository integration.
Create @Transactional service classes that orchestrate domain operations and DTO mapping.
Validate: Ensure transaction boundaries are correct and optimistic locking is applied where needed.
Use Java records for API contracts with jakarta.validation annotations. Map REST endpoints with proper status codes.
Validate: Test validation constraints and verify HTTP status codes (201 POST, 200 GET, 204 DELETE).
Run integration tests with Testcontainers. Verify migrations (Liquibase/Flyway) mirror the aggregate schema. Validate: Execute full test suite before deployment; confirm schema migration scripts are applied.
See references/examples-product-feature.md for complete code aligned with each step.
// feature/product/domain/Product.java
package com.example.product.domain;
import java.math.BigDecimal;
import java.time.Instant;
public record Product(
String id,
String name,
String description,
BigDecimal price,
int stock,
Instant createdAt,
Instant updatedAt
) {
public static Product create(String name, String desc, BigDecimal price, int stock) {
if (name == null || name.isBlank()) throw new IllegalArgumentException("Name required");
if (price == null || price.compareTo(BigDecimal.ZERO) < 0) throw new IllegalArgumentException("Invalid price");
return new Product(null, name.trim(), desc, price, stock, Instant.now(), null);
}
public Product withPrice(BigDecimal newPrice) {
return new Product(id, name, description, newPrice, stock, createdAt, Instant.now());
}
}
// feature/product/domain/repository/ProductRepository.java
package com.example.product.domain.repository;
import com.example.product.domain.Product;
import java.util.Optional;
public interface ProductRepository {
Product save(Product product);
Optional<Product> findById(String id);
void deleteById(String id);
}
// feature/product/infrastructure/persistence/ProductJpaEntity.java
package com.example.product.infrastructure.persistence;
import jakarta.persistence.*;
import java.math.BigDecimal;
import java.time.Instant;
@Entity @Table(name = "products")
public class ProductJpaEntity {
@Id @GeneratedValue(strategy = GenerationType.UUID)
private String id;
private String name;
private String description;
private BigDecimal price;
private int stock;
private Instant createdAt;
private Instant updatedAt;
// getters, setters, constructor from domain (omitted for brevity)
}
// feature/product/infrastructure/persistence/JpaProductRepository.java
package com.example.product.infrastructure.persistence;
import com.example.product.domain.Product;
import com.example.product.domain.repository.ProductRepository;
import org.springframework.stereotype.Repository;
@Repository
public class JpaProductRepository implements ProductRepository {
private final SpringDataProductRepository springData;
public JpaProductRepository(SpringDataProductRepository springData) {
this.springData = springData;
}
@Override
public Product save(Product product) {
ProductJpaEntity entity = toEntity(product);
ProductJpaEntity saved = springData.save(entity);
return toDomain(saved);
}
// findById, deleteById implementations...
}
// feature/product/presentation/rest/ProductController.java
package com.example.product.presentation.rest;
import com.example.product.domain.Product;
import com.example.product.domain.repository.ProductRepository;
import jakarta.validation.Valid;
import jakarta.validation.constraints.*;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;
@RestController @RequestMapping("/api/products")
public class ProductController {
private final ProductService service;
public ProductController(ProductService service) { this.service = service; }
@PostMapping
public ResponseEntity<ProductResponse> create(@Valid @RequestBody CreateProductRequest req) {
Product product = service.create(req.toDomain());
return ResponseEntity.status(201).body(ProductResponse.from(product));
}
@GetMapping("/{id}")
public ResponseEntity<ProductResponse> getById(@PathVariable String id) {
return service.findById(id)
.map(p -> ResponseEntity.ok(ProductResponse.from(p)))
.orElse(ResponseEntity.notFound().build());
}
@DeleteMapping("/{id}")
public ResponseEntity<Void> delete(@PathVariable String id) {
service.deleteById(id);
return ResponseEntity.noContent().build();
}
// record DTOs
public record CreateProductRequest(
@NotBlank String name,
String description,
@NotNull @DecimalMin("0.01") java.math.BigDecimal price,
@Min(0) int stock
) {
Product toDomain() { return Product.create(name, description, price, stock); }
}
public record ProductResponse(String id, String name, java.math.BigDecimal price) {
static ProductResponse from(Product p) { return new ProductResponse(p.id(), p.name(), p.price()); }
}
}
Create Request:
{
"name": "Wireless Keyboard",
"description": "Ergonomic keyboard",
"price": 79.99,
"stock": 50
}
Created Response (201):
{
"id": "prod-123",
"name": "Wireless Keyboard",
"price": 79.99,
"_links": { "self": "/api/products/prod-123" }
}
Paginated List Request:
curl "http://localhost:8080/api/products?page=0&size=10&sort=name,asc"
python scripts/generate_crud_boilerplate.py --spec entity.json --package com.example.product --output ./generated