diff --git a/CLAUDE.md b/CLAUDE.md
index 9ae8714..8b58c88 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -9,7 +9,25 @@
 ### 매 작업 단위 완료 시 반드시 깃 푸시
 - Phase 작업(기능 개발, 리팩터링 등) 완료 → `dotnet build` 확인 → 소스 파일만 스테이징 → 커밋 → 푸시
 - **빌드 오류 없이 커밋** — `경고 0, 오류 0` 상태에서만 푸시
-- 커밋 메시지: `[PhaseXX] 작업 내용 요약 (1~2줄)`
+
+### 커밋 메시지 작성 규칙 (필수)
+- **언어**: 반드시 **한글**로 작성
+- **제목**: `[PhaseXX] 한글 요약 제목` 형식, 50자 이내
+- **본문**: 작업 내용을 **항목별로 자세히** 기술 — 변경된 파일, 줄 수 변화, 주요 메서드/클래스 목록 포함
+- **형식 예시**:
+```
+[Phase 42] ChatWindow.ResponseHandling·LlmService 파셜 분할
+
+ChatWindow.ResponseHandling (1,494줄 → 741줄, 50% 감소):
+- ChatWindow.MessageActions.cs (277줄): 버튼이벤트, 메시지검색, 에러복구
+- ChatWindow.StatusAndUI.cs (498줄): 우클릭, 팁, AX.md, 글로우, 토스트, 하단바
+
+LlmService (1,010줄 → 263줄, 74% 감소):
+- LlmService.Streaming.cs (516줄): 스트리밍 응답, 백엔드별 구현
+- LlmService.Helpers.cs (252줄): 헬퍼, 토큰 파싱, Dispose
+- 빌드: 경고 0, 오류 0
+```
+- **금지**: 영문 단독 커밋 메시지, "fix", "update" 같은 모호한 한 단어 제목
 
 ### 오류 복구 불가 시 이전 버전 롤백
 작업 중 오류가 복구되지 않으면 깃에서 이전 버전을 받아 작업: