event-storming
Event Storming 기법을 사용하여 PlantUML 시퀀스 다이어그램을 작성하고 유저스토리 개발을 준비합니다. 기획 구체화 시 사용하세요.
$ 安裝
git clone https://github.com/cna-bootcamp/aiguide /tmp/aiguide && cp -r /tmp/aiguide/.claude/skills/14-event-storming ~/.claude/skills/aiguide// tip: Run this command in your terminal to install the skill
name: event-storming description: Event Storming 기법을 사용하여 PlantUML 시퀀스 다이어그램을 작성하고 유저스토리 개발을 준비합니다. 기획 구체화 시 사용하세요.
이벤트 스토밍으로 기획 구체화
목적
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
- 참여자: Actor, 내부서비스, 외부시스템으로만 구성
- 내부서비스: 내부의 업무 그룹을 명시. 예) 회원업무, 결제업무
- 외부시스템: "(E){외부시스템명}"으로 표시. 예) (E)CRM
- (중요) 내부서비스 내부와 외부시스템 내부에서 이루어지는 플로우는 표시하지 않음
- (중요) 이벤트 스토밍 요소를 명확히 표시: [{이벤트 스토밍 요소}] {내용}
- 예1) [이벤트] 차량등록 시작됨
- 예2) [커맨드] 차량 등록 버튼 클릭
- 예3) [정책/규칙] 가격 100만원 이상 확인
- 예4) [데이터] 차량정보
- 이벤트: 과거형으로 표현 (예: "회원가입 완료됨", "주문 생성됨")
- 커맨드: 명령형으로 표현 (예: "회원가입 요청", "주문 생성")
- 데이터: 화살표 라벨에 괄호로 명시 (예:
(이메일, 비밀번호)) - 정책:
note over사용하여 명시
4. Event Storming 핵심 요소 도출
이벤트 (Events)
시스템에서 발생하는 중요한 사건 (과거형)
표기: [이벤트명] 발생
예시:
- 회원가입 완료됨
- 로그인 성공됨
- 주문 생성됨
- 결제 완료됨
- 배송 시작됨
커맨드 (Commands)
사용자나 시스템이 수행하는 행위 (명령형)
표기: [커맨드명]
예시:
- 회원가입 요청
- 로그인 시도
- 주문 생성
- 결제 진행
- 배송 조회
액터 (Actors)
시스템과 상호작용하는 주체
예시:
- 사용자
- 관리자
- 배송 기사
- 시스템 스케줄러
정책/규칙 (Policies/Rules)
이벤트 발생 시 자동으로 실행되는 규칙
표기: note over [참여자] : [정책/규칙]
예시:
- "이메일 중복 확인"
- "재고 확인 필수"
- "결제 금액 검증"
- "배송지 유효성 검사"
외부 시스템 (External Systems)
시스템이 연동하는 외부 서비스
예시:
- 결제 게이트웨이 (PG사)
- 이메일 발송 서비스
- SMS 서비스
- 물류 시스템
- 지도 API
필요 데이터 (Data)
각 단계에서 필요한 데이터를 명시
표기: 화살표 라벨에 (데이터)로 표시
예시:
- (이메일, 비밀번호, 이름)
- (주문 ID, 상품 목록, 배송지)
- (결제 금액, 결제 수단)
PlantUML 확인 방법
작성한 PlantUML 다이어그램은 다음 방법으로 확인할 수 있습니다:
방법 1: PlantUML Online Server
- https://plantuml.com 접속
- 좌측 메뉴에서 "Online Server" 클릭
- PlantUML 스크립트 붙여넣기
- 하단 우측 PNG 또는 SVG 링크에서 우클릭 > "새 탭에서 링크 열기"
방법 2: VS Code 플러그인
- VS Code에서 "PlantUML" 확장 설치
- .puml 파일 열기
Alt + D(미리보기 창 열기)
도구 활용
작성 순서
- 핵심 솔루션 분석
- 주요 유저플로우 식별 (5-10개)
- 유저플로우 간 연결도 작성
- 각 유저플로우별 시퀀스 다이어그램에 아래 이벤트 스토밍 요소 식별하여 작성
- 이벤트 (Events)
- 커맨드 (Commands)
- 액터 (Actors)
- 정책/규칙 (Policies/Rules)
- 외부 시스템 (External Systems)
- 필요 데이터 (Data)
출력 파일
필수 파일
- 유저플로우 연결도:
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사용 - 한국어: 모든 텍스트를 한국어로 작성
Sequential MCP 활용
- 복잡한 도메인 분석
- 이벤트와 커맨드 도출
- 유저플로우 간 의존성 분석
품질 기준
- 실제 시스템 아키텍처를 반영
- 유저스토리로 직접 변환 가능한 수준
- 개발팀이 이해하고 구현할 수 있는 명확성
- 비즈니스 로직과 기술적 세부사항의 균형
다음 단계
Event Storming이 완료되면:
user-storiesskill을 사용하여 유저스토리 작성- 시퀀스 다이어그램을 참고하여 Acceptance Criteria 작성
- Epic과 Story 우선순위 결정
- Sprint Planning 수행
Repository
