diff --git a/troubleshooting/20251002_file_size_refactoring_plan.md b/troubleshooting/20251002_file_size_refactoring_plan.md
new file mode 100644
index 0000000..e56f45b
--- /dev/null
+++ b/troubleshooting/20251002_file_size_refactoring_plan.md
@@ -0,0 +1,22 @@
+# 파일 크기 제한 위반 리팩토링 (완료)
+
+**작성일**: 2025-10-02 15:45
+**완료일**: 2025-10-02 16:00
+**커밋**: 46643f7
+
+## 작업 완료
+
+### llm_service.py: 343줄 → 254줄
+- models.py: Pydantic 모델 분리 (44줄)
+- special_handler.py: 특수 명령어 처리 (68줄)
+- 주석 해제: line 134-138 (감정 DB 저장 활성화)
+
+### router.py: 557줄 → 384줄
+- message_router.py: 라우팅 헬퍼 (113줄)
+- conversation_repository.py: 대화 저장 state 이동 (124줄)
+- 계층 위반 해소: DB 직접 접근 → state 위임
+
+## 결과
+- 감정 DB 저장 활성화
+- 계층 원칙 준수
+- 파일 크기 개선 (router.py 300줄 초과 잔여)