architecture-patterns

Explain software architecture patterns and guide strategic design decisions.

Updated Mar 14, 2026
One-click install
npx skills add https://github.com/syanix/agentic-sdlc --skill architecture-patterns-syanix
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-patterns
Source: https://github.com/syanix/agentic-sdlc/tree/main/templates/skills/architecture-patterns/_base
Command: npx skills add https://github.com/syanix/agentic-sdlc --skill architecture-patterns-syanix

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps developers and architects make informed decisions about software architecture by providing clear explanations, use cases, and trade-offs for various design patterns.

Core Features & Use Cases

  • Pattern Explanations: Understand concepts like Clean Architecture, Hexagonal Architecture, DDD, CQRS, and Event Sourcing.
  • Decision Guidance: Get advice on when to use each pattern and when to avoid them.
  • Use Case: When designing a new microservice, use this Skill to compare CQRS and Event Sourcing to determine the best fit for handling complex read/write requirements and ensuring auditability.

Quick Start

Explain the core principles of Hexagonal Architecture and its benefits.

Frequently Asked Questions about architecture-patterns

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

FAQPage Schema
What is the difference between Clean Architecture and Hexagonal Architecture?

Clean Architecture and Hexagonal Architecture both isolate domain logic from external concerns, but Clean Architecture organizes dependencies into concentric layers, while Hexagonal Architecture uses ports and adapters to decouple the application core from infrastructure.

When should I use CQRS and Event Sourcing in a microservice?

Use CQRS and Event Sourcing when a microservice has complex read/write requirements and needs strict auditability. CQRS separates read and write models, while Event Sourcing stores state changes as a sequence of immutable events for full history reconstruction.

How do I choose the right software architecture pattern for my project?

Choose the right software architecture pattern by evaluating project complexity and specific requirements. This involves comparing the use cases, trade-offs, and anti-patterns of Clean Architecture, Hexagonal Architecture, DDD, CQRS, and Event Sourcing to find the best fit.

When should I avoid Domain-Driven Design?

You should avoid Domain-Driven Design for simple projects lacking complex business logic, as its strategic design overhead provides little benefit. DDD is intended for complex domains requiring detailed modeling, and applying it to basic CRUD operations is an anti-pattern.

Does Hexagonal Architecture work for microservices with high read/write complexity?

Hexagonal Architecture works for microservices with high read/write complexity by protecting the domain core, but it does not inherently separate read and write models like CQRS. You may need to combine it with CQRS for optimized query performance and auditability.