diff --git a/CLAUDE.md b/CLAUDE.md
index c34e726..906c53b 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -22,10 +22,19 @@ containers, images, compose files, networks, and system housekeeping.
 
 ```
 1. Claude Code commits and pushes
-2. uv tool install --reinstall git+<repo-url>
-3. Restart Claude Desktop (tray icon → Quit → relaunch)
+2. Fully quit Claude Desktop (tray icon → Quit) so the running MCP server
+   releases its file locks
+3. uv tool install --reinstall git+<repo-url>
+4. Relaunch Claude Desktop
 ```
 
+**Windows lock gotcha — quit BEFORE install:** on Windows the running MCP
+server holds `pywin32` files open, so `uv tool install --reinstall` fails
+mid-swap (`os error 32: used by another process`) and leaves the tool env
+incomplete (the old packages are already uninstalled). The order above
+(quit → install → relaunch) avoids this — never reinstall while Claude Desktop
+is still running.
+
 **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.