diff --git a/README.md b/README.md
index 8f5fbbb..7965200 100644
--- a/README.md
+++ b/README.md
@@ -36,6 +36,20 @@ xcodegen generate
 open Flixy.xcodeproj
 ```
 
+> **Wichtig: Xcode vorher beenden.**
+>
+> `xcodegen generate` schreibt `project.pbxproj` neu. Ein geöffnetes Xcode
+> liest das nicht nach — es hält seinen eigenen Stand im Speicher und
+> überschreibt die frisch erzeugte Datei beim nächsten Sichern wieder. Neue
+> Dateien fehlen dann im Build, ohne dass irgendwo ein Fehler auftaucht.
+>
+> Das ist der Preis dafür, die Projektdatei aus Git herauszuhalten. Immer wenn
+> Dateien dazukommen oder `project.yml` sich ändert: Xcode mit ⌘Q beenden,
+> `xcodegen generate`, neu öffnen.
+>
+> Ob der Build aktuell ist, steht in der App unter **Einstellungen →
+> Diagnose** als Build-Datum.
+
 Der Code liegt zum größten Teil in lokalen Packages unter `Packages/FlixyKit`.
 Das App-Target enthält nur Oberfläche und Navigation.