diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..bee25d4
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,10 @@
+# Project Guidelines
+
+## Version Management
+
+Any change to the repository content (code, configuration, documentation) should update the integration version in `custom_components/immich_album_watcher/manifest.json`.
+
+Use semantic versioning:
+- **MAJOR** (x.0.0): Breaking changes
+- **MINOR** (0.x.0): New features, backward compatible
+- **PATCH** (0.0.x): Bug fixes, documentation updates