Which frameworks are covered in the examples?

The skill provides implementation patterns for TypeScript (NestJS), Java/Kotlin (Spring Boot), and Ruby on Rails.

How does this skill assist with testing?

By emphasizing the use of Ports (interfaces), this skill helps you design systems where the core domain can be tested in isolation using mocks or in-memory adapters.

When should I use the Ports and Adapters pattern?

It is most valuable for enterprise applications, microservices, or any long-term project where maintainability, testability, and technology flexibility are high priorities.

What is the primary goal of Hexagonal Architecture?

The primary goal is to separate the core business logic from external infrastructure, making the system independent of specific frameworks, databases, or UI implementations.

Does this skill help with circular dependencies?

Yes, it provides strategies for identifying and resolving circular dependencies through proper module boundaries and dependency inversion.

Designing Hexagonal Architecture

Name: Designing Hexagonal Architecture
Author: aucun6352

byaucun6352

•

API Development

Guides the design and implementation of modular backend systems using the Ports and Adapters pattern for clean separation of concerns.

This skill provides a comprehensive framework for applying Hexagonal Architecture (also known as Ports & Adapters) to backend systems. It helps developers create flexible, testable, and maintainable applications by isolating core business logic from external infrastructure like databases, third-party APIs, and user interfaces. By following the structured workflows and language-specific patterns provided, users can ensure their software remains technology-independent, highly testable, and resilient to change over time.

Key Features

01Dependency inversion strategies to maintain clean architectural boundaries.

02Best practices for implementing Adapters in NestJS, Spring Boot, and Rails.

03Guidance on resolving circular dependencies and over-abstraction pitfalls.

04Comprehensive guidance on defining Inbound and Outbound Ports.

05Structural patterns for separating Domain, Application, and Infrastructure layers.

061 GitHub stars

Use Cases

01Architecting new microservices or enterprise backend applications from scratch.

02Establishing standardized architectural patterns across a development team.

03Refactoring monolithic applications to improve modularity and testability.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add aucun6352/project-cheat-sheet designing-hexagonal-architecture

For use in Claude.ai and ChatGPT

Download Skill