system-architecture

Design scalable multi-service architectures with API decisions, data modeling, and resilience patterns.

Updated Feb 9, 2026
One-click install
npx skills add https://github.com/Xza85hrf/claude-code-agent-kit --skill system-architecture-xza85hrf
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: system-architecture
Source: https://github.com/Xza85hrf/claude-code-agent-kit/tree/main/.claude/skills/architecture/system-architecture
Command: npx skills add https://github.com/Xza85hrf/claude-code-agent-kit --skill system-architecture-xza85hrf

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Designing robust, scalable architectures for multi-service or distributed systems to align teams and ensure clear boundaries, data decisions, and reliability patterns.

Core Features & Use Cases

  • Guidance on service boundaries (monolith vs microservices) and architecture decision records (ADRs).
  • Selection of communication patterns, API design, data modeling, and resilience planning for complex systems.
  • Practical templates for ADRs, domain event handling, and migration strategies across evolving architectures.

Quick Start

Propose a multi-service architecture plan for a new product, outlining service boundaries, data modeling, and recommended patterns.

Frequently Asked Questions about system-architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design scalable multi-service architectures for complex software systems?▼

To design scalable multi-service architectures, you must establish clear service boundaries, apply consistent API design, select appropriate data stores, and implement reliability patterns like circuit breakers and event-driven flows.

What is the best way to define service boundaries between monoliths and microservices?▼

Defining service boundaries involves evaluating domain logic to determine whether a monolith or microservices approach fits, ensuring teams align and data modeling decisions maintain clear separation of responsibilities across evolving architectures.

How do I plan resilience patterns for distributed systems?▼

Planning resilience for distributed systems requires implementing patterns like circuit breakers, retries, and event-driven flows to handle failures gracefully and maintain reliability across multi-service architectures.

Can I use this to generate Architecture Decision Records for API design?▼

Yes, you can generate Architecture Decision Records (ADRs) to document API design decisions, data modeling choices, and migration strategies, ensuring consistent communication patterns across your multi-service architecture.

When should I not use microservices for a new product architecture?▼

You should avoid microservices when clear service boundaries cannot be established or when the operational overhead outweighs the benefits, opting instead for a modular monolith to handle complex software systems more effectively.