ms-architecture-patterns

Design backend architectures with Clean, Hexagonal, and DDD patterns.

Updated Oct 16, 2025
One-click install
npx skills add https://github.com/beomeodev/specter --skill ms-architecture-patterns
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ms-architecture-patterns
Source: https://github.com/beomeodev/specter/tree/main/.claude/skills/ms-architecture-patterns
Command: npx skills add https://github.com/beomeodev/specter --skill ms-architecture-patterns

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

The skill provides production-ready architecture patterns and governance guidance for building scalable, maintainable backends. It consolidates Clean/Hexagonal/DDD patterns, ADR templates, anti-pattern warnings, and constitutional constraints to help teams design robust systems and document architectural decisions.

Core Features & Use Cases

  • Pattern templates: Clean Architecture, Hexagonal Architecture, and Domain-Driven Design with practical guidance.
  • ADR templates & references: Architectural Decision Records and reference materials for decision making and documentation.
  • Microservices patterns: Saga, CQRS, Event Sourcing, API Gateway, and related patterns for scalable service architectures.
  • Constitution-aware guidance: Size, complexity limits, and TAG-based traceability to maintain quality across the codebase.
  • When to use: Designing new backend systems, refactoring monoliths, standardizing architecture across teams, or migrating to event-driven designs.

Quick Start

Start by reading the ADR templates and the reference patterns to begin composing your architecture plan.

Frequently Asked Questions about ms-architecture-patterns

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

FAQPage Schema
How do I structure a scalable backend architecture using Clean, Hexagonal, and DDD patterns?

To structure scalable backend architecture, apply Clean, Hexagonal, and Domain-Driven Design patterns by separating core domain logic from external interfaces. This approach provides production-ready templates to isolate business rules, enforce constitutional constraints, and maintain system quality across complex codebases.

What is the best way to document architectural decisions for microservices?

The best way to document architectural decisions is using Architectural Decision Records (ADR templates). ADRs capture the context, decision, and consequences of architectural choices, providing standardized reference materials that ensure traceability and align microservices with event-driven design requirements.

When should I use Saga, CQRS, and Event Sourcing patterns in my backend?

You should use Saga, CQRS, and Event Sourcing patterns when migrating to event-driven designs or building scalable service architectures. These microservices patterns handle complex distributed transactions, separate read and write workloads, and persist state changes as a sequence of events for robust system recovery.

Can I use these architecture patterns to refactor an existing monolith?

Yes, you can use these architecture patterns to refactor monoliths into maintainable backends. The guidance includes anti-pattern avoidance, complexity limits, and TAG-based traceability to help teams standardize architecture, safely decompose monolithic structures, and migrate toward modular domain boundaries.

How does Domain-Driven Design align backend code with microservices boundaries?

Domain-Driven Design aligns backend code with microservices by modeling bounded contexts that map directly to autonomous service boundaries. This pattern enforcement ensures constitutional size constraints are met, preventing service coupling and maintaining scalable, maintainable event-driven architectures.