diff --git a/CLAUDE.md b/.github/CLAUDE.md
similarity index 100%
rename from CLAUDE.md
rename to .github/CLAUDE.md
diff --git a/.gitignore b/.gitignore
index abfdb17..8e190a4 100644
--- a/.gitignore
+++ b/.gitignore
@@ -212,6 +212,10 @@ htdocs/logs/
 src/media/css/colors/light/colors_custom.css
 src/media/css/colors/dark/colors_custom.css
 
+# Ignore user customization files to prevent local development overrides
+src/media/css/user.css
+src/media/js/user.js
+
 # ============================================================
 # Joomla Core
 # ============================================================