Agent skill

Distributed Patterns

by revfactory in revfactory/harness-100

분산 시스템 핵심 패턴(Saga, CQRS, Circuit Breaker, 이벤트 소싱 등)의 구현 가이드와 선택 매트릭스.

Apache-2.0Auto-check passedBackend & APIs

Install Distributed Patterns

skills CLI
$ npx skills add revfactory/harness-100 --skill distributed-patterns -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install revfactory/harness-100 distributed-patterns --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/revfactory/harness-100.git skills-src && mkdir -p .claude/skills && cp -r skills-src/ko/23-microservice-designer/.claude/skills/distributed-patterns .claude/skills/distributed-patterns && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
distributed-patterns
GitHub stars
1.3k
Token cost
~1k tokens
SKILL.md length
285 words
Files
1
Skills in repo
464
Repo updated
First seen
Licence
Apache-2.0

At a glance

분산 시스템 핵심 패턴(Saga, CQRS, Circuit Breaker, 이벤트 소싱 등)의 구현 가이드와 선택 매트릭스.

  • Works in 5 steps: Saga 패턴 → CQRS (Command Query Responsibility… → Circuit Breaker → …
  • Tasks that involve Event-driven systems
  • SKILL.md covers 1. Saga 패턴, 2. CQRS (Command Query…, 3. Circuit Breaker and 4. Event Sourcing, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Distributed Patterns is an agent skill from revfactory/harness-100. 분산 시스템 핵심 패턴(Saga, CQRS, Circuit Breaker, 이벤트 소싱 등)의 구현 가이드와 선택 매트릭스. '분산 트랜잭션', 'Saga 패턴', 'CQRS', '서킷 브레이커', '이벤트 소싱', '분산 패턴', '보상 트랜잭션', '최종 일관성' 등 분산 시스템 패턴 적용 시 이 스킬을 사용한다. communication-designer와 service-architect의 분산 시스템 설계 역량을 강화한다. 단, 인프라 구축이나 모니터링 설정은 이 스킬의 범위가 아니다.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs, covering Event-driven systems. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Event-driven systems

Example prompts

  • “Saga 패턴”
  • “/distributed-patterns”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Saga 패턴
  2. CQRS (Command Query Responsibility Segregation)
  3. Circuit Breaker
  4. Event Sourcing
  5. API Gateway 패턴

What it can do on your machine

Read from SKILL.md and the folder at commit 8e8d35c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Distributed Patterns loads about 1k tokens when it runs. Until then it costs about 75 tokens; SKILL.md has 285 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~75
When it runs · the whole SKILL.md, loaded when a task matches
~1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from revfactory/harness-100 at commit 8e8d35c, republished under its Apache-2.0 licence (© revfactory). 285 words, ~1,019 tokens.

Download SKILL.mdSave it as .claude/skills/distributed-patterns/SKILL.md (or your agent's skills folder).
name
distributed-patterns
description
분산 시스템 핵심 패턴(Saga, CQRS, Circuit Breaker, 이벤트 소싱 등)의 구현 가이드와 선택 매트릭스. '분산 트랜잭션', 'Saga 패턴', 'CQRS', '서킷 브레이커', '이벤트 소싱', '분산 패턴', '보상 트랜잭션', '최종 일관성' 등 분산 시스템 패턴 적용 시 이 스킬을 사용한다. communication-designer와 service-architect의 분산 시스템 설계 역량을 강화한다. 단, 인프라 구축이나 모니터링 설정은 이 스킬의 범위가 아니다.

Distributed Patterns — 분산 시스템 핵심 패턴 가이드

마이크로서비스 간 통신, 데이터 일관성, 장애 대응을 위한 패턴 구현 상세.

1. Saga 패턴

Choreography vs Orchestration 선택
기준ChoreographyOrchestration
서비스 수2~4개5개 이상
흐름 복잡도선형분기/조건부
결합도이벤트 기반 느슨한 결합오케스트레이터에 집중
가시성흐름 추적 어려움중앙에서 상태 관리
실패 처리각 서비스 자체 보상오케스트레이터가 보상 조율
Orchestration Saga 구현
주문 Saga:
T1: 주문 생성 ──→ C1: 주문 취소
T2: 재고 차감 ──→ C2: 재고 복원
T3: 결제 처리 ──→ C3: 결제 환불
T4: 배송 요청 ──→ C4: 배송 취소

실패 시나리오 (T3 실패):
T1 → T2 → T3(실패) → C2(재고 복원) → C1(주문 취소)
Saga 상태 머신
STARTED → INVENTORY_RESERVED → PAYMENT_PROCESSED → SHIPPING_REQUESTED → COMPLETED
    ↓           ↓                    ↓                    ↓
 FAILED → COMPENSATING_INVENTORY → COMPENSATING_PAYMENT → COMPENSATING_SHIPPING
                                                              ↓
                                                         COMPENSATED

2. CQRS (Command Query Responsibility Segregation)

┌──────────┐     Command     ┌───────────────┐
│  Client   │ ──────────────→│ Write Model   │──→ Event Store
│           │                │ (정규화 DB)    │
│           │     Query      ┌───────────────┐
│           │ ←──────────── │ Read Model    │←── Projection
│           │                │ (비정규화 뷰)  │
└──────────┘                └───────────────┘

적용 기준:

적용해야 할 때적용하면 안 될 때
읽기/쓰기 부하 비대칭 (100:1)단순 CRUD 앱
읽기 모델과 쓰기 모델이 매우 다름읽기/쓰기 모델이 거의 동일
복잡한 도메인 로직 + 다양한 뷰최종 일관성 허용 불가
이벤트 소싱과 함께 사용팀 규모가 작음 (< 3명)

3. Circuit Breaker

상태 전이
CLOSED ──(실패율 > 임계값)──→ OPEN
   ↑                            │
   │                        (타임아웃 후)
   │                            ↓
   └──(성공)── HALF_OPEN ──(실패)──→ OPEN
설정 가이드
파라미터권장값설명
failureRateThreshold50%OPEN 전환 실패율
slowCallRateThreshold80%느린 호출 비율 임계
slowCallDurationThreshold3s느린 호출 기준
waitDurationInOpenState30sHALF_OPEN 전환 대기
slidingWindowSize100측정 윈도우 크기
minimumNumberOfCalls10최소 호출 수
Fallback 전략
전략적용예시
캐시 응답읽기 API마지막 성공 응답 반환
기본값비핵심 기능추천 목록 대신 인기 상품
대체 서비스결제주 PG 장애 시 보조 PG
큐잉비동기 가능주문을 큐에 저장 후 처리
에러 응답핵심 기능명확한 오류 메시지

4. Event Sourcing

전통 방식: 현재 상태만 저장
  Account { balance: 750 }

이벤트 소싱: 모든 변경 이력 저장
  1. AccountOpened  { id: A1 }
  2. MoneyDeposited { amount: 1000 }
  3. MoneyWithdrawn { amount: 250 }
  → 현재 상태 재구성: balance = 0 + 1000 - 250 = 750

스냅샷 전략:

전략조건장점
이벤트 수 기반N개마다 스냅샷예측 가능한 성능
시간 기반N분마다 스냅샷일정한 복구 시간
온디맨드읽기 시 캐시 미스저장 공간 절약

5. API Gateway 패턴

패턴설명적용
API Composition여러 서비스 응답 합성BFF (Backend for Frontend)
Rate Limiting요청 속도 제한Token Bucket / Sliding Window
Request Routing경로 기반 라우팅/api/v1/orders → order-service
Protocol Translation프로토콜 변환REST → gRPC, WebSocket → HTTP

패턴 조합 레시피

이커머스 주문 처리
Saga(Orchestration) + Event Sourcing + CQRS
├── 주문 Saga: 재고→결제→배송 조율
├── 각 서비스: 이벤트 소싱으로 감사 추적
└── 주문 조회: CQRS Read Model로 빠른 조회
실시간 채팅
Event-Driven + Circuit Breaker + API Gateway
├── 메시지: 이벤트 스트리밍 (Kafka)
├── 부가 기능: Circuit Breaker (번역, 필터링)
└── 클라이언트: WebSocket Gateway

CAP 정리 실무 적용

              일관성 (Consistency)
                    /\
                   /  \
              CP  /    \ CA
                 /      \
                /________\
    가용성(A) ────────── 분단허용(P)
                  AP

실무 선택:
- CP: 결제, 재고 (정확성 최우선)
- AP: 상품 조회, 추천 (가용성 최우선)
- CA: 단일 노드 DB (분산 아님)

© revfactory, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in ko/23-microservice-designer/.claude/skills/distributed-patterns of revfactory/harness-100.

Open the folder on GitHubat commit 8e8d35c

Compare with similar skills

Distributed Patterns next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Distributed Patterns compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Distributed Patterns this skillrevfactory/harness-1001.3k—~1kAutomated safety check: PassApache-2.0
Stripe Projectsfossasia/eventyay1.7k5 repos~2kAutomated safety check: NotesApache-2.0
MQTTX CLIemqx/MQTTX5.1k—~1.9kAutomated safety check: PassApache-2.0
AWS Serverless Edazxkane/aws-skills3674 repos~3.2kAutomated safety check: PassMIT
Windmill Trigger Type Checklistwindmill-labs/windmill18k—~4.7kAutomated safety check: PassCustom licence
FoundatioFoundatioFx/Foundatio2.1k—~3.9kAutomated safety check: PassApache-2.0

Similar skills

  • Stripe Projects

    fossasia/eventyay

    A skill your agent uses when the user wants to provision infrastructure or third-party services using Stripe Projects.

    1.7k GitHub starsUsed in 5 repos~2k tokens
    Backend & APIsAuto-check: notes
  • MQTTX CLI

    emqx/MQTTX

    Operates the `mqttx` command line client to connect, publish, subscribe, benchmark and simulate data against an MQTT broker, with TLS and MQTT 5 support.

    5.1k GitHub stars~1.9k tokensUpdated 6 days ago
    Backend & APIsAuto-check passed
  • AWS Serverless Eda

    zxkane/aws-skills

    AWS serverless and event-driven architecture expert based on Well-Architected Framework.

    367 GitHub starsUsed in 4 repos~3.2k tokens
    Backend & APIsAuto-check passed
  • Windmill Trigger Type Checklist

    windmill-labs/windmill

    Checklist of every backend, frontend, CLI and capture change needed to add a new TriggerCrud-based trigger type, such as Azure, GCP or Kafka, to Windmill.

    18k GitHub stars~4.7k tokensUpdated today
    Backend & APIsAuto-check passed
  • Foundatio

    FoundatioFx/Foundatio

    A skill your agent uses when working with Foundatio infrastructure abstractions for .NET -- caching, queuing, messaging, file storage, distributed locking, or background jobs.

    2.1k GitHub stars~3.9k tokensUpdated today
    Backend & APIsAuto-check passed
  • Homerail Dag Ops

    xiaotianfotos/homerail

    Design, start, supervise, inspect, and continue HomeRail DAG workflows from any agent with CLI or HTTP access.

    991 GitHub stars~1.5k tokensUpdated 11 days ago
    Backend & APIsAuto-check passed

More from revfactory/harness-100

All 464 skills in this repo
  • Anti Bot Analyzer

    revfactory/harness-100

    A skill for analyzing website anti-bot defense mechanisms and developing legitimate evasion strategies.

    1.3k GitHub stars~1.1k tokensUpdated 6 mo ago
    Auto-check passed
  • API Error Design Patterns

    revfactory/harness-100

    Reference for designing how an API reports failures: structured error codes, response shapes, client-friendly messages, an error catalog and retry or fallback advice.

    1.3k GitHub stars~1.6k tokensUpdated 6 mo ago
    Auto-check passed
  • API Security Checklist

    revfactory/harness-100

    Walks a backend-dev agent through OWASP API Top 10 checks, authentication and authorization patterns, and defense code during API design.

    1.3k GitHub stars~1.7k tokensUpdated 6 mo ago
    Auto-check passed
  • Arg Parser Generator

    revfactory/harness-100

    Methodology for systematically designing and generating CLI tool argument parser structures.

    1.3k GitHub stars~1.2k tokensUpdated 6 mo ago
    Auto-check passed
  • Audience Segmentation

    revfactory/harness-100

    Audience segmentation skill used by the analyst and curator agents.

    1.3k GitHub stars~1.3k tokensUpdated 6 mo ago
    Auto-check passed
  • Audio Storytelling

    revfactory/harness-100

    Audio storytelling skill used by the podcast scriptwriter and show note editor.

    1.3k GitHub stars~1.6k tokensUpdated 6 mo ago
    Auto-check passed

Categories

Questions about Distributed Patterns

What does Distributed Patterns do?

분산 시스템 핵심 패턴(Saga, CQRS, Circuit Breaker, 이벤트 소싱 등)의 구현 가이드와 선택 매트릭스. Distributed Patterns is an agent skill from revfactory/harness-100. 분산 시스템 핵심 패턴(Saga, CQRS, Circuit Breaker, 이벤트 소싱 등)의 구현 가이드와 선택 매트릭스.

When should I use Distributed Patterns?

Distributed Patterns fits situations like: tasks that involve Event-driven systems.

How do I install Distributed Patterns in Claude Code?

Run `npx skills add revfactory/harness-100 --skill distributed-patterns -a claude-code`. Or copy the skill folder (ko/23-microservice-designer/.claude/skills/distributed-patterns in revfactory/harness-100) into .claude/skills/distributed-patterns in your project. Claude Code loads it when a task matches its description.

How do I install Distributed Patterns in Codex?

Run `npx skills add revfactory/harness-100 --skill distributed-patterns -a codex`. Or copy the skill folder (ko/23-microservice-designer/.claude/skills/distributed-patterns in revfactory/harness-100) into .agents/skills/distributed-patterns in your project. Codex loads it when a task matches its description.

Can I use Distributed Patterns in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add revfactory/harness-100 --skill distributed-patterns -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/distributed-patterns, .gemini/skills/distributed-patterns, .github/skills/distributed-patterns and .opencode/skills/distributed-patterns in your project.

What does Distributed Patterns need to run?

SKILL.md names no scripts, command-line tools or credentials: Distributed Patterns is instructions for the agent only.

Does Distributed Patterns access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Distributed Patterns safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Distributed Patterns use?

Distributed Patterns is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Distributed Patterns use?

About 1k tokens (SKILL.md is roughly 4.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Distributed Patterns?

Skills that share tags, products or a category with Distributed Patterns: Stripe Projects (fossasia/eventyay, 1.7k stars), MQTTX CLI (emqx/MQTTX, 5.1k stars), AWS Serverless Eda (zxkane/aws-skills, 367 stars) and Windmill Trigger Type Checklist (windmill-labs/windmill, 18k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Distributed Patterns?

revfactory (a GitHub user) maintains it in revfactory/harness-100, which has 1,290 GitHub stars. The repository holds 464 skills in this directory. The repository was last updated on March 22, 2026.

Source: revfactory/harness-100 on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.