diff --git a/.gitignore b/.gitignore
index fbc0883..addb1c6 100644
--- a/.gitignore
+++ b/.gitignore
@@ -2,11 +2,17 @@
 venv/
 .venv/
 
-# Regenerable from corpus + CI
-corpus/
+# Indexes are regenerated from corpus by `python -m rag.index --rebuild`
+# (run in CI before docker build). Don't commit them.
 chroma/
 bm25/
 
+# corpus/ IS committed — the weekly refresh workflow writes scraped
+# pages here and `git add bundles.json corpus`s them. Same fix HVM hit
+# on its first refresh (PR #1) — template's .gitignore over-ignored
+# corpus/ which silently dropped the add and the workflow always
+# reported "no changes".
+
 # Python detritus
 __pycache__/
 *.py[cod]