Menu
장애·인시던트·반복된 오진의 사후 회고(Postmortem)를 작성한다. 프로덕션 장애, CI 플레이키, 배포 사고, 진단이 여러 번 빗나간 사건 등 "무엇이 어떻게 터졌고 왜 그렇게 진단했는가"를 복기할 때 사용한다.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
변경된 파일을 기능 단위로 그룹화하고, 각 그룹의 관련 테스트를 실행한 후 순서대로 커밋한다.
PR 템플릿을 읽어 GitHub Pull Request를 생성한다. 백엔드·프론트엔드 공통.
PR의 CI 실패 테스트를 자동으로 감지하고 수정 사이클을 진행한다. 수정 완료 후 /commit을 호출한다.
Architecture Decision Record를 작성한다. 기술 선택, 설계 결정, 패턴 도입 등 팀이 내린 중요한 기술적 의사결정을 기록할 때 사용한다.
GitHub 이슈를 템플릿 기반으로 생성하고, 이슈 번호로 dev에서 작업 브랜치를 체크아웃한다. 백엔드·프론트엔드 공통.
버그를 재현 테스트 → 수정 → 통과 사이클로 해결한다. 수정 완료 후 /commit을 호출한다.
| 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.