Antigravity Agent
47 lines
2.5 KiB
Markdown
47 lines
2.5 KiB
Markdown
---
|
|
id: P-REINFORCE-WIKI-DEV-CODE-REVIEW
|
|
title: "코드 리뷰 방법론 (Code Review Methodology)"
|
|
category: Dev
|
|
status: verified
|
|
canonical_id: ""
|
|
aliases: ["코드 리뷰", "PR 리뷰", "Peer Review"]
|
|
duplicate_of: ""
|
|
source_trust_level: A
|
|
confidence_score: 1.0
|
|
tags: ["Code_Review", "Collaboration", "Quality_Assurance", "Software_Engineering", "AI_Review"]
|
|
raw_sources: ["Datacollector_Export_2026-05-02"]
|
|
last_reinforced: 2026-05-02
|
|
github_commit: ""
|
|
---
|
|
|
|
# [[코드 리뷰 방법론 (Code Review Methodology)]]
|
|
|
|
## 1. 개요
|
|
코드 리뷰(Code Review)는 제안된 코드 변경 사항에 대해 협업자들이 검토하고 의견을 나누는 필수적인 개발 프로세스이다. 단순 버그 탐지를 넘어 팀 내 지식 교환, 설계 검증, 코드베이스 품질 유지를 위한 핵심적인 협업 수단이다.
|
|
|
|
## 2. 효과적인 리뷰의 원칙
|
|
- **구체성과 명확성**: 모호한 코멘트 대신 구체적인 이유와 대안 예시를 제시.
|
|
- **차단(Blocking) 여부 명시**: 개인적 선호도와 반드시 수정해야 할 요건을 구분.
|
|
- **긍정적 피드백**: 훌륭한 구현에 대해 찬사(Affirmation)를 보내 인지적 부담 경감.
|
|
- **신속한 의사결정**: 치명적 결함이 없다면 배포 속도(Velocity)를 위해 승인을 지연하지 않음.
|
|
|
|
## 3. 대규모 코드베이스 리뷰 전략
|
|
- **하향식 접근 (High-to-Low)**: 상위 아키텍처부터 세부 로직 순으로 반복 리뷰.
|
|
- **분할 정복**: 논리적 모듈(인증, DB, UI 등) 단위로 나누어 인지 부하 관리.
|
|
- **컨텍스트 활용**: 커밋 이력, 이슈 설명 등을 통해 설계 의도(Why)를 파악.
|
|
|
|
## 4. AI 기반 자동화 및 최신 트렌드
|
|
- **AI 리뷰어 연동**: CodeRabbit, Qodo 등을 통한 보안/모듈성 자동 분석.
|
|
- **MCP 활용**: AI 에이전트가 직접 저장소를 탐색하며 대화형으로 리뷰 수행.
|
|
- **SAST 통합**: 정적 분석 도구를 CI에 통합하여 인간 리뷰어의 단순 작업(포맷팅, 기본 보안 체크 등) 경감.
|
|
|
|
## 5. 지식 연결 (Related)
|
|
- [[AI_Code_Review_Tools]]: 자동화된 리뷰를 돕는 전용 도구들.
|
|
- [[Test_Driven_Development]]: 리뷰 전 코드의 신뢰성을 보장하는 방법론.
|
|
- [[Technical_Debt]]: 리뷰 시 타협된 코드가 관리되어야 할 방향.
|
|
|
|
## 🧪 검증 상태 (Validation)
|
|
- **정보 상태**: 검증 완료 (Verified)
|
|
- **출처 신뢰도**: A
|
|
- **검토 이유**: 협업 효율과 소프트웨어 품질을 결정짓는 핵심 공학 프로세스 정립.
|