Hexagonal Architecture for Java / Spring Boot

Ports & Adapters architecture for testable, framework-independent Java services.

vs ddd-java: This skill focuses on package structure and dependency direction — ports (interfaces), adapters (infrastructure), use cases, and DI wiring with Spring. Use ddd-java when you need domain modeling — how to design Value Objects, Entities, Aggregates, and Domain Events.

When to Activate

• Structuring a new Java/Spring Boot service from scratch
• Reviewing whether domain logic has leaked into adapters (or vice versa)
• Deciding where a new class belongs in the package hierarchy
• Writing tests: determining what to mock and at which boundary
• Replacing an adapter (e.g., switching from JPA to JDBC) without touching domain

Core Principle

Dependency arrows always point inward — toward domain.