All skills
jeffallan avatar

/architecture-designer

@efebc44
by jeffallanjeffallan/claude-skills12k stars
1,124

Use when designing new high-level system architecture, reviewing existing designs, or making architectural decisions. Invoke to create architecture diagrams, write Architecture Decision Records (ADRs), evaluate technology trade-offs, design component interactions, and plan for scalability. Use for system design, architecture review, microservices structuring, ADR authoring, scalability planning, and infrastructure pattern selection — distinct from code-level design patterns or database-only design tasks.

Use this Skill: https://skilld.dev/gh/jeffallan/claude-skills/architecture-designer

This session only. Nothing lands on disk.

referencesarchitecture-patterns.md

≈1.2k tokens on demand. Your agent reads this file only when SKILL.md points to it.

Architecture Patterns

Pattern Comparison

Pattern Best For Team Size Trade-offs
Monolith Simple domain, small team 1-10 Simple deploy; hard to scale parts
Modular Monolith Growing complexity 5-20 Module boundaries; still single deploy
Microservices Complex domain, large org 20+ Independent scale; operational complexity
Serverless Variable load, event-driven Any Auto-scale; cold starts, vendor lock
Event-Driven Async processing 10+ Loose coupling; debugging complexity

Monolith

┌─────────────────────────────────────┐
│            Application              │
│  ┌─────┐  ┌─────┐  ┌─────┐         │
│  │Users│  │Orders│ │Products│       │
│  └─────┘  └─────┘  └─────┘         │
│  └──────────┬──────────────┘        │
│          Database                    │
└─────────────────────────────────────┘

When to Use:

  • Starting a new project
  • Small team (< 10 developers)
  • Simple domain
  • Rapid iteration needed

Pros: Simple deployment, easy debugging, no network latency Cons: Hard to scale independently, technology locked, deployment risk

Microservices

┌──────────┐  ┌──────────┐  ┌──────────┐
│  Users   │  │  Orders  │  │ Products │
│ Service  │  │ Service  │  │ Service  │
└────┬─────┘  └────┬─────┘  └────┬─────┘
     │             │             │
┌────▼────┐  ┌────▼────┐  ┌────▼────┐
│ User DB │  │Order DB │  │ Prod DB │
└─────────┘  └─────────┘  └─────────┘

When to Use:

  • Large team (20+ developers)
  • Complex domain with clear boundaries
  • Different scaling requirements per service
  • Polyglot technology needs

Pros: Independent scaling, team autonomy, fault isolation Cons: Distributed system complexity, eventual consistency, operational overhead

Event-Driven

┌──────────┐     ┌─────────────┐     ┌──────────┐
│ Producer │────▶│ Message Bus │────▶│ Consumer │
└──────────┘     │  (Kafka)    │     └──────────┘
                 └─────────────┘
                       │
                       ▼
                 ┌──────────┐
                 │ Consumer │
                 └──────────┘

When to Use:

  • Async processing required
  • Loose coupling between services
  • Event sourcing needs
  • High throughput messaging

Pros: Decoupled services, scalable, audit trail Cons: Eventual consistency, debugging complexity, message ordering

CQRS (Command Query Responsibility Segregation)

┌─────────┐         ┌─────────────┐
│ Commands│────────▶│ Write Model │──┐
└─────────┘         └─────────────┘  │
                                     ▼
                              ┌──────────┐
                              │  Events  │
                              └──────────┘
                                     │
┌─────────┐         ┌─────────────┐  │
│ Queries │◀────────│ Read Model  │◀─┘
└─────────┘         └─────────────┘

When to Use:

  • Read/write ratio heavily skewed
  • Complex read queries
  • Event sourcing architecture
  • Different optimization needs

Quick Reference

Requirement Recommended Pattern
Simple CRUD app Monolith
Growing startup Modular Monolith
Enterprise scale Microservices
Variable load Serverless
Async processing Event-Driven
Read-heavy CQRS

Source: SKILL.md on GitHub

1 alert16d5 checks · Risk CRITICAL
  • Gen Agent Trust Hub16d

    The skill provides a framework for system architecture design and documentation. It contains no executable code, persistence mechanisms, or data exfiltration logic. The documentation link flagged by external scanners is a plain-text reference to the author's official project page on a well-known hosting service.

  • Socket16d

    No alerts

  • Snyk16d

    Risk: LOW · No issues

  • Runlayer6mo

    6 files scanned · No issues

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at efebc44. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 months ago.

Steadyupdated 5 months ago
Other metadata
metadata
{
  "author": "https://github.com/Jeffallan",
  "version": "1.1.1",
  "domain": "api-architecture",
  "triggers": "architecture, system design, design pattern, microservices, scalability, ADR, technical design, infrastructure",
  "role": "expert",
  "scope": "design",
  "output-format": "document",
  "related-skills": "fullstack-guardian, devops-engineer, secure-code-guardian, microservices-architect, code-reviewer"
}
  • Infrastructure
  • architecture
  • system-design
  • adr
  • microservices
  • scalability
  • design-patterns
  • distributed-systems

README badge

README badge for jeffallan/claude-skills/architecture-designer

Guides system architecture design by creating diagrams, writing Architecture Decision Records, and evaluating trade-offs across patterns like microservices versus monoliths. Targets high-level design decisions, scalability planning, and technology selection—not code-level design patterns or isolated database choices.

Generated from the current SKILL.md.

Does this skill help with code-level design patterns or just system architecture?
This skill focuses on high-level system architecture, microservices structuring, and infrastructure patterns. It is distinct from code-level design patterns or database-only design tasks.
What output formats does this skill produce?
The skill generates requirements summaries, architecture diagrams in Mermaid format, Architecture Decision Records (ADRs) documenting trade-offs, technology recommendations with rationale, and risk mitigation strategies.
Can this skill help evaluate technology choices?
Yes. The skill evaluates trade-offs across alternative technologies, considers operational costs and complexity, and provides rationale for technology recommendations rather than selecting options in isolation.
Does this skill address non-functional requirements?
Yes. The skill explicitly considers non-functional requirements as part of the design process, includes an NFR checklist reference, and factors scalability, failure modes, and operational complexity into architecture decisions.

Generated from the current SKILL.md. These answers refresh after source changes.