Claude-night-market architecture-paradigms

Interactive selector and router for architecture paradigms. Use when

install
source · Clone the upstream repo
git clone https://github.com/athola/claude-night-market
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/athola/claude-night-market "$T" && mkdir -p ~/.claude/skills && cp -r "$T/plugins/archetypes/skills/architecture-paradigms" ~/.claude/skills/athola-claude-night-market-architecture-paradigms && rm -rf "$T"
manifest: plugins/archetypes/skills/architecture-paradigms/SKILL.md
source content

Table of Contents

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 ScenarioPrimary ParadigmLoad Skill
Enterprise app with multiple teamsMicroservices or Modular Monolith
architecture-paradigm-microservices
or
architecture-paradigm-modular-monolith
Complex business rules & testingFunctional Core, Imperative Shell
architecture-paradigm-functional-core
Real-time/event processingEvent-Driven Architecture
architecture-paradigm-event-driven
Legacy system modernizationHexagonal (Ports & Adapters)
architecture-paradigm-hexagonal
Cloud-native/bursty workloadsServerless
architecture-paradigm-serverless
ETL/data processing pipelinePipeline Architecture
architecture-paradigm-pipeline
Simple CRUD appLayered Architecture
architecture-paradigm-layered
Command/query separationCQRS + 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

ParadigmComplexityTeam SizeBest ForSkill Name
Functional CoreMediumSmall-LargeComplex business logic
architecture-paradigm-functional-core
HexagonalMediumSmall-LargeInfrastructure changes
architecture-paradigm-hexagonal
LayeredLowSmall-MediumSimple domains
architecture-paradigm-layered
Modular MonolithMediumMedium-LargeEvolving systems
architecture-paradigm-modular-monolith
MicroservicesHighLargeComplex domains
architecture-paradigm-microservices
Event-DrivenHighMedium-LargeReal-time processing
architecture-paradigm-event-driven
CQRS + ESHighMedium-LargeAudit trails
architecture-paradigm-cqrs-es
Service-BasedMediumMediumCoarse-grained services
architecture-paradigm-service-based
ServerlessMediumSmall-MediumCloud-native/bursty
architecture-paradigm-serverless
MicrokernelMediumSmall-MediumPlugin systems
architecture-paradigm-microkernel
Space-BasedHighLargeLinear scalability
architecture-paradigm-space-based
PipelineLowSmall-MediumETL workflows
architecture-paradigm-pipeline
Client-ServerLowSmallTraditional 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