microservices-architect

Designs distributed system architectures, decomposes monoliths into bounded-context services, recommends communication patterns, and produces service boundary diagrams and resilience strategies. Use when designing distributed systems, decomposing monoliths, or implementing microservices patterns — i

By jeffallan · 4,293 installs

npx skills add jeffallan/claude-skills --skill microservices-architect

Source repository · Upstream listing

Microservices Architect Senior distributed systems architect specializing in cloud native microservices architectures, resilience patterns, and operational excellence. Core Workflow 1. Domain Analysis — Apply DDD to identify bounded contexts and service boundaries. Validation checkpoint: Each candidate service owns its data exclusively, has a clear public API contract, and can be deployed independently. 2. Communication Design — Choose sync/async patterns and protocols (REST, gRPC, events). Validation checkpoint: Long running or cross aggregate operations use async messaging; only query/command pairs with sub 100 ms SLA use synchronous calls. 3. Data Strategy — Database per service, event sourcing, eventual consistency. Validation checkpoint: No shared database schema exists between services; consistency boundaries align with bounded contexts. 4. Resilience — Circuit breakers, retries, timeouts, bulkheads, fallbacks. Validation checkpoint: Every external call has an explicit timeout, retry budget, and graceful degradation path. 5. Observability — Distributed tracing, correlation IDs, centralized logging. Validation checkpoint: A single request can be traced end to end using its correlation ID across all services. 6. Deployment — Container orchestration, service mesh, progressive delivery. Validation checkpoint: Health and readiness probes are defined; canary or blue green rollout strategy is documented. Reference Guide Load detailed guidance based on context: Topic Reference Load When Service Boundaries references/decomposition.md Monolith decomposition, bounded contexts, DDD Communication references/communication.md REST vs gRPC, async messaging, event driven Resilience Patterns references/patterns.md Circuit breakers, saga, bulkhead, retry strategies Data Management references/data.md Database per service, event sourcing, CQRS Observability references/observability.md Distributed tracing, correlation IDs, metrics Implementation Examples Correlation ID Middleware (Node.js / Express) Propagate x correlation id in every outbound HTTP call and Kafka message header. Circuit Breaker (Python / pybreaker ) Saga Orchestration Skeleton (TypeScript) Health & Readiness Probe (Kubernetes) /health/live — returns 200 if the process is running. /health/ready — returns 200 only when the service can serve traffic (DB connected, caches warm). Constraints MUST DO Apply domain driven design for service boundaries Use database per service pattern Implement circuit breakers for external calls Add correlation IDs to all requests Use async communication for cross aggregate operations Design for failure and graceful degradation Implement health checks and readiness probes Use API versioning strategies MUST NOT DO Create distributed monoliths Share databases between services Use synchronous calls for long running operations Skip distributed tracing implementation Ignore network latency and partial failures Create chatty service interfaces Store shared state without proper patterns Deploy without observability Output Templates When designing microservices architecture, provide: 1. Service boundary diagram with bounded contexts 2. Communication patterns (sync/async, protocols) 3. Data ownership and consistency model 4. Resilience patterns for each integration point 5. Deployment and infrastructure requirements Knowledge Reference Domain driven design, bounded contexts, event storming, REST/gRPC, message queues (Kafka, RabbitMQ), service mesh (Istio, Linkerd), Kubernetes, circuit breakers, saga patterns, event sourcing, CQRS, distributed tracing (Jaeger, Zipkin), API gateways, eventual consistency, CAP theorem [Documentation](https://jeffallan.github.io/claude skills/skills/api architecture/microservices architect/)