architecture

Plugin architecture from marketplace ress in ressKim-io/ress-claude-agents. Commands read from the repo's manifest — yesterday.

Skills (25)

• api-design

  REST API 설계 — URL 규칙, RFC 9457 Problem Details 에러 응답, 페이지네이션, 필터링·정렬, 버저닝. Use when 새 REST 엔드포인트와 에러·페이징·버전 정책을 설계하거나 기존 API 를 리뷰할 때.

• cell-based-architecture

  Cell-Based Architecture 가이드 — 대규모 장애 격리를 위한 Cell 기반 아키텍처: Bulkhead 패턴, 블라스트 반경 제한, Horizontal Isolation. Use when cascade failure 격리 / 다중 리전 blast radius 분석이 필요할 때.

• composable-architecture

  조합형 아키텍처(MACH) — Packaged Business Capabilities(PBC), API Composition, Micro-Frontends 로 교체 가능한 구성 요소 설계. Use when 모놀리식 제품을 교체·조합 가능한 비즈니스 capability 단위로 나누려 할 때.

• config-explicit-defaults

  묵시적 기본값 방지 — 명시값·라이브러리 기본값·환경별 override 3단 검증과 silent default drift 점검. Use when 설정·환경변수를 추가하거나 버전업 후 기본값 변경으로 동작이 달라질 위험을 점검할 때.

• consumer-driven-contracts

  Consumer-Driven Contracts — Pact consumer test, provider verification, GitOps 연동으로 서비스 간 API contract drift 방지. Use when 마이크로서비스 간 필드 제거·변경이 소비자를 깨뜨리는 사고를 막고 싶을 때.

• contract-first

  Contract-First 개발 — OpenAPI 3.1 spec-first, Protobuf/gRPC, AsyncAPI, Schema Registry, 코드 생성 CI 파이프라인. Use when 구현 전에 API·이벤트 스키마를 먼저 정의하고 서버·클라이언트 코드를 생성할 때.

• data-mesh

  Data Mesh — 도메인 소유권, Data as a Product, 셀프서비스 데이터 플랫폼, 연합 거버넌스, Spring Boot·Go data product 구현. Use when 중앙 데이터 팀 병목을 도메인별 데이터 소유 구조로 전환하려 할 때.

• distributed-lock

  분산 락 — Redisson(Spring Boot), Redsync(Go Redlock), ShedLock 스케줄러 중복 방지, Fencing Token. Use when 다중 인스턴스 환경에서 동시 실행·중복 처리·경쟁 상태를 막는 락을 설계할 때.

• graphql-federation

  GraphQL Federation — Apollo Federation v2 Supergraph, Subgraph 스키마 설계, Go gqlgen·Spring DGS 구현, Router 배포, Schema CI. Use when 여러 서비스의 GraphQL 스키마를 하나의 supergraph 로 통합할 때.

• grpc

  gRPC 서비스 설계 — Protocol Buffers, buf 설정, Go·Spring 구현, 스트리밍, 에러 처리, 인터셉터, gRPC-Gateway. Use when 서비스 간 gRPC API 를 정의하거나 스트리밍·에러 코드·성능 문제를 다룰 때.

• hexagonal-clean-architecture

  Hexagonal(Ports & Adapters)·Clean Architecture — 의존성 역전, 도메인 중심 계층 구조, Spring Boot·Go 구현. Use when 도메인 로직을 프레임워크·DB 에서 분리해 테스트하기 쉬운 구조로 설계할 때.

• high-traffic-design

  대규모 트래픽 설계 — Backpressure, Rate Limiting, CDN Edge, Connection Pooling, Queue Load Leveling, Request Batching. Use when 트래픽 폭주에도 버티는 아키텍처를 설계하거나 병목·과부하 대응책을 고를 때.

• modular-monolith

  모듈러 모놀리스 — 단일 배포 안에서 모듈 경계 강제, Spring Modulith, Go internal 패키지, 서비스 추출 전략. Use when MSA 로 가기 전에 모놀리스 내부 경계를 정리하거나 모듈을 서비스로 분리할 때.

• msa-api-gateway-patterns

  MSA API Gateway 패턴 — BFF, Gateway Aggregation, Protocol Translation, 계층형 인가, API 버저닝·deprecation. Use when 클라이언트별 진입점이나 게이트웨이의 집계·인증 책임을 설계할 때.

• msa-cqrs-eventsourcing

  CQRS 와 Event Sourcing — Command/Query 분리, 이벤트 저장소, Eventual Consistency, Axon Framework. Use when 읽기·쓰기 모델을 분리하거나 상태 변경 이력을 이벤트로 저장하는 구조를 검토할 때.

• msa-ddd

  DDD 마이크로서비스 설계 — Bounded Context, Aggregate, Domain Event, Context Mapping, Event Storming, 서비스 분해 전략. Use when 도메인 기준으로 서비스 경계를 나누거나 Aggregate 를 설계할 때.

• msa-event-driven

  이벤트 드리븐 아키텍처 — 서비스 간 비동기 통신, 이벤트 스키마 설계, 발행·수신 패턴, 메시징 패턴 비교. Use when 서비스 간 결합을 이벤트로 풀거나 이벤트 스키마와 발행·소비 방식을 정할 때.

• msa-observability

  MSA 분산 추적 — Distributed Tracing, Trace Context 전파, Correlation ID, Baggage, Span Attributes, Exemplar, 서비스 토폴로지. Use when 여러 서비스에 걸친 요청 흐름을 추적하거나 trace 가 끊기는 문제를 풀 때.

• msa-resilience

  MSA 복원력 — Resilience4j Circuit Breaker, Bulkhead, Retry, Timeout, Fallback 조합과 Istio 연동. Use when 하위 서비스 장애가 연쇄 전파되지 않게 장애 격리·재시도 정책을 설계할 때.

• msa-saga

  Saga 패턴 — Choreography vs Orchestration, 보상 트랜잭션, 실패 처리. Use when 여러 서비스에 걸친 분산 트랜잭션의 일관성과 롤백(compensation)을 설계할 때.

• service-ownership-matrix

  서비스 소유권 — RACI, Shared Responsibility Model, 팀 이름이 아닌 개인·직무 단위 owner 명시, 워크숍 템플릿. Use when 장애 시 책임 주체가 불분명하거나 owner 표기를 정리할 때.

• state-machine

  도메인 상태머신 — 상태 전이 테이블, Go looplab/fsm, Spring State Machine, guard·side effect, 감사 로그, Mermaid 시각화. Use when 주문 같은 엔티티의 상태 전이 규칙을 구현하거나 검증할 때.

• strangler-fig-pattern

  Strangler Fig — 레거시 점진 현대화, API Gateway 라우팅 전환, 데이터 동기화, 신구 시스템 병행 검증. Use when 레거시를 한 번에 갈아엎지 않고 기능 단위로 새 시스템으로 옮길 때.

• task-queue

  Task Queue — Celery, BullMQ, Go asynq, Spring RabbitMQ 기반 비동기 작업 분산, 우선순위 큐, 재시도, Worker 오토스케일링. Use when 무거운 작업을 백그라운드 worker 로 분리하고 재시도·스케일링을 설계할 때.

• vertical-slice-architecture

  Vertical Slice Architecture — 계층이 아닌 feature 단위 코드 구성, Spring Boot·Go 구현, CQRS 결합, 공유 코드 전략. Use when 계층형 구조 대신 기능별로 코드를 묶어 변경 범위를 줄이고 싶을 때.

Subagents (1)

• architect-agent

  MSA 아키텍처 설계 에이전트. 서비스 경계 정의, API 계약(protobuf/OpenAPI) 설계, Bounded Context 매핑, 의존성 분석에 특화. Use for microservice architecture design, service decomposition, and API contract definition. compliance-strategy-agent의 compliance-blueprint를 consume하여 data-model에 규제 제약(PIPA/GDPR) 반영. business-decision-agent의

Similar plugins