diff --git a/.pr_agent.toml b/.pr_agent.toml
index d52a66a..0e3ee39 100644
--- a/.pr_agent.toml
+++ b/.pr_agent.toml
@@ -43,5 +43,8 @@ glob = [
     "*.generated.*",
     "public/**",
     "docs/**",
-    "*.md"
+    # NOTE: do NOT add "*.md" here — it would hide best_practices.md and
+    # AGENTS.md from the /review diff view, even though /improve still reads
+    # best_practices.md directly. README-style noise is preferred over
+    # silently dropping changes to the project's authoritative rule files.
 ]