Hexagonal Architecture

This teaches Claude to design and refactor systems using Ports and Adapters, keeping your domain logic clean and your infrastructure swappable. It covers the full workflow: modeling use case boundaries, defining outbound ports for every side effect (repos, gateways, clocks), implementing pure orchestration logic, and wiring adapters at composition roots. You get concrete TypeScript, Java, Kotlin, and Go patterns, plus guidance on feature-first module layout and testing strategies per boundary. Reach for it when you're building maintainable features, decoupling framework-heavy code, or supporting multiple interfaces for the same business rules. The dependency inversion discipline takes effort up front but pays off when you swap databases or add a CLI alongside your API without touching core logic.

skills.sh installs: 5.8K
GitHub stars: 300.3K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add affaan-m/ecc --skill hexagonal-architecture --agent claude-code

Installs into .claude/skills of the current project.

Files

Hexagonal Architecture

Hexagonal architecture (Ports and Adapters) keeps business logic independent from frameworks, transport, and persistence details. The core app depends on abstract ports, and adapters implement those ports at the edges.

When to Use

Building new features where long-term maintainability and testability matter.
Refactoring layered or framework-heavy code where domain logic is mixed with I/O concerns.
Supporting multiple interfaces for the same use case (HTTP, CLI, queue workers, cron jobs).
Replacing infrastructure (database, external APIs, message bus) without rewriting business rules.

Use this skill when the request involves boundaries, domain-centric design, refactoring tightly coupled services, or decoupling application logic from specific libraries.