Agent skill · software engineering · ccheney
clean-ddd-hexagonal
Proactively apply when designing APIs, microservices, or scalable backend structure. Triggers on DDD, Clean Architecture, Hexagonal, ports and adapters, entities, value objects, domain events, CQRS, event sourcing, repository pattern, use cases, onion architecture, outbox pattern, aggregate root, anti-corruption layer. Use when working with domain models, aggregates, repositories, or bounded contexts. Clean Architecture + DDD + Hexagonal patterns for backend services, language-agnostic (Go, Rust, Python, TypeScript, Java, C#).
Why this skill is useful
Provides domain-specific architectural patterns and principles for designing scalable backend systems that the AI wouldn't reliably generate on its own.
What it needs
About 7k tokens when loaded. Last updated 2026-07-07. 58 stars on the source repository.
What this skill does
Clean Architecture + DDD + Hexagonal Backend architecture combining DDD tactical patterns, Clean Architecture dependency rules, and Hexagonal ports/adapters for maintainable, testable systems. This skill is an opinionated synthesis of several related architecture traditions. It is not a single canonical architecture model. Use the original source that matches the design question you are answering: DDD for domain modeling, Hexagonal Architecture for ports/adapters, Clean Architecture for dependency direction, Onion Architecture for domain-centered layering, and CQRS/Event Sourcing only for specific read/write or temporal requirements. When to Use (and When NOT to) Use When Skip When ---------- ----------- Complex business domain with many rules Simple CRUD, few business rules Long-lived system (years of maintenance) Prototype, MVP, throwaway code Team of 5+ developers Solo developer or small team (1-2) Multiple entry points (API, CLI, events) Single entry point, simple API Need to swap infrastructure (DB, broker) Fixed infrastructure, unlikely to change High test coverage required Quick scripts, internal tools Start simple. Evolve complexity only when needed. Most systems don't need full CQRS or Event Sourcing. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills ccheney/clean-ddd-hexagonal