diff --git a/BUILDER_APPS_MIGRATION.md b/BUILDER_APPS_MIGRATION.md
index 98f470c8..2b42a738 100644
--- a/BUILDER_APPS_MIGRATION.md
+++ b/BUILDER_APPS_MIGRATION.md
@@ -193,9 +193,18 @@ CMD ["node", "server.cjs"]
 
 ---
 
-## 4. Docker Compose & Mounts
+## 4. Docker Compose & Mounts (WICHTIGER PITFALL)
 
-Beim Sideloading (Entwicklung ohne Rebuild) müssen **alle** Abhängigkeiten gemountet werden, nicht nur das Hauptskript.
+**WARNUNG: Lokale Dateien überschreiben den Container-Code!**
+
+Wenn Sie `volumes` für das Sideloading verwenden (wie unten gezeigt), werden die Dateien aus Ihrem lokalen Verzeichnis direkt in den Container geladen. Das bedeutet: **Wenn Sie nicht `git pull` auf dem Host-System ausführen, bevor Sie den Container neu bauen, wird der Container weiterhin den alten, lokalen Code ausführen.**
+
+**Workflow:**
+1.  Änderungen im Git-Repository pushen (oder von einem Agent pushen lassen).
+2.  **`git pull` auf dem Host-System ausführen.** (Dieser Schritt ist entscheidend!)
+3.  `docker-compose up -d --build <service-name>` ausführen.
+
+Beim Sideloading müssen **alle** Abhängigkeiten gemountet werden, nicht nur das Hauptskript.
 
 **Wichtig:** Der Pfad zu `server.cjs` ändert sich durch die "Flat Structure" im Dockerfile!