How does it handle the separation of domain logic?

It enforces a strict dependency rule where the domain layer remains 'pure' Java with zero dependencies on external frameworks like Spring, Hibernate, or third-party APIs.

Can I use this for refactoring existing projects?

Yes, it provides specific implementation patterns and trigger phrases to help identify and decouple business logic from infrastructure in existing codebases.

What is the difference between Ports and Adapters in this skill?

Ports are interfaces defined in the application or domain layers that specify requirements, while Adapters are concrete implementations (like REST controllers or JPA repositories) located in the infrastructure layer.

Does this skill support older Java versions?

This skill is optimized for Java 21+ and Spring Boot 3.5+, utilizing modern features like records for immutable value objects and enhanced pattern matching.

Does it include testing strategies?

Yes, the skill provides guidance for a comprehensive testing pyramid, including pure domain unit tests, application service mocks, and infrastructure integration tests using Testcontainers.

Clean Architecture for Spring Boot

Name: Clean Architecture for Spring Boot
Author: giuseppe-trisciuoglio

bygiuseppe-trisciuoglio

•

165

•

API Development

Implements Clean Architecture, Hexagonal patterns, and Domain-Driven Design for modern Java and Spring Boot applications.

This skill automates the implementation of robust, maintainable, and highly testable Java 21+ applications by enforcing strict separation of concerns through Clean Architecture and Hexagonal patterns. It guides developers in creating framework-independent domain models using DDD tactical patterns like entities, aggregates, and value objects, while managing infrastructure dependencies through clear ports and adapters. It is particularly useful for refactoring legacy monoliths or architecting scalable new services in Spring Boot 3.5+, ensuring business logic remains decoupled from external frameworks and databases.

Key Features

01Domain-Driven Design (DDD) tactical patterns for aggregates and value objects

02Implementation of Ports and Adapters for swappable infrastructure

03Automated package structuring for Hexagonal and Clean Architecture layers

04Framework-independent domain model generation using Java 21 records

05165 GitHub stars

06Guidance on decoupling business logic from Spring Boot framework dependencies

Use Cases

01Implementing domain-driven logic that remains easily testable without a Spring context

02Refactoring a tightly coupled Spring Boot monolith into a maintainable layered architecture

03Architecting a new microservice with a clear separation between business logic and external systems

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add giuseppe-trisciuoglio/developer-kit clean-architecture

For use in Claude.ai and ChatGPT

Download Skill