diff --git a/CLAUDE.md b/CLAUDE.md
index 0e7356b29d..24cde443a3 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -181,6 +181,10 @@ ctx, cancel := context.WithTimeout(ctx, 5*time.Minute)
 @.claude/docs/TROUBLESHOOTING.md
 @.claude/docs/DATABASE.md
 
+## Local Configuration
+
+This files may be gitignored, read manually if not auto-loaded.
+
 @AGENTS.local.md
 
 ## Common Pitfalls