architecture-patterns

The architecture-patterns skill provides a structured approach to implementing proven backend architecture patterns, including Clean Architecture, Hexagonal Architecture, and Domain-Driven Design (DDD). It is designed to help developers create maintainable, testable, and scalable backend systems while refactoring existing monolithic applications for better code quality and modularity. By applying these patterns, teams can reduce tight coupling between components, isolate business logic from infrastructure, and achieve clearer separation of concerns, which simplifies both development and long-term maintenance.

This skill covers the core principles and components of each architecture pattern. For Clean Architecture, it emphasizes layers where dependencies flow inward, keeping business rules independent from frameworks, UI, and databases. Hexagonal Architecture focuses on ports and adapters to make business logic implementation-independent and easily testable. Domain-Driven Design introduces strategic and tactical patterns, such as bounded contexts, ubiquitous language, entities, value objects, aggregates, repositories, and domain events, to model complex domains accurately. The skill also includes practical guidance on organizing code directories and implementing core entities, interfaces, and use cases, illustrated through Python examples.

Target users include backend developers, software architects, and development teams seeking to establish architecture standards or improve existing systems. It is particularly valuable when designing new backend systems, refactoring monolithic applications, implementing testable and mockable codebases, planning microservice decomposition, or adopting domain-driven principles. By following this skill, developers can create robust and flexible systems that are easier to maintain, extend, and test.