Architecture Paradigms

Table of Contents

• [Quick Scenario Router](#quick-scenario-router)
• [3-Step Selection Workflow](#3-step-selection-workflow)
• [Available Paradigm Skills](#available-paradigm-skills)
• [Integration with Other Skills](#integration-with-other-skills)
• [Exit Criteria](#exit-criteria)

Architecture Paradigm Router

This skill helps you select the right architecture paradigm(s) for your system, then routes you to the specific paradigm skill for implementation details.

Quick Scenario Router

Match your needs to the recommended paradigm:

| Your Scenario | Primary Paradigm | Load Skill | |---------------|------------------|------------| | Enterprise app with multiple teams | Microservices or Modular Monolith | architecture-paradigm-microservices or architecture-paradigm-modular-monolith | | Complex business rules & testing | Functional Core, Imperative Shell | architecture-paradigm-functional-core | | Real-time/event processing | Event-Driven Architecture | architecture-paradigm-event-driven | | Legacy system modernization | Hexagonal (Ports & Adapters) | architecture-paradigm-hexagonal | | Cloud-native/bursty workloads | Serverless | architecture-paradigm-serverless | | ETL/data processing pipeline | Pipeline Architecture | architecture-paradigm-pipeline | | Simple CRUD app | Layered Architecture | architecture-paradigm-layered | | Command/query separation | CQRS and Event Sourcing | architecture-paradigm-cqrs-es |

3-Step Selection Workflow

Step 1: Define Your Needs

Primary Concerns (select all that apply):

• Testability: Isolate business logic → functional-core or hexagonal
• Team Autonomy: Independent deployment → microservices or modular-monolith
• Infrastructure Flexibility: Swap databases/frameworks → hexagonal
• Real-time Scaling: Variable loads with events → event-driven or space-based
• Simplicity: Maintainable without complexity → layered or modular-monolith
• Legacy Integration: Work with existing systems → hexagonal or microkernel

System Context:

• Team Size: < 5 → Layered/Functional Core | 5-15 → Modular Monolith | 15-50 → Microservices | 50+ → Microservices/Space-Based
• Domain Complexity: Simple → Layered | Moderate → Hexagonal/Modular Monolith | Complex → Functional Core/CQRS | Highly Complex → Microservices/Event-Driven

Step 2: Evaluate Paradigms

Based on your needs from Step 1, review these options:

For Testability & Business Logic

• Load architecture-paradigm-functional-core - Isolates business logic from infrastructure
• Load architecture-paradigm-hexagonal - Clear domain/infrastructure boundaries

For Team Autonomy

• Load architecture-paradigm-microservices - Independent deployment and scaling
• Load architecture-paradigm-modular-monolith - Team autonomy without distributed complexity

For Infrastructure Flexibility

• Load architecture-paradigm-hexagonal - Swap infrastructure without domain changes

For Simplicity & Maintainability

• Load architecture-paradigm-layered - Simple, well-understood separation

For Real-time Event Processing

• Load architecture-paradigm-event-driven - Scalable, decoupled processing
• Load architecture-paradigm-space-based - In-memory data grids for linear scalability

For Legacy Integration

• Load architecture-paradigm-microkernel - Plugin architecture for extensible platforms
• Load architecture-paradigm-hexagonal - Adapters for external systems

Step 3: Load Paradigm Skill for Implementation

Once you've selected your paradigm(s), load the specific skill for detailed guidance:

# Example: You selected Hexagonal Architecture
Skill(archetypes:architecture-paradigm-hexagonal)

The individual paradigm skill provides:

• ✅ Complete implementation guide
• ✅ ADR templates
• ✅ Migration checklist
• ✅ Code examples
• ✅ Testing strategies
• ✅ Risk assessments

Available Paradigm Skills

| Paradigm | Complexity | Team Size | Best For | Skill Name | |----------|------------|-----------|----------|------------| | Functional Core | Medium | Small-Large | Complex business logic | architecture-paradigm-functional-core | | Hexagonal | Medium | Small-Large | Infrastructure changes | architecture-paradigm-hexagonal | | Layered | Low | Small-Medium | Simple domains | architecture-paradigm-layered | | Modular Monolith | Medium | Medium-Large | Evolving systems | architecture-paradigm-modular-monolith | | Microservices | High | Large | Complex domains | architecture-paradigm-microservices | | Event-Driven | High | Medium-Large | Real-time processing | architecture-paradigm-event-driven | | CQRS and ES | High | Medium-Large | Audit trails | architecture-paradigm-cqrs-es | | Service-Based | Medium | Medium | Coarse-grained services | architecture-paradigm-service-based | | Serverless | Medium | Small-Medium | Cloud-native/bursty | architecture-paradigm-serverless | | Microkernel | Medium | Small-Medium | Plugin systems | architecture-paradigm-microkernel | | Space-Based | High | Large | Linear scalability | architecture-paradigm-space-based | | Pipeline | Low | Small-Medium | ETL workflows | architecture-paradigm-pipeline | | Client-Server | Low | Small | Traditional apps | architecture-paradigm-client-server |

Integration with Other Skills

• Architecture Review: Use this skill first to select paradigms, then /architecture-review for evaluation
• Implementation Planning: Select paradigms here, then /writing-plans for detailed task breakdown
• Refactoring: Identify target paradigms here, then use paradigm-specific skills for migration strategies

Exit Criteria

• [ ] At least one paradigm is selected with clear rationale
• [ ] Specific paradigm skill has been loaded for detailed guidance
• [ ] Ready to create ADR or implementation plan

Next Steps

1. Load the specific paradigm skill - Use Skill(archetypes:architecture-paradigm-NAME)
2. Generate an ADR - Use the paradigm's ADR templates
3. Create implementation plan - Use paradigm's migration checklist
4. Set up monitoring - Track success metrics from paradigm guidance

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: athola
• Source: athola/claude-night-market
• License: MIT
• Homepage: https://athola.github.io/claude-night-market

Install and usage instructions live in the source repository linked above.