hexagonal-architecture-java

When to Use

Triggers: When designing Java services with hexagonal architecture, clean architecture, or ports-and-adapters pattern.

Load when: designing Java applications with hexagonal architecture, implementing ports and adapters, or maintaining clean separation between domain and infrastructure.

Critical Patterns

Fundamental Rule: The domain has no external dependencies

Domain → no imports from Spring, JPA, HTTP, or any framework
Application → defines ports (interfaces), orchestrates the domain
Infrastructure → implements the ports (JPA, REST, Kafka, etc.)

Dependency flow (always inward):
Infrastructure → Application → Domain