diff --git a/CLAUDE.md b/CLAUDE.md
index eae3af8..317544f 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -10,7 +10,8 @@ IceGlass is a macOS menu bar application that provides NHL game situational awar
 
 ### Build Commands
 ```bash
-# Generate Xcode project (after modifying project.yml)
+# Generate Xcode project (after modifying project.yml).
+# Never hand-edit IceGlass.xcodeproj — it is generated and will be overwritten.
 xcodegen generate
 
 # Build the project