코드 설명은 단순하게 유지해 주세요

Context

LLM 기반 자동 생성 메시지의 확산으로 인해 코드 자체로 확인 가능한 'What' 중심의 중복 정보가 급증함. 이로 인한 정보 과부하가 리뷰어의 집중력을 저하시키고 실제 설계 의도인 'Why'를 가리는 병목 지점으로 작용함.

Technical Solution

• Atomic Commit 원칙 준수를 통한 변경 단위의 최소화 및 독립적 이해 가능 구조 설계
• Git Amend 및 Rebase/Squash 활용으로 불필요한 중간 수정 이력을 제거한 깨끗한 히스토리 관리
• LLM 생성 텍스트의 무분별한 복사-붙여넣기를 지양하고 작성자가 직접 맥락을 설계하는 Manual Documentation 지향
• 뉴스 기사형 구조를 차용한 커밋 메시지 설계: 최상단 고밀도 요약 → 중단 상세 변경 이유 → 하단 보조 세부사항 배치
• 코드 내 주석과 커밋 메시지의 역할 분리: 국소적 결정의 맥락은 주석에, 시스템적 변경 동기는 커밋 메시지에 기록하여 Git Archaeology 효율 증대