القائمة
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 |