diff --git a/CLAUDE.md b/CLAUDE.md
index 069a2c2..54b7a99 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -611,3 +611,20 @@
 - "@develop-help": "개발실행프롬프트 내용을 터미널에 출력"
 - "@deploy-help": "배포실행프롬프트 내용을 터미널에 출력"
 ```
+
+## Lessons Learned 
+
+### Spring Boot 설정 관리
+- **설정 파일 구조**: `application.yml` + IntelliJ 실행 프로파일(`.run/*.run.xml`)로 관리
+- **금지 사항**: `application-{profile}.yml` 같은 프로파일별 설정 파일 생성 금지
+- **환경 변수 관리**: IntelliJ 실행 프로파일의 `<option name="env">` 섹션에서 관리
+- **application.yml 작성**: 환경 변수 플레이스홀더 사용 (`${DB_HOST:default}` 형식)
+- **실행 방법**:
+  - IntelliJ: 실행 프로파일 선택 후 실행 (환경 변수 자동 적용)
+  - 명령줄: 환경 변수 또는 `--args` 옵션으로 전달 (`--spring.profiles.active` 불필요)
+
+### 개발 워크플로우 
+- **❗ 핵심 원칙**: 코드 수정 → 컴파일 → 사람에게 서버 시작 요청 → 테스트
+- **소스 수정**: Spring Boot는 코드 변경 후 반드시 컴파일 + 재시작 필요
+- **컴파일**: 최상위 루트에서 `./gradlew {service-name}:compileJava` 명령 사용
+- **서버 시작**: AI가 직접 서버를 시작하지 말고 반드시 사람에게 요청할것
\ No newline at end of file