
Description
hexagonal-architecture is an agent skill from the ECC collection by affaan-m, listed on skills.sh. It helps design, build and refactor systems in the Ports and Adapters style, where business logic stays independent of frameworks, transport and persistence. The core application depends on abstract ports, and adapters at the edges implement those ports for things like the database, external APIs or a message bus. The skill covers domain boundaries, dependency inversion and testable use-case orchestration. It applies when building new features where maintainability and testability matter, refactoring layered or framework-heavy code where domain logic is mixed with I/O, supporting several interfaces for one use case such as HTTP, a CLI, queue workers and cron jobs, and replacing infrastructure without rewriting business rules. It is also suited to decoupling application logic from particular libraries. A skill is a SKILL.md file of instructions that an AI agent loads when a task calls for it. It is free and open source, and the skills.sh listing shows a Snyk warning, with Gen Agent Trust Hub and Socket passing.…
Highlights
- Business logic independent of frameworks
- Ports and adapters at the edges
- Dependency inversion and testable use cases
- Supports HTTP, CLI, queue and cron entry points
Ratings & Reviews
No ratings yet
Be the first to rate hexagonal-architecture.
People also visit

android-clean-architecture
Clean Architecture patterns for Android and Kotlin Multiplatform projects
hexagonal-architecture FAQ
What does the hexagonal-architecture skill do?
It guides an agent in designing or refactoring code into ports and adapters, so the business logic does not depend on frameworks or databases.
When is it worth using?
For new features where long-term maintainability matters, and for untangling domain logic from I/O in existing code.
Does it support multiple entry points?
Yes. It covers one use case being exposed through HTTP, a CLI, queue workers or cron jobs.
How do I install it?
Run: npx skills add https://github.com/affaan-m/ecc --skill hexagonal-architecture
Is it free?
Yes. It is free and open source.
Are there security warnings?
The skills.sh listing shows Snyk with a warning, while Gen Agent Trust Hub and Socket pass.
What are the best hexagonal-architecture alternatives?
Popular alternatives to hexagonal-architecture include codebase-design, domain-modeling and request-refactor-plan. See all hexagonal-architecture alternatives







