diff --git a/.gitignore b/.gitignore
index 2a8c154..c7a2dac 100644
--- a/.gitignore
+++ b/.gitignore
@@ -35,8 +35,14 @@ Thumbs.db
 .cursor/
 
 # Claude Code
-
+CLAUDE.md
 .claude/
 .playwright-mcp/
 .omc/
 .mcp.json
+
+# Phoenix (런타임/로그/작업이력 — git 불필요)
+phoenix/
+
+# DB dump
+*.pgsql
diff --git a/CLAUDE.md b/CLAUDE.md
index 75c64a7..0292419 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -341,3 +341,31 @@ To add a new screen/feature, follow the existing pattern:
 ## No Automated Tests
 
 There is no test framework configured. Testing is manual via browser.
+
+---
+
+## 메뉴 구조
+
+- 메뉴 트리: [phoenix/menu_tree.md](phoenix/menu_tree.md) (menu_info 테이블 기준)
+- 개발 가이드: [phoenix/dev_guide.md](phoenix/dev_guide.md) (CRUD 패턴, 공통 함수, 체크리스트)
+
+| 대메뉴 | 주요 URL |
+|--------|----------|
+| 영업관리 | 상담, 견적(`estimateList_new`), 주문서(`orderMgmtList`), 판매, 매출 |
+| 프로젝트관리 | WBS관리, 진행관리, 손익산출 |
+| 개발관리 | PART 등록/조회, E-BOM 등록/조회, 설계변경 |
+| 구매관리 | M-BOM, 구매리스트, 견적요청서, 품의서, 발주서, 입고 |
+| 구매요청 | 구매요청서, 품의서 |
+| 자재관리 | 자재리스트, 불출의뢰서, 자금관리 |
+| 생산관리 | M-BOM, 생산계획&실적, 반제품/원자재 소요량 |
+| 품질관리 | 수입검사, 공정검사, 반제품검사 |
+| 고객CS관리 | 고객CS |
+| ECR관리 | ECR |
+
+## 주의사항
+
+- Java 7 프로젝트이므로 람다, 스트림 등 Java 8+ 문법 사용 불가
+- 소스(`src/`)와 컴파일 결과(`WebContent/WEB-INF/classes/`)에 동일한 매퍼 XML이 존재하지만 컴파일하면 자동 동기화되므로 소스만 수정
+- SQL은 MyBatis XML에 직접 작성하며, 어노테이션 기반 매퍼는 사용하지 않음
+- 커밋 메시지는 한국어로 작성 (변경 내용 설명)
+- 다국어 지원: 한국어(ko), 영어(en), 일본어(jp) - `MessageUtils` 사용