architecture-patterns

Select and apply architectural patterns for scalable software systems.

8|1|Updated Dec 29, 2025
One-click install
npx skills add https://github.com/mjohnson518/claude_superpowers --skill architecture-patterns-mjohnson518
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-patterns
Source: https://github.com/mjohnson518/claude_superpowers/tree/main/skills/architecture-patterns
Command: npx skills add https://github.com/mjohnson518/claude_superpowers --skill architecture-patterns-mjohnson518

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams decide which architectural patterns to apply when designing or refactoring scalable systems, reducing guesswork and architecture drift.

Core Features & Use Cases

  • Pattern catalog: summarizes major architectural styles (Clean Architecture, Hexagonal, Domain-Driven Design) and when to use them.
  • Guided decision framework: provides criteria to choose patterns based on scalability, team size, and domain complexity.
  • Apply & evolve: includes layering recommendations and boundary definitions for typical subsystems.
  • Use Case: You are modernizing a monolith; apply the right pattern to separate core business rules from infrastructure.

Quick Start

Propose an architectural pattern for a new payments service, then outline the layer boundaries and a migration plan.

Frequently Asked Questions about architecture-patterns

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

FAQPage Schema
What is the best way to choose architectural patterns for scalable software?

Choosing architectural patterns requires evaluating scalability needs, team size, and domain complexity against styles like Clean Architecture, Hexagonal, and Domain-Driven Design. This decision framework provides practical criteria to match your system requirements with the appropriate structural pattern.

How do I apply Domain-Driven Design when refactoring a monolith?

Applying Domain-Driven Design to a monolith involves separating core business rules from infrastructure using defined layer boundaries. This Skill provides layering recommendations and boundary definitions to guide the migration and isolate your core domain logic effectively.

When should I use Hexagonal Architecture versus Clean Architecture?

Use Hexagonal Architecture when you need strict isolation of business logic via ports and adapters, whereas Clean Architecture focuses on dependency inversion across layers. This Skill outlines when to use each pattern based on your specific scalability and domain complexity criteria.

Can I use these architectural patterns for a new payments service?

Yes, you can use these architectural patterns for a new payments service by proposing a suitable style, outlining layer boundaries, and creating a migration plan. The framework supports design tasks across software projects of varying complexity to ensure scalable infrastructure.

What are the limitations of layered architecture in complex software design?

Limitations of layered architecture arise when strict layering creates unnecessary overhead or fails to fully encapsulate complex business domains. This Skill identifies when layering rules become restrictive and advises transitioning to Hexagonal or Domain-Driven Design for better domain alignment.