diff --git a/.gitignore b/.gitignore
index 6f37804..b9be986 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,29 +1,23 @@
-# 백업 및 임시 파일 (요청하신 부분)
+# ==========================================
+# 1. 공통 무시 설정 (OS, 에디터, 로그, 임시파일)
+# ==========================================
 *.bak
 *.tmp
 *.temp
 *~
 ~*
-
-# OS 자동 생성 시스템 파일
 .DS_Store
 Thumbs.db
 desktop.ini
-
-# 로그 및 런타임 파일
 *.log
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
-
-# 환경 변수 및 비밀번호 (보안 필수)
 .env
 .env.local
 .env.development.local
 .env.test.local
 .env.production.local
-
-# IDE 및 편집기 설정 파일
 .idea/
 .vscode/
 *.suo
@@ -32,35 +26,42 @@ yarn-error.log*
 *.sln
 *.swp
 
-# 1. 먼저 프로젝트 루트의 모든 파일과 폴더를 제외합니다.
+# ==========================================
+# 2. 프로젝트 최상위 화이트리스트 (전체 차단 후 허용)
+# ==========================================
+# 최상위 경로의 모든 파일과 폴더를 우선 제외합니다.
 /*
 
-# 2. 필수 설정 파일들은 예외로 두어 Git 관리 대상에 포함합니다.
+# 최상위 경로에서 추적할 파일만 예외로 허용합니다.
 !.gitignore
 !.env.example
 !docker-compose.yml
 
-# 상위폴더 권한허용
+# web 폴더 내부로 Git이 접근할 수 있도록 허용합니다.
 !/web/
+#/web/*
+
+# ==========================================
+# 3. web 폴더 내부 설정
+# ==========================================
+# 🎯 conf.d 폴더와 그 내부의 파일(.ini 포함) 모두 추적 허용
+!/web/conf.d/
+
+# html 폴더로 접근 허용
 !/web/html/
+
+# html 폴더 안의 모든 것을 기본적으로 무시합니다.
 /web/html/*
 
-# 3. theme 폴더와 그 내부의 모든 것을 포함합니다.
+# 🎯 html 폴더 안에서 실제로 추적할 폴더만 예외 처리
+# (이렇게 폴더 자체를 예외 처리하면 내부의 모든 파일과 하위 폴더가 자동으로 추적됩니다)
 !/web/html/theme/
-/web/html/theme/*
-!/web/html/theme/*/
-/web/html/theme/basic/
-
-# 4. extend 폴더와 그 내부의 모든 것을 포함합니다.
+/web/html/theme/basic
 !/web/html/extend/
-/web/html/extend/*
-!/web/html/extend/*/
 
-!/web/conf.d/
-/web/conf.d/*
-!/web/conf.d/*/
-
-# (선택) 만약 db 폴더나 web/data 등 docker 실행 파일들이 루트에 있다면
-# 위에서 /* 로 이미 제외되었기 때문에 안전하지만, 명시적으로 적어주어도 좋습니다.
+# ==========================================
+# 4. 명시적 제외 구역
+# ==========================================
+# (참고: 상단의 /* 와 /web/html/* 로 이미 무시되었지만 확실히 명시)
 /db/
 /web/html/data/