--- 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 - **검토 이유**: 협업 효율과 소프트웨어 품질을 결정짓는 핵심 공학 프로세스 정립.