القائمة
장애·인시던트·반복된 오진의 사후 회고(Postmortem)를 작성한다. 프로덕션 장애, CI 플레이키, 배포 사고, 진단이 여러 번 빗나간 사건 등 "무엇이 어떻게 터졌고 왜 그렇게 진단했는가"를 복기할 때 사용한다.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | postmortem |
| description | 장애·인시던트·반복된 오진의 사후 회고(Postmortem)를 작성한다. 프로덕션 장애, CI 플레이키, 배포 사고, 진단이 여러 번 빗나간 사건 등 "무엇이 어떻게 터졌고 왜 그렇게 진단했는가"를 복기할 때 사용한다. |
| argument-hint | [사건 주제] (예: 게임 통합테스트 플레이키, Redis 구독 영구 중단) |
| allowed-tools | Read, Glob, Write, Bash |
docs/postmortem/에 포스트모템 문서를 작성한다. 형식·index 행 형식은 format.md를 따른다.
ADR과 포스트모템은 장르가 다르다. **ADR은 "앞으로 무엇을 할지"의 결정 기록(미래지향·불변)**이고, **포스트모템은 "무엇이 어떻게 터졌는지"의 복기 기록(과거지향·회고)**이다. 회고에서 새 결정이 도출되면 그 결정은 /adr로 별도 작성하고 양쪽을 상호 링크한다. 진단이 빗나갔거나 결정이 번복된 과정 자체가 포스트모템의 핵심 자산이므로 숨기지 않는다.
docs/postmortem/의 NNNN-*.md 파일명 최대값과 index.md 행 번호 최대값을 둘 다 구해 +1 한다 (번호는 ADR과 독립된 시퀀스, 비어 있으면 0001부터). 두 최대값이 다르면 파일과 인덱스가 어긋난 것이니 멈추고 사용자에게 보고한다.docs/postmortem/NNNN-{kebab-case-title}.md에 작성한다./adr로 ADR을 작성하고, 포스트모템 상단 메타의 관련 ADR에 링크한다.index.md 테이블 맨 끝에 한 줄을 추가한다 (format.md의 행 형식, 번호 오름차순 유지).npx markdownlint-cli2을 실행해 통과시킨다 (Docs CI가 dev PR에서 강제). 규칙·예시는 docs/conventions-docs.md.변경된 파일을 기능 단위로 그룹화하고, 각 그룹의 관련 테스트를 실행한 후 순서대로 커밋한다.
PR 템플릿을 읽어 GitHub Pull Request를 생성한다. 백엔드·프론트엔드 공통.
PR의 CI 실패 테스트를 자동으로 감지하고 수정 사이클을 진행한다. 수정 완료 후 /commit을 호출한다.
Architecture Decision Record를 작성한다. 기술 선택, 설계 결정, 패턴 도입 등 팀이 내린 중요한 기술적 의사결정을 기록할 때 사용한다.
GitHub 이슈를 템플릿 기반으로 생성하고, 이슈 번호로 dev에서 작업 브랜치를 체크아웃한다. 백엔드·프론트엔드 공통.
버그를 재현 테스트 → 수정 → 통과 사이클로 해결한다. 수정 완료 후 /commit을 호출한다.