diff --git a/book/300_architecture/311_FastAPI_구조_원칙.md b/book/300_architecture/311_FastAPI_구조_원칙.md
index 8cb5478..76369ee 100644
--- a/book/300_architecture/311_FastAPI_구조_원칙.md
+++ b/book/300_architecture/311_FastAPI_구조_원칙.md
@@ -258,6 +258,11 @@ utils
 - ❌ `docker-compose.yml`의 `environment:` 섹션에 하드코딩된 값
 - ❌ 코드에 API 키, 토큰, 비밀번호 등 민감 정보를 기본값/백업 값으로 직접 하드코딩
 
+**마이그레이션 시 주의사항**:
+- **DB 마이그레이션 시 .env 정리 필수**: 환경변수 기반 설정을 DB로 옮긴 후, `.env`에서 관련 변수 주석 처리 또는 삭제 필요 (마이그레이션 스크립트 실행 후 누락 방지)
+- **환경변수 사용 여부는 코드에서 확인**: `config.py`에 정의되어 있어도 실제 사용 여부는 `grep` 등으로 코드 검색하여 확인 필요 (불필요한 변수 유지 방지)
+- **동적 관리가 필요한 설정은 DB 사용**: 스케줄러처럼 런타임 변경이 필요한 설정은 DB로 관리하는 것이 적절함 (환경변수 재시작 필요 문제 해결)
+
 ## 13. LLM 우선 접근 원칙
 
 **핵심 원칙**: LLM을 기본으로 사용하고, 하드코딩된 규칙(heuristic)은 최소화