architecture-patterns

Apply Clean Architecture, Hexagonal Architecture, and Domain-Driven Design to backend systems.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Hanseooo/hanseo-opencode-workflows --skill architecture-patterns-hanseooo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-patterns
Source: https://github.com/Hanseooo/hanseo-opencode-workflows/tree/main/skills/architecture-patterns
Command: npx skills add https://github.com/Hanseooo/hanseo-opencode-workflows --skill architecture-patterns-hanseooo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Organize and standardize backend architectures to reduce complexity, improve maintainability, and enable scalable growth by applying well-established patterns such as Clean Architecture, Hexagonal Architecture, and Domain-Driven Design.

Core Features & Use Cases

  • Structured guidance on Clean Architecture, Hexagonal Architecture, and Domain-Driven Design to define clear boundaries and responsibilities.
  • Roadmaps for refactoring monoliths or designing new services with decoupled domains, ports, and adapters.
  • Practical examples and decision criteria to choose the right pattern per context and to evolve architecture over time.

Quick Start

Analyze your current backend design and prompt the system to propose a pattern-aligned plan.

Frequently Asked Questions about architecture-patterns

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design a backend architecture using Clean Architecture or Domain-Driven Design?

Designing backend architecture with Clean Architecture or Domain-Driven Design involves defining clear boundaries and responsibilities, mapping domain models to ports and adapters, and decoupling domains to improve maintainability. You can analyze your current backend to propose a pattern-aligned plan.

What is the best way to refactor a monolith into decoupled domains?

The best way to refactor a monolith into decoupled domains is to apply Hexagonal Architecture by mapping domain models to ports and adapters. This establishes clear boundaries and responsibilities, reducing complexity and enabling scalable backend growth.

When should I use Hexagonal Architecture in my backend design?

You should use Hexagonal Architecture in backend design when you need to isolate domain logic from infrastructure through ports and adapters. It is highly effective for standardizing cross-team architecture and evolving systems that require high maintainability and decoupled domains.

How do I choose between Clean Architecture and Domain-Driven Design for a new system?

Choosing between Clean Architecture and Domain-Driven Design requires evaluating your system's complexity. Clean Architecture focuses on layering and dependency inversion, while Domain-Driven Design centers on mapping complex domain models to bounded contexts for scalable growth.

Do I need to understand ports and adapters to standardize cross-team backend architecture?

Yes, understanding ports and adapters is essential to standardize cross-team backend architecture. These Hexagonal Architecture concepts guide the placement of domain logic and infrastructure boundaries, ensuring decoupled domains and consistent architectural patterns across teams.