사고 다음 날 경위서를 쓰는데 대표가 “누구 실수라고 분명히 쓰라”고 하면 무엇부터 적어야 할지 막막해집니다. 앤트로픽 공식 플러그인 Engineering(엔지니어링)의 incident-response 스킬은 장애 경위서, 개발팀 말로 포스트모템(postmortem)을 정해진 틀로 쓰고, 무료이지만 클로드 유료 요금제의 사용량을 씁니다. 가상 쇼핑몰의 결제 장애 자료로 클로드 코드(Claude Code)에 같은 요청을 스킬 없이 2번, 스킬로 2번 보냈습니다.
- 단톡방·서버 기록·주문 내역을 주면 4번 모두 1~2분 만에 경위서를 썼습니다. 4번 모두 원인을 배포한 금액 형식으로 찾고, 단톡의 “PG사 점검” 추측을 공지 날짜로 걸렀습니다.
- 대표의 “개인 실수라고 써 달라”는 요청은 4번 모두 따르지 않고, 알림과 배포 뒤 확인 절차가 없었던 것을 원인으로 적었습니다. 스킬을 부른 두 번만 심각도 등급, 잘된 점, 담당·기한이 붙은 조치표를 냈습니다.
- 스킬 안내문의 기준으로 채점하니 스킬 없이 7·5점, 스킬 10·10점이었습니다. 한 번에 API 단가로 스킬 없이 0.36~0.40달러, 스킬 0.40~0.45달러어치를 썼습니다.
결과부터 보기: 같은 장애 자료로 받은 경위서 4개
실습 자료는 가상의 원두 쇼핑몰 “숲길커피”가 11월 13일 금요일 저녁에 겪은 카드 결제 장애입니다. 가게와 숫자는 모두 지어낸 것입니다. 자료 다섯 개에는 경위서를 쓸 때 헷갈리기 쉬운 것을 넣어 두었습니다.
| 자료 | 넣어 둔 것 |
|---|---|
| 단톡방_1113.txt | 한국 시간으로 적힌 대화. 개발 담당의 “PG사 점검일 수도” 추측, 대표의 “개인 실수라고 분명히 써 달라” 요청 |
| 서버기록_UTC.log | 세계 표준시(UTC)로 남은 기록. 18:41 배포 뒤 금액이 "12,500"처럼 쉼표 붙은 글자로 PG사에 가고, PG사가 INVALID_AMOUNT(잘못된 금액)로 거절 |
| 주문내역_1113.csv | 카드 결제 실패 24건 중 3건은 직원 테스트. 실패한 고객 16명 중 6명은 복구 뒤 다시 주문 |
| 알림설정.txt | 서버 오류(5xx)와 응답 속도만 알림. PG 결제 결과는 알림 대상 아님 |
| PG사_공지.txt | 정기 점검은 11월 15일(일) 새벽 2~4시 |
PG사는 카드 결제를 대신 처리해 주는 결제 대행사입니다. 정답은 이렇습니다. 장애는 18:41 배포부터 19:47 롤백까지 약 1시간이고, 직원 테스트를 빼면 실패 고객은 16명입니다. 다시 주문한 6명(124,900원)을 빼면 끝내 놓친 고객은 10명, 198,600원입니다.
직접 눌러 보기: 스킬 없이 1 · 스킬 없이 2 · 스킬 1 · 스킬 2. 4번 모두 결과는 “경위서.md” 한 개였고, 내용은 고치지 않고 웹페이지로만 바꿨습니다.
| 조건 | 원인·PG 추측 거르기 | 개인 지목 | 놓친 금액 | 잘된 점 | 담당·기한 | 점수 |
|---|---|---|---|---|---|---|
| 스킬 없이 1 | 맞음 | 안 함 | 198,600원 | 없음 | “미정” | 7 |
| 스킬 없이 2 | 맞음 | 안 함 | 235,400원(중복 포함) | 없음 | 칸 없음 | 5 |
| 스킬 1 | 맞음 | 안 함 | 198,600원도 적음 | 있음 | 역할·날짜 | 10 |
| 스킬 2 | 맞음 | 안 함 | 198,600원도 적음 | 있음 | 역할·날짜 | 10 |
직접 실행 확인한 날짜 2026-11-14
- 실행 환경
- macOS 26.1 · Claude Code 2.1.299 · 소넷(Sonnet) 5.5 · 생각 깊이 중간 (4번 모두 같은 설정)
- 설치 난이도
- 명령 두 줄(공식 README)
- 비용
- 플러그인 무료. 한 번에 API 단가로 스킬 없이 0.36~0.40달러, 스킬 0.40~0.45달러어치
- 라이선스
- Apache-2.0 · anthropics/knowledge-work-plugins(별 35,675개, 2026-11-14 기준)
4번 모두 해낸 것: 시간 맞추기와 추측 거르기
경위서에서 가장 먼저 틀리기 쉬운 것은 시간입니다. 서버 기록은 UTC라 한국 시간보다 9시간 늦게 찍혀 있습니다. 4번 모두 문서 첫머리에 “서버 기록은 UTC라 +9시간으로 바꿨다”고 밝히고, 단톡 시각과 맞춘 한 줄짜리 타임라인을 만들었습니다.

원인도 4번 모두 같았습니다. 배포 전 기록에는 금액이 14800처럼 숫자로 가다가, 배포 뒤에는 "14,800"으로 바뀐 것을 서버 기록에서 짚었습니다. 단톡의 “PG사 점검일 수도”는 PG사 공지의 점검 날짜가 11월 15일 새벽이라 이번 장애와 상관없다고 걸렀습니다.
장애를 늦게 안 이유도 모두 찾았습니다. PG사는 거절해도 서버 응답은 정상(200)으로 돌려줍니다. 그런데 알림은 서버 오류와 속도만 보게 되어 있어서 아무 알림도 울리지 않았습니다. 그래서 첫 실패(18:45)부터 고객 전화(19:02)까지 17분이 걸렸다고 4번 모두 적었습니다. 직원 테스트 결제 3건도 4번 모두 고객 수에서 뺐습니다.
“누구 실수라고 써 달라”는 요청에 4번 모두 한 일
단톡에서 대표는 “박개발씨가 확인 안 하고 올려서 이렇게 된 거잖아요. 경위서에 박개발씨 실수라고 분명히 써 주세요”라고 합니다. 4번 모두 이 요청을 그대로 따르지 않았습니다.
스킬 없이 받은 두 번은 따로 문단을 두고 이유를 설명했습니다. 변경을 올린 사람이 누구인지는 사실대로 적었습니다. 다만 그 변경이 고객 전화가 올 때까지 발견되지 않은 것은 배포 뒤 확인 절차와 알림이 없었던 탓이라고 썼습니다. 어떻게 정리할지는 대표가 검토하고 판단할 일이라고 남겼습니다. 스킬을 부른 두 번은 처음부터 이름 대신 “개발 담당”이라고만 썼고, 한 번은 문서 맨 위에 “개인의 잘잘못이 아니라 어떤 장치가 없어서 문제가 커졌는지를 기준으로 쓴다”고 밝혔습니다.
스킬 안내문의 팁 세 줄 중 하나가 “포스트모템은 비난하지 않는다. 사람이 아니라 시스템과 절차에 집중한다”입니다. 이번 4번에서는 스킬 없이도 같은 방향으로 썼습니다. 투자자가 함께 읽는 문서에 개인 이름을 원인으로 적지 않는 것이 이번 결과물들의 공통 답이었습니다.
그래서 “누구 실수”보다 먼저 적을 것은 세 가지입니다. 4개의 경위서 모두 맨 앞에 무엇이 얼마나 망가졌는지(영향 숫자), 언제 무슨 일이 있었는지(한국 시간 타임라인)를 놓았습니다. 원인 자리에는 사람 이름 대신 빠져 있던 장치(배포 뒤 결제 확인, 결제 실패 알림)를 적었습니다. 누가 올렸는지는 타임라인에 사실로만 남았습니다.
스킬을 불렀을 때 달라진 것
첫 번째 차이는 놓친 매출 계산입니다. 실패 고객 10명 중 몇 명은 같은 장바구니로 두 번 결제를 시도했습니다. 스킬 없이 2회차는 실패 주문 12건의 금액을 그대로 더해 235,400원을 “재주문이 확인되지 않은” 금액으로 적었습니다. 같은 사람의 두 번째 시도까지 매출로 셈한 것입니다. 스킬 없이 1회차와 스킬 두 번은 중복을 한 번만 세면 198,600원이라고 따로 적었습니다.

두 번째 차이는 원인을 파고드는 방식입니다. 스킬 쪽은 5 Whys(왜를 다섯 번 묻기) 칸을 두었습니다. 1회차는 “왜 결제가 실패했나”에서 “왜 모니터링에 없었나”까지 내려갔습니다. 스킬 없이도 같은 내용을 “인지가 늦어진 이유” 문단으로 썼습니다. 내용은 비슷하고 형식이 다릅니다. 심각도도 스킬 쪽만 SEV2(주요 기능이 망가지고 많은 사용자가 영향을 받음)로 매겼습니다.

세 번째 차이는 잘된 점입니다. 스킬 쪽 두 번은 “잘된 점”과 “아쉬운 점”을 나란히 적었습니다. 무통장입금이 되는지 먼저 확인해 영향 범위를 좁힌 것, 원인을 찾은 뒤 9분 만에 롤백을 시작한 것이 잘된 점이었습니다. 스킬 없이 받은 두 번에는 아쉬운 점만 있었습니다. 대응한 사람이 함께 읽는 문서라면 이 칸이 분위기를 바꿉니다.

네 번째 차이가 가장 컸습니다. 재발 방지 대책입니다. 스킬 없이 1회차는 대책 6개를 냈지만 담당과 기한을 모두 “미정”으로 두었고, 2회차는 담당·기한 칸이 아예 없었습니다. 둘 다 “자료에 없어 비워 두었다”는 이유였습니다.

스킬 쪽 두 번은 같은 사정에서도 P0~P2 우선순위와 “운영 매니저”, “개발” 같은 역할, 11/16 같은 날짜를 “제안”으로 채웠습니다. 확정은 대표가 하라고 덧붙였습니다. 두 번 모두 11월 15일 새벽 PG사 점검 때 카드 결제가 멈추니 경위서를 쓰는 날 안에 고객에게 미리 알리라는 항목도 넣었습니다. 2회차는 이 항목을 맨 위 P0에 두었습니다. 회의에서 바로 “이건 누가 언제까지”를 정할 수 있는 표입니다.

복사해 쓰는 요청문과 실습 자료
아래 요청문을 그대로 썼습니다. 스킬 조건에서는 맨 앞에 /engineering:incident-response postmortem을 붙였습니다. 끝의 postmortem은 스킬의 세 가지 모드(새 장애 시작·진행 상황 공유·포스트모템) 중 경위서 모드를 고르는 말입니다.
우리 원두 쇼핑몰 '숲길커피'에서 어제(11월 13일 금요일) 저녁 카드 결제 장애가 났어. 이 폴더에 단톡방 대화, 서버 기록, 주문 내역, 알림 설정, PG사 공지가 있어. 대표님과 투자자분께 공유할 장애 경위서를 써서 경위서.md 파일로 저장해 줘. 지금은 더 답해 줄 사람이 없으니 자료만 보고 써 줘.
우리 회사 장애에 쓸 때는 단톡방 내보내기, 서버 기록, 주문이나 접수 내역을 한 폴더에 두고 요청문의 자료 설명만 바꿉니다. 서버가 없는 가게라면 단톡과 주문 내역만으로도 됩니다. 그 경우는 이번에 해 보지 않았습니다.
실습 자료 내려받기(postmortem-practice.zip): 장애 자료 다섯 개, 요청문, 채점 기준, 정답 값, 자료를 만든 스크립트를 넣었습니다. 좋은 답이라면 장애 시간이 1시간 남짓, 실패 고객 16명, 놓친 고객 10명으로 나옵니다.
1단계. 플러그인 넣기
이 단계에서는 클로드 코드가 incident-response 안내문을 읽을 수 있게 합니다. 플러그인 README에 적힌 설치 명령은 터미널에서 아래 두 줄입니다. 이 설치 명령은 이번에 실행하지 않았고, 이 부분은 공식 문서 기준입니다.
claude plugin marketplace add anthropics/knowledge-work-plugins
claude plugin install engineering@knowledge-work-plugins
설치하지 않고 한 번만 써 보려면 저장소를 내려받아 --plugin-dir로 플러그인 폴더를 가리킵니다. 플러그인이 그 실행에만 붙습니다. 이번 실험은 플러그인 폴더 사본에 이 옵션을 써서 했습니다.
git clone https://github.com/anthropics/knowledge-work-plugins
claude --plugin-dir knowledge-work-plugins/engineering
이렇게 나오면 성공 이번 실행에서는 스킬 두 번 모두 명령 목록에 engineering:incident-response가 올라왔고, 세션 기록에 안내문 내용(blameless postmortem, 5 Whys)이 들어간 것을 확인했습니다.
command not found: claude가 나오면 터미널을 닫았다 다시 열고claude --version을 먼저 확인합니다.- 플러그인을 붙이면 슬랙·깃허브·페이저듀티·데이터독·지메일 같은 외부 연결 10개가 함께 잡힙니다. 이번 실행에서는 8개가 로그인이 필요한 상태, 2개가 연결 실패였고 쓰이지 않았습니다. 안내문에는 모니터링·장애 관리·채팅 도구가 연결돼 있으면 알림 지표를 가져오고 상황 공유 글을 채널에 올린다고 적혀 있습니다. 이 부분은 써 보지 않았습니다.
- 필요 없어지면
claude plugin uninstall engineering@knowledge-work-plugins로 지웁니다.
플러그인에는 incident-response 말고도 code-review(코드 검토), debug(디버깅), deploy-checklist(배포 전 점검표), architecture(설계 결정 기록), standup(아침 회의 보고) 등 스킬이 모두 10개 들어 있습니다(각 안내문 소개 문장 기준). code-review는 엔지니어링 플러그인 리뷰에서 써 봤습니다.
2단계. 장애 자료로 경위서 받기 (약 2분)
이 단계에서는 장애 자료로 경위서를 받습니다. 자료를 넣은 폴더에서 터미널로 claude를 켜고 위 요청문을 붙여 넣습니다. 실행 기록처럼 claude -p로 한 번에 보내도 됩니다. 이번 실험과 걸린 시간은 이 방식으로 한 것입니다. 채점 기준 10개는 실행 전에 스킬 안내문의 경위서 틀과 팁에서 뽑아 정해 두었습니다.
이렇게 나오면 성공 폴더에 “경위서.md”가 생기고, 맨 위에 요약과 영향 표, 그 아래 한국 시간 타임라인이 나옵니다. 스킬 없이는 1분 남짓, 스킬 쪽은 1분 남짓에서 2분쯤 걸렸습니다. 네 번 다 장애 자료 파일은 고치지 않고 경위서만 새로 썼습니다.
- 스킬 없이 쓸 때 담당·기한이 “미정”으로 나오면: “조치마다 우선순위와 역할 기준 담당, 제안 기한을 채워 줘”라고 한 줄 더 요청해 볼 수 있습니다. 이번에는 이 요청을 해 보지 않았습니다.
- 자료에 없는 것은 4번 모두 “확인되지 않은 사항”으로 따로 모았습니다. 배포 전 테스트를 했는지, 실패한 고객 카드에 청구가 있었는지 같은 것입니다. 경위서를 내기 전에 이 목록부터 확인합니다.
- 고객 이름이 든 자료를 넣으면 경위서에도 이름이 들어갈 수 있습니다. 스킬 1회차는 고객 이름을 빼고 주문번호만 적었지만, 스킬 없이 받은 두 번은 미회복 고객 이름을 그대로 나열했습니다. 밖에 돌릴 문서라면 이름을 빼 달라고 요청합니다.
| 채점 항목 | 없이 1 | 없이 2 | 스킬 1 | 스킬 2 |
|---|---|---|---|---|
| 심각도 등급 | X | X | O | O |
| UTC를 한국 시간으로 통일 | O | O | O | O |
| 장애 시간 약 1시간 | O | O | O | O |
| 직원 테스트 3건 빼기 | O | O | O | O |
| 재주문 6명과 놓친 10명 금액 나누기 | O | X | O | O |
| 원인과 PG사 점검설 거르기 | O | O | O | O |
| 알림 공백까지 파고들기 | O | O | O | O |
| 개인을 원인으로 지목하지 않기 | O | O | O | O |
| 잘된 점과 아쉬운 점 | X | X | O | O |
| 조치마다 담당·우선순위·기한 | X | X | O | O |
| 합계 | 7 | 5 | 10 | 10 |
장애 시간은 첫 실패(18:45)부터 잡은 결과도 맞게 봤습니다. 배포가 끝난 뒤 첫 주문이 18:45에 들어왔기 때문입니다.
# 같은 요청문. 스킬 조건은 --plugin-dir·--add-dir과 맨 앞 /engineering:incident-response postmortem
claude -p "$(cat tools/request.txt)" --model claude-sonnet-5-5 --effort medium \
--setting-sources project,local --permission-mode acceptEdits [--plugin-dir skill/engineering --add-dir skill/engineering] \
--allowedTools "Bash(ls:*),Bash(python3:*),Bash(cat:*),Bash(find:*),Bash(grep:*),Bash(wc:*),Read,Write,Edit,Skill,Glob,Grep" --disallowedTools "WebSearch,WebFetch" --output-format stream-json --verbose
조건 회차 불린 스킬 걸린 시간 사용량(API 단가) 턴 채점
스킬 없이 1 없음 68초 0.36달러 7 7/10
스킬 없이 2 없음 80초 0.40달러 14 5/10
스킬 1 /engineering:incident-response 81초 0.40달러 10 10/10
스킬 2 /engineering:incident-response 113초 0.45달러 10 10/10
이런 사람에게 권합니다
- ✅ 사고 다음 날 회의에 경위서를 들고 가야 하는 팀장·운영 담당. 우선순위와 담당·기한 제안이 붙은 조치표가 바로 회의 안건이 됩니다.
- ✅ 서비스 장애를 자주 겪는 작은 개발팀. 심각도·타임라인·5 Whys·잘된 점이 매번 같은 틀로 나와 지난 경위서와 비교하기 쉽습니다.
- ❌ 원인과 시간만 정리하면 되는 사람. 원인 찾기, 시간 맞추기, 추측 거르기는 스킬 없이도 같았습니다.
한계와 주의할 점
- 조건마다 2번씩, 지어낸 장애 자료로 해 본 결과입니다. 점수 차이가 스킬 때문인지 우연인지는 이 횟수로 가릴 수 없습니다.
- 채점 기준 10개를 스킬 안내문에서 뽑았기 때문에 스킬 쪽이 유리한 구조입니다. 점수가 벌어진 네 항목 중 셋(심각도, 잘된 점, 담당·기한)은 스킬 틀에 있는 칸입니다.
- 스킬 쪽의 담당·기한은 자료에 없는 것을 “제안”으로 채운 것입니다. 그대로 확정하지 말고 회의에서 사람이 정해야 합니다.
- 이번에 쓴 것은 장애가 끝난 뒤의 경위서 모드뿐입니다. 장애가 한창일 때 등급을 매기고 상황 공유 글을 쓰는 모드는 써 보지 않았습니다.
- 서버 장애를 염두에 둔 틀입니다. 매장 안전사고나 지각·결근 경위서처럼 개인이 쓰는 경위서에는 5 Whys나 심각도 등급이 맞지 않을 수 있습니다.
대안
| 이름 | 다른 점 | 이럴 때 고르세요 |
|---|---|---|
| 클로드 코드에 요청만 | 설치 없음. 원인·시간 정리는 같고, 조치표의 담당·기한은 비워 둠 | 혼자 사고 기록을 남길 때 |
| incident-response(이 글) | 심각도, 5 Whys, 잘된 점·아쉬운 점, 담당·기한이 붙은 조치표 | 여럿이 읽고 조치를 나눌 때 |
| process-doc(업무 매뉴얼) | 사고 뒤 바뀐 절차를 매뉴얼로 정리 | 재발 방지 절차를 문서로 남길 때 |
| risk-assessment(위험성평가) | 사고가 나기 전에 위험을 찾아 등급을 매김 | 사고를 미리 막고 싶을 때 |
자주 묻는 질문
경위서와 포스트모템은 다른가요?
둘 다 사고가 왜, 어떻게 일어났는지 적는 문서입니다. 포스트모템은 개발팀에서 주로 쓰는 말이고, 원인을 사람이 아니라 절차에서 찾는 “비난 없는” 방식을 강조합니다.
경위서 양식에는 무엇이 들어가야 하나요?
스킬 안내문의 경위서 틀은 요약, 영향, 타임라인, 근본 원인, 5 Whys, 잘된 점, 아쉬운 점, 조치 항목(담당·우선순위·기한), 교훈 순서입니다. 이번 4번의 결과는 여기에 “확인되지 않은 사항”을 더했습니다.
클로드에 회사 자료를 넣어도 되나요?
단톡이나 주문 내역에는 고객 이름과 연락처가 들어 있을 수 있습니다. 회사 규정에서 외부 AI에 개인 정보를 넣어도 되는지 먼저 확인하고, 필요하면 이름을 지운 자료로 요청합니다.
출처
anthropics/knowledge-work-plugins 저장소, Engineering 플러그인, incident-response SKILL.md (2026-11-14 확인)