diff --git a/.gitignore b/.gitignore
index 67439e8c..addc23cb 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,6 +1,7 @@
 HELP.md
 .gradle
 .envrc
+.omx/
 build/
 !**/src/main/**/build/
 !**/src/test/**/build/
diff --git a/docs/20260406_omxgitignore.md b/docs/20260406_omxgitignore.md
new file mode 100644
index 00000000..1f2a8846
--- /dev/null
+++ b/docs/20260406_omxgitignore.md
@@ -0,0 +1,10 @@
+# `.omx/` Git 제외 처리
+
+- [x] `.gitignore`에 `.omx/`를 추가한다.
+- [x] `git status`와 `git check-ignore`로 제외가 정상 동작하는지 확인한다.
+
+## 검증 기록
+
+- 무엇을: `.gitignore`에 `.omx/`를 추가하고 `.omx/` 하위 파일들이 무시되는지 확인했다.
+- 왜: `.omx/`는 런타임 상태, 로그, 메트릭 파일이라 버전 관리 대상이 아니기 때문이다.
+- 어떻게: `git check-ignore -v .omx/tmux-hook.json .omx/state/hud-state.json .omx/logs/turns-2026-04-06.jsonl`로 무시 규칙을 확인했고, `git status --short`로 `.omx/`가 더 이상 추적 대상이 아니고 문서만 남는지 확인했다.