القائمة
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.