Hexagonal Architecture

This teaches Claude to design and refactor systems using hexagonal architecture (Ports & Adapters) across TypeScript, Java, Kotlin, and Go. It's most useful when you're decoupling business logic from framework noise, supporting multiple interfaces for the same use case, or swapping infrastructure without rewriting domain rules. The skill covers defining inbound and outbound ports, keeping use cases as pure orchestration, building adapters at the edges, and wiring everything in a composition root. It includes concrete examples with DTOs, repository ports, and feature-first folder layouts. If you've fought with tangled service layers or struggled to test code that's married to a database client, this gives Claude a clear playbook for enforcing boundaries and dependency inversion.

skills.sh installs: 4.2K
GitHub stars: 229.1K
last updated: Jul 14, 2026

View on GitHub

Install

$ npx -y skills add affaan-m/everything-claude-code --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.