Incident Postmortem

Incident Postmortem — 장애 사후분석 파이프라인

타임라인재구성→근본원인분석→영향범위산정→재발방지대책→보고서생성을 에이전트 팀이 협업하여 수행한다.

실행 모드

에이전트 팀 — 5명이 SendMessage로 직접 통신하며 교차 검증한다.

에이전트 구성

워크플로우

Phase 1: 준비 (오케스트레이터 직접 수행)

1. 사용자 입력에서 추출한다:
   • 장애 설명: 무엇이 언제 발생했는가
   • 증거 자료 (선택): 로그, 메트릭 스크린샷, 채팅 기록, 알림 기록
   • 영향 정보 (선택): 영향받은 사용자 수, 서비스, 기간
   • 조치 내역 (선택): 이미 수행한 긴급 조치
2. _workspace/ 디렉토리를 프로젝트 루트에 생성한다
3. 입력을 정리하여 _workspace/00_input.md에 저장한다
4. 기존 파일이 있으면 _workspace/에 복사하고 해당 Phase를 건너뛴다
5. 요청 범위에 따라 실행 모드를 결정한다 (아래 "작업 규모별 모드" 참조)

Phase 2: 팀 구성 및 실행

작업 2a(근본원인)와 2b(영향범위)는 병렬 실행 가능하다.

팀원 간 소통 흐름:

• reconstructor 완료 → investigator에게 타임라인·트리거 후보 전달, assessor에게 장애 기간·지표 전달
• investigator 완료 → planner에게 근본 원인·기여 요인 전달
• assessor 완료 → planner에게 영향 규모·SLA 위반 현황 전달
• planner 완료 → reviewer에게 대책 전문 전달
• reviewer는 모든 산출물을 교차 검증. 🔴 필수 수정 시 해당 에이전트에게 수정 요청 (최대 2회)

Phase 3: 통합 보고서 생성

1. 모든 산출물을 통합한 _workspace/postmortem_report.md를 생성한다
2. 보고서 구조: 요약 → 타임라인 → 근본원인 → 영향 → 대책 → 잘한 점 → 교훈
3. 최종 보고서를 사용자에게 제공한다

작업 규모별 모드

기존 파일 활용: 사용자가 기존 타임라인, 원인 분석서 등을 제공하면, 해당 파일을 _workspace/의 적절한 위치에 복사하고 해당 단계의 에이전트는 건너뛴다.

데이터 전달 프로토콜

에러 핸들링

테스트 시나리오

정상 흐름

프롬프트: "어제 오후 2시에 결제 서비스가 30분간 다운됐어. 배포 직후에 발생했고, 롤백으로 복구했어. 포스트모텀 보고서 만들어줘" 기대 결과:

• 타임라인: 배포→장애 발생→감지→대응→롤백→복구 시간순 정리
• 근본원인: 배포된 코드의 구체적 결함, 카나리 배포 미적용 등 기여 요인
• 영향: 사용자 수, 매출 손실, SLA 영향 추정
• 대책: 카나리 배포 도입, 자동 롤백, 알림 개선 등 SMART 액션 아이템
• 통합 보고서: 경영진 보고 가능한 완성된 포스트모텀

기존 파일 활용 흐름

프롬프트: "이 포스트모텀 보고서 검토해줘" + 보고서 첨부 기대 결과:

• 기존 보고서를 _workspace/에 복사
• 리뷰 모드로 실행
• 정합성, 완전성, 비난 없는 문화 준수 검증
• 개선 제안 제공

에러 흐름

프롬프트: "API 서버가 오늘 아침에 느려졌었어. 원인 분석해줘" 기대 결과:

• 추가 질문으로 장애 세부 정보 수집 (시각, 영향, 조치 등)
• 수집된 정보로 RCA 모드 실행
• 불확실한 부분 명시

에이전트별 확장 스킬