메뉴
SAGA orchestration pattern, state machine, compensation transactions, and error handling for distributed transactions. Use when implementing order processing across services.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Scaffold a new domain feature with TDD order (entity -> test -> service -> test -> controller -> test)
새 Spring Boot 멀티모듈 프로젝트의 기초 세팅(common shared kernel + Gradle/Docker/CI 골격)을 깔아주는 스킬. 시스템 설계 문서 기반 구현 시작 시 가장 먼저 발동. 핵심 골격만 포함 — `BusinessException`/`ErrorCodeBase`/`ApiResponse`/`GlobalExceptionHandler`/`BaseEntity` + JPA/CORS/OpenAPI configs. Kafka/Outbox/QueryDSL 같은 도메인 특화 패턴은 별도 llm-wiki에서 끌어다 쓴다.
Design partner mode for system design practice. Activated when the user wants to design a new system (chat, notification, news feed, URL shortener, etc.). Sets up topic directory, copies the mock-interview template, loads the matching problem from sysdesign-question-bank, marks the topic as active in .omx/state/, and conducts a back-and-forth Clarifying → High Level → Drill Down conversation, updating <topic>/System-Design-Document/mock-interview.md immediately as each decision lands. Uses Alex Xu Vol.1's canned numbers as the starting point (book-first), user adjusts. NOT an interview — the user drives, this skill is a design collaborator with a calculator (back-of- envelope, latency estimation via auto-injected sysdesign-frameworks) and a reference book (sysdesign-question-bank).
Scaffold a minimum-viable implementation of a designed system. Activated when the user is ready to write code. Reads sdd.md (or falls back to mock-interview.md), determines the smallest component subset that lets the design's NFRs be testable (NOT a full production build — single-region, in-memory or single-container infra, no CDN, no multi-region), asks the user for the language/framework stack (default Spring Boot + PostgreSQL + Kafka per project's existing skill set), then scaffolds <topic>/source/ with per-service directories, a docker-compose.yml that brings everything up locally, and test-results/ scaffolding for functional / load / failure tests. The point is verification of design assumptions, not production.
Promote a filled mock-interview.md into a formal Software Design Document (sdd.md) following the IEEE 1016 / Atlassian / Google design-doc style. Activated when the user says they are ready to write the SDD. Reads the topic's mock-interview.md AND the topic's conversation log files (which capture the back-and-forth detail not preserved in the structured mock-interview), then asks the user the SDD-specific questions that mock-interview doesn't cover (Constraints, ADRs, Risk Register, Rollout, Testing strategy). Writes sdd.md incrementally as decisions land.
TDD workflow, per-layer test types, naming conventions, and test fixture patterns for Spring Boot. Use when writing or reviewing tests.
| name | saga-pattern |
| description | SAGA orchestration pattern, state machine, compensation transactions, and error handling for distributed transactions. Use when implementing order processing across services. |
| triggers | ["saga pattern","saga orchestration","compensation transaction","distributed transaction","choreography pattern","보상 트랜잭션","사가 패턴"] |
| Aspect | Orchestration (chosen) | Choreography |
|---|---|---|
| Control | Central orchestrator (OrderSaga) | Each service reacts to events |
| Visibility | Single place to see full flow | Scattered across services |
| Coupling | Orchestrator knows all steps | Services know next step |
| Debugging | Easy (single state machine) | Hard (event chain tracing) |
| This project | Phase 4+ (recommended) | Not used |
| Step | Service | Action | Compensation |
|---|---|---|---|
| 1 | Product | Reserve stock | Release stock |
| 2 | Payment | Process payment | Refund payment |
| 3 | Order | Confirm order | Cancel order |
| State | On Success -> | On Failure -> |
|---|---|---|
ORDER_CREATED | STOCK_RESERVING | ORDER_REJECTED |
STOCK_RESERVING | PAYMENT_PROCESSING | ORDER_CANCELLED |
PAYMENT_PROCESSING | ORDER_CONFIRMED | STOCK_RELEASING -> ORDER_CANCELLED |
STOCK_RELEASING | ORDER_CANCELLED | ORDER_CANCELLED (log error) |
OrderSaga class manages state transitionssaga_instance table (id, order_id, state, step_data, created_at, updated_at)| Error Type | Handling |
|---|---|
| Transient (network, timeout) | Retry with backoff (max 3 attempts) |
| Business (insufficient stock) | Compensate immediately |
| System (service down) | Circuit breaker + retry after recovery |
| Compensation failure | Log + alert + manual intervention queue |