菜单
Architecture Decision Record를 작성한다. 기술 선택, 설계 결정, 패턴 도입 등 팀이 내린 중요한 기술적 의사결정을 기록할 때 사용한다.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
변경된 파일을 기능 단위로 그룹화하고, 각 그룹의 관련 테스트를 실행한 후 순서대로 커밋한다.
장애·인시던트·반복된 오진의 사후 회고(Postmortem)를 작성한다. 프로덕션 장애, CI 플레이키, 배포 사고, 진단이 여러 번 빗나간 사건 등 "무엇이 어떻게 터졌고 왜 그렇게 진단했는가"를 복기할 때 사용한다.
PR 템플릿을 읽어 GitHub Pull Request를 생성한다. 백엔드·프론트엔드 공통.
PR의 CI 실패 테스트를 자동으로 감지하고 수정 사이클을 진행한다. 수정 완료 후 /commit을 호출한다.
GitHub 이슈를 템플릿 기반으로 생성하고, 이슈 번호로 dev에서 작업 브랜치를 체크아웃한다. 백엔드·프론트엔드 공통.
버그를 재현 테스트 → 수정 → 통과 사이클로 해결한다. 수정 완료 후 /commit을 호출한다.
| name | adr |
| description | Architecture Decision Record를 작성한다. 기술 선택, 설계 결정, 패턴 도입 등 팀이 내린 중요한 기술적 의사결정을 기록할 때 사용한다. |
| argument-hint | [결정 주제] (예: Redis Stream 도입, Notifier 패턴 적용) |
| allowed-tools | Read, Glob, Write, Bash |
영역별 docs/adr/(백엔드 backend/docs/adr/, 프론트 frontend/docs/adr/)에 ADR 문서를 작성하고 같은 디렉터리의 index.md에 한 줄을 추가한다. 형식·상태 값·index 행 형식은 format.md를 따른다. BE/FE 모두 동일한 NNNN+index+markdownlint 형식을 쓴다(backend 정책 기준).
ADR_DIR을 정한다: 백엔드면 backend/docs/adr/, 프론트면 frontend/docs/adr/. 모호하면 사용자에게 묻는다. frontend/docs/adr/index.md가 없으면 format.md의 헤더로 새로 만든다. (ADR 저장소를 루트 단일로 통합하려면 별도 마이그레이션이 필요하다 — 현재는 영역별 분리·형식 통일.)$ADR_DIR의 NNNN-*.md 파일명 최대값과 index.md 행 번호 최대값을 둘 다 구해 +1 한다. 두 최대값이 다르면 파일과 인덱스가 어긋난 것이니 임의로 진행하지 말고 멈춰서 사용자에게 보고한다 (과거 0023→0025 재번호 사고 이력). 번호는 영역별로 독립 시퀀스다.$ADR_DIR/NNNN-{kebab-case-title}.md를 작성한다. 상태 값은 작성 시점에 맞게 고른다.$ADR_DIR/index.md 테이블 맨 끝에 행을 추가한다 (format.md의 행 형식, 번호 오름차순 유지).npx markdownlint-cli2를 실행해 통과시킨다 (로컬 best-effort, Docs CI가 dev PR에서 강제). 백엔드 규칙·예시는 backend/docs/conventions-docs.md.