diff --git a/CLAUDE.md b/CLAUDE.md
index 50a7a28..8e41081 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -26,6 +26,11 @@ containers, images, compose files, networks, and system housekeeping.
 3. Restart Claude Desktop (tray icon → Quit → relaunch)
 ```
 
+**Push retry:** the Gitea remote (`gitea.gecheckt.de`) occasionally
+returns `Unauthorized` on the first push attempt. If `git push` fails
+with an auth error, wait 1 s and retry once before reporting back.
+Only a second consecutive failure is treated as a real auth problem.
+
 ---
 
 ## Implemented tools (23)
@@ -72,6 +77,11 @@ containers, images, compose files, networks, and system housekeeping.
 - Type hints and docstrings everywhere
 - Formatter: `ruff format` · Linter: `ruff check` · Tests: `pytest`
 - All text (docstrings, comments, README): English
+- **Version consistency:** the package version lives in `pyproject.toml`
+  and must stay in sync with `uv.lock` and the `[X.Y.Z]` heading in
+  `CHANGELOG.md`. `src/mcp_synology_container/__init__.py` derives
+  `__version__` from `importlib.metadata` and is never hand-edited.
+  Every version bump touches all three files in the same commit.
 
 ---