name	event-storming
description	Event Storming 기법을 사용하여 PlantUML 시퀀스 다이어그램을 작성하고 유저스토리 개발을 준비합니다. 기획 구체화 시 사용하세요.

Event Storming - 기획 구체화

목적

DDD(Domain-Driven Design)의 Event Storming 기법을 활용하여 선택된 솔루션의 시스템 이벤트 흐름을 분석하고, PlantUML 시퀀스 다이어그램으로 표현하여 유저스토리 작성을 준비합니다.

사용 시점

핵심 솔루션이 선정된 후
유저스토리 작성 전 시스템 설계가 필요할 때
비즈니스 플로우를 시각화해야 할 때
사용자가 "이벤트 스토밍", "시퀀스 다이어그램", "유저플로우"를 언급할 때

필수 입력

핵심 솔루션: think/핵심솔루션.md (solution-selection 결과)
대상 고객 정의: define/고객분석.md (customer-analysis 결과)
User Journey Map (선택): define/유저저니맵.md (journey-mapping 결과)
비즈니스 모델 (선택): think/비즈니스모델.md (business-modeling 결과)

Event Storming 프로세스

개념 이해

Event Storming은 Alberto Brandolini가 고안한 워크숍 기법으로, 비즈니스 도메인을 빠르게 탐색하고 시각화하는 방법입니다.

단계:

Big Picture: 전체 흐름 파악
Process Modeling: 프로세스 상세화
Software Design: 소프트웨어 설계

우리의 접근 방법

이 skill에서는 Event Storming의 핵심 요소만 추출하여:

이벤트 (Events)
커맨드 (Commands)
액터 (Actors)
정책/규칙 (Policies/Rules)
외부 시스템 (External Systems)
필요 데이터 (Data)

를 도출하고, 이를 PlantUML 시퀀스 다이어그램으로 작성합니다.

PlantUML 시퀀스 다이어그램 작성

1. 유저플로우 식별

먼저 핵심 솔루션의 주요 사용자 플로우를 식별합니다.

예시:

사용자 등록 플로우
로그인 플로우
주문 생성 플로우
결제 플로우
배송 조회 플로우

2. 유저플로우 간 연결도 작성

파일명: think/es/userflow.puml

내용:

@startuml
!theme mono

title 유저플로우 연결도

rectangle "사용자 인증" as auth {
  (1. 회원가입)
  (2. 로그인)
}

rectangle "주요 기능" as main {
  (3. 대시보드 조회)
  (4. 주문 생성)
  (5. 결제 진행)
}

rectangle "부가 기능" as sub {
  (6. 주문 내역 조회)
  (7. 배송 추적)
}

(1. 회원가입) --> (2. 로그인)
(2. 로그인) --> (3. 대시보드 조회)
(3. 대시보드 조회) --> (4. 주문 생성)
(4. 주문 생성) --> (5. 결제 진행)
(5. 결제 진행) --> (6. 주문 내역 조회)
(6. 주문 내역 조회) --> (7. 배송 추적)

@enduml

3. 각 유저플로우별 시퀀스 다이어그램 작성

각 유저플로우마다 별도의 PlantUML 파일로 작성합니다.

파일명 형식: think/es/{순번}-{유저플로우명}.puml 예시: think/es/01-회원가입.puml, think/es/02-로그인.puml

PlantUML 시퀀스 다이어그램 템플릿

@startuml
!theme mono

title [유저플로우명]

' 참여자 정의 (Actor, UI, API, Service, External System)
actor 사용자 as user
participant "UI\n(화면)" as ui
participant "API\n(컨트롤러)" as api
participant "서비스\n(비즈니스 로직)" as service
participant "데이터베이스" as db
participant "외부시스템" as external

' 시퀀스 흐름
user -> ui : [커맨드]\n(필요 데이터)
activate ui

ui -> api : [API 호출]\n(요청 데이터)
activate api

' Policy/Rule 표시
note over api : [Policy/Rule]
api -> service : [비즈니스 로직 호출]\n(처리 데이터)
activate service

service -> db : [데이터 저장/조회]
activate db
db --> service : 결과
deactivate db

alt 외부 시스템 호출 필요시
    service -> external : [외부 API 호출]
    activate external
    external --> service : 응답
    deactivate external
end

service --> api : [이벤트 발생]\n(이벤트 데이터)
deactivate service

api --> ui : 처리 결과
deactivate api

ui --> user : 화면 갱신
deactivate ui

@enduml

4. Event Storming 핵심 요소 도출

이벤트 (Events)

시스템에서 발생하는 중요한 사건 (과거형)

표기: [이벤트명] 발생 예시:

회원가입 완료됨
로그인 성공됨
주문 생성됨
결제 완료됨
배송 시작됨

커맨드 (Commands)

사용자나 시스템이 수행하는 행위 (명령형)

표기: [커맨드명] 예시:

회원가입 요청
로그인 시도
주문 생성
결제 진행
배송 조회

액터 (Actors)

시스템과 상호작용하는 주체

예시:

사용자
관리자
배송 기사
시스템 스케줄러

정책/규칙 (Policies/Rules)

이벤트 발생 시 자동으로 실행되는 규칙

표기: note over [참여자] : [정책/규칙] 예시:

"이메일 중복 확인"
"재고 확인 필수"
"결제 금액 검증"
"배송지 유효성 검사"

외부 시스템 (External Systems)

시스템이 연동하는 외부 서비스

예시:

결제 게이트웨이 (PG사)
이메일 발송 서비스
SMS 서비스
물류 시스템
지도 API

필요 데이터 (Data)

각 단계에서 필요한 데이터를 명시

표기: 화살표 라벨에 (데이터)로 표시 예시:

(이메일, 비밀번호, 이름)
(주문 ID, 상품 목록, 배송지)
(결제 금액, 결제 수단)

PlantUML 시퀀스 다이어그램 상세 예시

예시 1: 회원가입 플로우

파일: think/es/01-회원가입.puml

@startuml
!theme mono

title 회원가입 플로우

actor 사용자 as user
participant "회원가입\n화면" as ui
participant "회원\nAPI" as api
participant "회원\n서비스" as service
participant "회원\nDB" as db
participant "이메일\n서비스" as email

user -> ui : 회원가입 버튼 클릭
activate ui

ui -> ui : 입력 폼 표시

user -> ui : 정보 입력\n(이메일, 비밀번호, 이름)

user -> ui : 가입하기 버튼 클릭

ui -> api : POST /api/users/signup\n(이메일, 비밀번호, 이름)
activate api

note over api : [정책]\n- 이메일 형식 검증\n- 비밀번호 강도 검증

api -> service : registerUser(userData)
activate service

service -> db : 이메일 중복 확인
activate db
db --> service : 중복 여부
deactivate db

alt 이메일 중복
    service --> api : 에러: 이메일 중복
    api --> ui : 400 Bad Request
    ui --> user : 오류 메시지 표시
else 중복 없음
    service -> db : 회원 정보 저장\n(해시된 비밀번호)
    activate db
    db --> service : 회원 ID
    deactivate db

    note over service : [이벤트]\n회원가입 완료됨

    service -> email : 가입 환영 이메일 발송\n(이메일, 이름)
    activate email
    email --> service : 발송 완료
    deactivate email

    service --> api : 회원 정보
    deactivate service

    api --> ui : 200 OK\n(회원 ID, 토큰)
    deactivate api

    ui --> user : 가입 완료 화면 표시
    deactivate ui
end

@enduml

예시 2: 주문 생성 플로우

파일: think/es/04-주문생성.puml

@startuml
!theme mono

title 주문 생성 플로우

actor 사용자 as user
participant "주문\n화면" as ui
participant "주문\nAPI" as api
participant "주문\n서비스" as service
participant "재고\n서비스" as inventory
participant "주문\nDB" as db

user -> ui : 상품 선택
activate ui

user -> ui : 주문하기 클릭\n(상품 ID, 수량, 배송지)

ui -> api : POST /api/orders\n(상품 ID, 수량, 배송지)
activate api

note over api : [정책]\n- 로그인 사용자 확인\n- 배송지 필수 입력

api -> service : createOrder(orderData)
activate service

service -> inventory : checkInventory(상품 ID, 수량)
activate inventory
inventory --> service : 재고 확인 결과
deactivate inventory

alt 재고 부족
    service --> api : 에러: 재고 부족
    api --> ui : 400 Bad Request
    ui --> user : 재고 부족 메시지
else 재고 충분
    service -> inventory : reserveInventory(상품 ID, 수량)
    activate inventory
    inventory --> service : 재고 예약 완료
    deactivate inventory

    service -> db : 주문 정보 저장
    activate db
    db --> service : 주문 ID
    deactivate db

    note over service : [이벤트]\n주문 생성됨

    service --> api : 주문 정보
    deactivate service

    api --> ui : 201 Created\n(주문 ID, 주문 번호)
    deactivate api

    ui --> user : 결제 화면으로 이동
    deactivate ui
end

@enduml

PlantUML 확인 방법

작성한 PlantUML 다이어그램은 다음 방법으로 확인할 수 있습니다:

방법 1: PlantUML Online Server

https://plantuml.com 접속
좌측 메뉴에서 "Online Server" 클릭
PlantUML 스크립트 붙여넣기
하단 우측 PNG 또는 SVG 링크에서 우클릭 > "새 탭에서 링크 열기"

방법 2: VS Code 플러그인

VS Code에서 "PlantUML" 확장 설치
.puml 파일 열기
Alt + D (미리보기 창 열기)

유저스토리 연결

Event Storming 결과는 다음 단계인 유저스토리 작성의 기반이 됩니다.

유저스토리 도출 방법

1. 유저플로우 → Epic

각 주요 유저플로우가 하나의 Epic이 됩니다.

예시:

Epic 1: 사용자 인증
- Story 1.1: 회원가입
- Story 1.2: 로그인
- Story 1.3: 비밀번호 재설정

2. 시퀀스 다이어그램 → User Story

각 시퀀스 다이어그램의 흐름이 하나의 User Story가 됩니다.

예시:

User Story 1.1: 회원가입

As a 신규 사용자,
I want 이메일로 회원가입하기,
So that 서비스를 이용할 수 있다.

Acceptance Criteria:
- Given 회원가입 화면에서
  When 유효한 이메일, 비밀번호, 이름을 입력하고 가입하기 버튼을 클릭하면
  Then 회원 정보가 저장되고 환영 이메일이 발송된다

- Given 회원가입 화면에서
  When 이미 등록된 이메일로 가입을 시도하면
  Then "이미 등록된 이메일입니다" 오류 메시지가 표시된다

3. Policy/Rule → Acceptance Criteria

시퀀스 다이어그램의 정책/규칙이 Acceptance Criteria가 됩니다.

4. 이벤트 → 시스템 동작 검증

각 이벤트는 시스템 동작의 검증 포인트가 됩니다.

도구 활용

Sequential MCP 사용

복잡한 시스템 분석과 체계적인 이벤트 도출을 위해 Sequential MCP를 활용하세요.

작성 순서

핵심 솔루션 분석
주요 유저플로우 식별 (5-10개)
유저플로우 간 연결도 작성
각 유저플로우별 시퀀스 다이어그램 작성
이벤트, 커맨드, 액터, 정책, 외부시스템 도출
유저스토리 준비 정보 정리

출력 파일

필수 파일

유저플로우 연결도: think/es/userflow.puml
각 유저플로우 시퀀스: think/es/{순번}-{유저플로우명}.puml
- 예: think/es/01-회원가입.puml
- 예: think/es/02-로그인.puml
- 예: think/es/03-대시보드조회.puml

파일명 규칙

순번: 2자리 숫자 (01, 02, 03...)
유저플로우명: 한글로 작성
확장자: .puml

중요 가이드라인

PlantUML 작성 규칙

테마: 항상 !theme mono 사용
한국어: 모든 텍스트를 한국어로 작성
이벤트: 과거형으로 표현 (예: "회원가입 완료됨", "주문 생성됨")
커맨드: 명령형으로 표현 (예: "회원가입 요청", "주문 생성")
데이터: 화살표 라벨에 괄호로 명시 (예: (이메일, 비밀번호))
정책: note over 사용하여 명시

Sequential MCP 활용

복잡한 도메인 분석
이벤트와 커맨드 도출
유저플로우 간 의존성 분석
유저스토리 준비 정보 생성

유저스토리 에이전트 준비

최소 5개 이상의 핵심 유저플로우 작성
각 시퀀스 다이어그램은 구현 가능한 수준으로 상세하게
이벤트, 커맨드, 정책을 명확히 표시
외부 시스템 연동이 필요한 경우 명시

품질 기준

실제 시스템 아키텍처를 반영
유저스토리로 직접 변환 가능한 수준
개발팀이 이해하고 구현할 수 있는 명확성
비즈니스 로직과 기술적 세부사항의 균형

다음 단계

Event Storming이 완료되면:

user-stories skill을 사용하여 유저스토리 작성
시퀀스 다이어그램을 참고하여 Acceptance Criteria 작성
Epic과 Story 우선순위 결정
Sprint Planning 수행

Install Skill

SKILL.md