diff --git a/README.md b/README.md
index 4c5ba6e..e50e011 100644
--- a/README.md
+++ b/README.md
@@ -78,6 +78,13 @@ Boden/Wetter-Stimmung — siehe Commit 84bc081 und `svmap_io.gd`.)*
   Terrain-Höhen-Abfrage, Platzhalter-Meshes).
   Lauf: `godot --headless --path . --script res://tests/test_ux.gd`
 
+**Bekannte Falle (15.10. live passiert):** Nach `git pull` mit NEUEN
+`class_name`-Skripten (z. B. `action_history.gd`) muss einmal
+`godot --headless --import` laufen, bevor die GUI gestartet wird — sonst ist
+der globale Klassen-Cache (`.godot/`) alt, `main.gd` wirft „Identifier not
+declared" und das Fenster startet ohne UI. Symptom: Parse-Errors im App-Log
+trotz grünem Test-Lauf (der ja selbst mit importiertem Cache lief).
+
 **Bibliothek:** `library/objects.json` ist die Editor-Kopie der offiziellen
 Registry aus dem Match-Server-Repo — neue Objekte DORT registrieren und hier
 synchron ziehen (IDs sind der Vertrag, Entscheidung 20).