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.