spring-boot-package-structure-creator

Creates recommended package structure for Spring Boot projects.

⭐32stars🔀2forks📁View on GitHub🕐Updated Jan 3, 2026

When & Why to Use This Skill

This Claude skill automates the creation of professional, domain-driven package structures for Spring Boot applications. It implements modular architecture principles to ensure codebases are scalable, maintainable, and organized by business logic rather than technical layers, significantly reducing architectural debt from day one.

Use Cases

  • Greenfield Project Initialization: Quickly set up a standardized, industry-best-practice directory hierarchy for new Spring Boot microservices.
  • Monolith Refactoring: Provide a clear blueprint for reorganizing legacy 'spaghetti' code into clean, bounded contexts and modular domains.
  • Team Standardization: Establish a unified naming convention and structural pattern across multiple development teams to improve code readability and simplify onboarding.
  • DDD Implementation: Guide developers in correctly separating domain logic, REST controllers, and infrastructure concerns using a proven architectural template.
namespring-boot-package-structure-creator
descriptionCreates recommended package structure for Spring Boot projects.

Spring Boot Package Structure Creator

Instructions

Follow a domain-driven, modular architecture where packages are organized by business modules rather than technical layers.

dev.sivalabs.meetup4j/
├── Application                      # Main Spring Boot entrypoint class
├── shared/                          # Cross-cutting concerns
│   ├── BaseEntity.java
│   ├── DomainException.java
│   ├── ResourceNotFoundException.java
│   └── SpringEventPublisher.java
│
├── events/                          # Events module (bounded context)
│   ├── domain/                      # Domain logic
│   │   ├── models/                  # ViewModels for read operations
│   │   │   └── EventVM.java
│   │   ├── vo/                      # Value Objects
│   │   │   ├── EventId.java
│   │   │   ├── EventCode.java
│   │   │   ├── EventDetails.java
│   │   │   ├── Schedule.java
│   │   │   ├── TicketPrice.java
│   │   │   ├── Capacity.java
│   │   │   └── EventLocation.java
│   │   ├── events/                  # Domain events
│   │   │   ├── EventCreated.java
│   │   │   ├── EventPublished.java
│   │   │   └── EventCancelled.java
│   │   ├── EventEntity.java         # Aggregate root
│   │   ├── EventRepository.java     # Repository interface
│   │   ├── EventService.java        # Write operations
│   │   ├── EventQueryService.java   # Read operations
│   │   ├── EventMapper.java         # Domain to ViewModel mapper
│   │   ├── CreateEventCmd.java      # Command
│   │   ├── PublishEventCmd.java
│   │   └── InvalidEventCreationException.java
│   ├── rest/                        # REST API layer
│   │   ├── converters/              # Type converters
│   │   │   └── StringToEventCodeConverter.java
│   │   ├── EventsController.java
│   │   ├── CreateEventRequest.java  # HTTP Request DTO
│   │   └── CreateEventResponse.java # HTTP Response DTO
│   └── EventsAPI.java               # Module's public API (facade)
│
├── registrations/                   # Registrations module
│   ├── domain/
│   │   ├── vo/
│   │   │   ├── RegistrationId.java
│   │   │   ├── RegistrationCode.java
│   │   │   └── Email.java
│   │   ├── EventRegistrationEntity.java
│   │   ├── RegistrationRepository.java
│   │   ├── EventRegistrationService.java
│   │   ├── EventRegistrationQueryService.java
│   │   └── RegisterAttendeeCmd.java
│   └── rest/
│       ├── converters/
│       ├── EventRegistrationController.java
│       └── EventRegistrationRequest.java
│
└── config/
    └── GlobalExceptionHandler.java

Naming Conventions

Type Convention Example
Entities *Entity EventEntity, EventRegistrationEntity
Value Objects Domain name (record) Email, EventCode, EventId
Commands *Cmd CreateEventCmd, PublishEventCmd
Command Response *Result LoginResult, RegistrationResult
ViewModels *VM EventVM, RegistrationVM
HTTP Request *Request CreateEventRequest, EventRegistrationRequest
HTTP Response *Response CreateEventResponse, EventRegistrationResponse
Repositories *Repository EventRepository, RegistrationRepository
Services (Write) *Service EventService, EventRegistrationService
Services (Read) *QueryService EventQueryService, EventRegistrationQueryService
Domain Exceptions *Exception InvalidEventCreationException, EventCancellationException
Module API *API EventsAPI