메뉴
PR 리뷰 또는 Self 리뷰를 비즈니스 리뷰와 테크 리뷰 두 단계로 수행합니다. 코드 리뷰, PR 리뷰, self review 시 사용합니다.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
이슈 단위로 스펙, 실행 계획, 수행 요약을 관리하는 워크플로우입니다. 이슈 작업, issue, 이슈 시작, 이슈 완료, 워크플로우 복구(--workflow-only), 이어하기, resume, 작업 재개(--resume), 이슈 정리, 작업공간 정리, 정리(--clear), audit 리포트 검토·피드백 후 승인 보정(--response) 시 사용합니다.
현재 스킬 repo의 skill을 선택하여 Claude Code·Agents·Antigravity·Codex·Junie 경로(~/.claude/skills/ 등 5개)에 설치합니다. --all(전체 경로)·--clear(클린 재설치)·--self(self-install 부트스트랩) 옵션을 지원합니다. skill 설치, install skills, 스킬 배포, 스킬 재설치, self-install 시 사용합니다.
이슈 스펙 대비 구현 완료 여부를 독립 감사인 관점에서 검증합니다. 이슈 감사, issue audit, 구현 검증, 크로스체크 시 사용합니다.
대화 중 중요한 맥락(배경, 결정, 미결 사항, 다음 액션)을 `.ai/99_workspace/notes/` 아래 마크다운 파일로 저장합니다. 맥락 저장, context save, 임시 저장, 논의 스냅샷, 작업 메모 시 사용합니다.
PR 제목과 메시지를 정책(Conventional Commits 제목 + 이슈별 비즈니스/테크 관점)에 맞게 작성합니다. PR 작성, PR 메시지·설명 작성, pull request, 풀리퀘스트, PR 올리기 전 정리, 리뷰어용 설명 정리 시 사용합니다. 실제 PR 생성·제출이 아니라 메시지 텍스트 작성용입니다.
멀티 repo 워크스페이스 루트의 로비 `.ai/AI-CONTEXT.md`를 생성하거나 진단·재구성합니다. `ai-workspace`의 자매 스킬로, building 안내판(=lobby) 역할의 lean 라우터를 만듭니다. 로비, lobby, AI-CONTEXT.md, building 인덱스, 워크스페이스 안내판 작업 시 사용합니다.
| name | git-review |
| description | PR 리뷰 또는 Self 리뷰를 비즈니스 리뷰와 테크 리뷰 두 단계로 수행합니다. 코드 리뷰, PR 리뷰, self review 시 사용합니다. |
PR 리뷰와 Self 리뷰 모두 비즈니스 리뷰와 테크 리뷰 두 단계로 진행합니다.
리뷰 결과는 .ai/99_workspace/temp_review_result.md에 비즈니스 리뷰 섹션과 테크 리뷰 섹션으로 나누어 기록합니다.
.ai/30_contract/, .ai/40_domain/ 경로의 문서를 비즈니스 리뷰에 참조합니다..ai/10_rules/context-loading.md — 있으면 따르며, 이미 적재되어 있으면 재로딩하지 않습니다..ai/30_contract/index.md, .ai/40_domain/index.md — 비즈니스 리뷰 (index 먼저 → 관련 파일만 선택적으로).ai/60_codebase/index.md — 테크 리뷰 호출 흐름 파악.ai/50_adr/index.md — 테크 리뷰에서 관련 ADR 정합성 대조 (index 먼저 → 관련 ADR만 선택적으로)PR 리뷰(타인의 PR을 리뷰)와 Self 리뷰(PR 올리기 전 작성자 본인이 수행) 모두 아래 비즈니스 리뷰 → 테크 리뷰 공통 절차를 따릅니다.
목적: 변경 사항이
.ai/30_contract/및.ai/40_domain/에 기록된 소프트웨어 계약·도메인 지식과 일치하는지 검증하고, 차이가 있는 경우 AI가 이해한 내용을 정리하여 해당 문서에 반영합니다.
아래 순서로 비즈니스 리뷰에 필요한 참조 문서를 확보합니다.
.ai/30_contract/index.md와 .ai/40_domain/index.md를 읽어 각 파일의 내용을 파악합니다.
.md 파일을 직접 지정한 경우 해당 파일도 읽어옵니다.index.md나 관련 문서가 없어 도메인/계약 정보를 참조할 수 없는 경우:
.ai/99_workspace/temp_domain.md — 도메인 관련 내용.ai/99_workspace/temp_contract.md — 소프트웨어 계약 관련 내용.ai/30_contract/ 하위 적절한 위치.ai/40_domain/specs/ 또는 .ai/40_domain/policies/ 하위 적절한 위치temp_domain.md, temp_contract.md를 삭제합니다.확보한 참조 문서를 바탕으로 아래 항목을 검토합니다.
.ai/99_workspace/temp_review_result.md의 비즈니스 리뷰 섹션에 검토 결과를 기록합니다.
.ai/60_codebase/index.md에 내용이 있으면 참고하여 리뷰 대상과 관련된 기능의 호출 흐름을 빠르게 파악한다.
단, SSoT는 소스코드이므로 색인을 신뢰하지 않고 반드시 실제 코드를 확인한다.
리뷰 과정에서 색인과 실제 코드가 다른 부분을 발견하면, 리뷰 결과에 "코드베이스 색인 갱신이 필요해 보입니다 (/code-map)" 의견을 남긴다.
도메인·비즈니스 내용에 해당하는 주요 기능이 올바르게 구현되었는지, 관련 테스트 케이스가 충분한지 검증합니다.
변경 사항이 프로젝트의 아키텍처 방향(.ai/10_rules/architecture.md 참고)에 부합하는지 검증합니다.
추가로 .ai/50_adr/index.md를 참고하여 관련 ADR이 있으면 설계 정합성을 대조합니다.
.ai/99_workspace/temp_review_result.md의 테크 리뷰 섹션에 검토 결과를 기록합니다.