diff --git a/CLAUDE.md b/CLAUDE.md
index 4478b7e..8e46814 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -33,3 +33,4 @@ DB 및 외부 서비스 접근 정보는 `.env` 파일 참조:
 ## 작업 시 주의사항
 
 - **문서 업데이트 필수**: 작업이 완료되면 항상 `docs/` 폴더의 관련 문서를 업데이트할 것
+- **활동 로그 필수**: 새로운 관리자 라우트나 봇 기능을 추가할 때 `logActivity` 호출을 포함할 것 (자세한 사용법은 `docs/development.md` 참조)
diff --git a/docs/development.md b/docs/development.md
index 920171b..12d17ac 100644
--- a/docs/development.md
+++ b/docs/development.md
@@ -304,6 +304,9 @@ logActivity(db, {
 });
 ```
 
+### 새 기능 추가 시
+로그는 자동 수집이 아니므로, 새로운 라우트나 기능을 추가할 때 `logActivity` 호출을 직접 넣어야 합니다.
+
 ### 로그 대상
 - **관리자 라우트**: 앨범/일정/멤버/봇/카테고리/사전/콘서트 CRUD
 - **봇 스케줄러**: 동기화 완료(addedCount > 0), 동기화 에러