git-review-context

개요

사람(PR 리뷰어 또는 작성자 본인)이 리뷰할 때 병목을 줄이고 생산성을 높이기 위해, AI가 변경 사항을 사전 분석하여 리뷰에 필요한 핵심 정보를 .ai/99_workspace/temp_review_context.md에 정리합니다.

관련 skill

• git-review (권장): 컨텍스트 빌드 후 이어서 리뷰를 진행할 수 있습니다.
• ai-workspace (권장): .ai/99_workspace/ 경로에 결과를 기록합니다. 구조가 없으면 필요한 디렉토리를 직접 생성합니다.

참조 문서

• 공통 규칙: .ai/10_rules/context-loading.md — 있으면 따르며, 이미 적재되어 있으면 재로딩하지 않습니다.
• 스킬 고유 추가 참조:
  • .ai/60_codebase/index.md — 호출 흐름 파악
  • .ai/30_contract/index.md, .ai/40_domain/index.md — 리뷰 포인트 도출 (계약·정책 영향 확인)
  • .ai/10_rules/writing-principles.md·.ai/10_rules/writing-principles-local.md — 있으면 산출물 작성 원칙으로 참조 (충돌 시 local 우선; 없으면 본문의 "산출물 접기 기준"이 기본값)

---

실행 조건

사용자가 명시적으로 요청한 경우에만 실행합니다. 다른 skill(git-review 등)이 자동으로 호출하지 않습니다.

---

분석 절차

1단계: 변경 사항 수집

git diff 또는 PR 정보를 통해 변경된 파일 목록과 diff를 수집합니다.

• 변경된 파일 수, 추가/삭제 라인 수를 파악합니다.
• 파일을 기능 단위(도메인, 레이어, 모듈 등)로 그룹화합니다.

2단계: 변경 요약 작성

각 파일 그룹을 기준으로 변경 내용을 한눈에 파악할 수 있도록 요약합니다.

• 무엇이 추가·수정·삭제되었는지 서술합니다.
• 변경 의도(왜 변경했는가)를 코드와 커밋 메시지를 통해 추정합니다.

3단계: 코드베이스 색인 참조

.ai/60_codebase/index.md에 내용이 있으면 참고하여 변경 사항과 관련된 기능의 엔트리포인트와 호출 흐름을 빠르게 파악한다. 단, SSoT는 소스코드이므로 색인을 신뢰하지 않고 반드시 실제 코드를 확인한다. 분석 과정에서 색인과 실제 코드가 다른 부분을 발견하면, 결과 기록에 "코드베이스 색인 갱신이 필요해 보입니다 (/code-map)" 의견을 남긴다.

4단계: 기능별 엔트리 포인트 식별

변경 사항에서 외부에서 진입 가능한 엔트리 포인트를 기능 단위로 정리합니다.

엔트리 포인트 유형 예시:

• API 엔드포인트 (REST, GraphQL 등)
• 이벤트 핸들러 / 메시지 컨슈머
• CLI 커맨드
• UI 컴포넌트 / 페이지
• 공개 함수·클래스·모듈

5단계: 호출 흐름 분석

3단계에서 식별한 각 엔트리 포인트를 기준으로 코드 흐름을 추적합니다.

• 엔트리 포인트 → 핵심 로직 → 외부 의존성(DB, 외부 API 등) 순서로 흐름을 정리합니다.
• 변경된 파일이 흐름의 어느 지점에 위치하는지 명시합니다.
• 흐름이 복잡한 경우 의사코드 또는 단계별 목록 형태로 표현합니다.
• 호출 흐름은 디렉토리 트리 형태의 ASCII 다이어그램으로 시각화하여 가시성을 높입니다.
  • 각 노드에 클래스명과 메서드명을 명시합니다(예: ClassName#methodName).
  • 들여쓰기와 트리 기호(├──, └──)로 호출 계층을 표현합니다.
  • 핵심 로직은 노드 옆에 # 설명 주석 형태로 간략히 기재합니다.

호출 흐름 ASCII 다이어그램 예시:

OrderController#createOrder
├── OrderService#placeOrder          # 주문 생성 트랜잭션 관리
│   ├── InventoryService#reserve     # 재고 차감 및 락 획득
│   │   └── InventoryRepository#decreaseStock (DB)
│   └── PaymentService#charge        # 결제 요청 및 실패 시 재고 롤백
│       └── PaymentGatewayClient#requestPayment (외부 API)
└── OrderEventPublisher#publish      # 주문 완료 이벤트 발행