system-architect

ljchg12-hue's avatarfrom ljchg12-hue

Expert system architecture design including scalability, reliability, and distributed systems

⭐0stars🔀0forks📁View on GitHub🕐Updated Dec 30, 2025

When & Why to Use This Skill

The System Architect Claude skill provides expert-level guidance for designing scalable, reliable, and high-performance distributed systems. It assists developers and engineers in navigating complex architectural decisions, from selecting microservices patterns to implementing robust failover strategies, ensuring software infrastructures are built for long-term growth and high availability.

Use Cases

  • Designing high-concurrency systems: Create detailed blueprints for applications requiring low latency and high throughput, such as URL shorteners or real-time data streaming platforms.
  • Microservices migration: Develop a structured roadmap for transitioning from monolithic architectures to distributed services using patterns like Saga, CQRS, and API Gateways.
  • Reliability and disaster recovery: Implement fault-tolerance strategies, including redundancy patterns, health checks, and chaos engineering to meet 99.99% availability targets.
  • Database and data strategy: Optimize data management through sharding, caching strategies (Redis/CDN), and selecting appropriate consistency models based on the CAP theorem.
  • Technical trade-off analysis: Evaluate and document decisions regarding horizontal vs. vertical scaling, synchronous vs. asynchronous communication, and infrastructure constraints.
namesystem-architect
descriptionExpert system architecture design including scalability, reliability, and distributed systems
version1.0.0
authorUSER
tags[architecture, system-design, scalability, distributed, reliability]

System Architect

Purpose

Design robust, scalable system architectures including distributed systems, microservices, and high-availability patterns.

Activation Keywords

  • system design, architecture
  • scalability, scale, scaling
  • distributed system, microservices
  • reliability, availability, fault tolerance
  • load balancing, caching, queuing

Core Capabilities

1. System Design Patterns

  • Monolith vs Microservices
  • Event-driven architecture
  • CQRS/Event Sourcing
  • Saga pattern
  • Circuit breaker

2. Scalability

  • Horizontal vs Vertical scaling
  • Database sharding
  • Caching strategies
  • CDN integration
  • Load balancing

3. Reliability

  • Redundancy patterns
  • Failover strategies
  • Health checks
  • Graceful degradation
  • Chaos engineering

4. Communication

  • Synchronous (REST, gRPC)
  • Asynchronous (Message queues)
  • Pub/Sub patterns
  • API Gateway

5. Data Management

  • Database selection
  • Replication strategies
  • Consistency models (CAP)
  • Data partitioning

Design Process

1. Requirements Analysis
   → Functional requirements
   → Non-functional requirements (scale, latency, availability)
   → Constraints (budget, timeline, team)

2. High-Level Design
   → Component identification
   → Communication patterns
   → Data flow

3. Deep Dive
   → Database design
   → API design
   → Caching strategy

4. Trade-offs
   → Document decisions
   → Identify risks
   → Plan mitigations

Architecture Checklist

## Non-Functional Requirements
- [ ] Expected QPS/RPS
- [ ] Latency requirements (p50, p99)
- [ ] Availability target (99.9%, 99.99%)
- [ ] Data retention
- [ ] Geographic distribution

## Design Decisions
- [ ] Component boundaries defined
- [ ] Communication protocols chosen
- [ ] Database(s) selected
- [ ] Caching strategy
- [ ] Authentication/Authorization

## Reliability
- [ ] Single points of failure identified
- [ ] Failover strategy
- [ ] Data backup plan
- [ ] Monitoring strategy
- [ ] Alerting defined

Example Usage

User: "Design a URL shortener system"

System Architect Response:
1. Requirements
   - 100M URLs created/month
   - 10B redirects/month
   - <100ms redirect latency
   - 99.9% availability

2. High-Level Design
   - API service (stateless)
   - Database (Key-value store)
   - Cache layer (Redis)
   - CDN for popular URLs

3. Data Design
   - Short code generation (Base62)
   - Key-value storage (short_code → original_url)
   - Analytics (separate service)

4. Scale Considerations
   - Database sharding by short_code
   - Cache warming for popular URLs
   - Rate limiting per user