코드 분석 전 Git 명령어로 1시간의 탐색 시간을 5분으로 단축하는 전략

Context

낯선 코드베이스 분석 시 소스 코드부터 읽는 방식의 비효율성 발생. 코드의 현재 상태만으로는 설계 결정 이유와 맥락 파악 불가. 히스토리 없는 분석으로 인한 인지 부하 증가.

Technical Solution

• git shortlog 기반의 기여도 분석으로 현재 프로젝트의 핵심 메인테이너와 도메인 전문가 식별
• git log와 sort | uniq -c 조합을 활용해 변경 빈도가 높은 Hot File을 추출하고 분석 우선순위 결정
• --shortstat 옵션으로 대규모 파일 수정 내역을 추적하여 아키텍처 변경 및 리팩토링 시점 파악
• --follow 플래그를 적용한 개별 파일 추적으로 파일명 변경과 관계없는 일관된 변경 이력 확보
• grep 키워드 필터링으로 'fix', 'revert' 커밋을 분석하여 시스템의 취약 지점 및 과거 장애 이력 파악
• 커밋 메시지와 변경 사항의 상관관계 분석을 통해 문서화되지 않은 설계 의도 역추적

Key Takeaway

효율적인 코드 분석의 핵심은 빠른 읽기가 아니라 무엇을 먼저 읽을지 결정하는 우선순위 선정 역량. Git 히스토리를 정적인 코드에 시간축을 더한 내러티브로 활용하는 접근 방식의 중요성.