diff --git a/AGENTS.md b/AGENTS.md
index 35ac656..04b77fc 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -47,6 +47,10 @@ npx playwright test tests/smoke.mjs --grep @share      # Iterația 3: 6
 - **Demo-urile sunt generate.** `exemplu-*.html` = jocuri exportate din builder, unul per stil.
   **NU le edita manual** — după modificări la motoare, regenerează prin export. `index.html` = doar
   landing care leagă builder-ul + demo-urile.
+- **`play.html` este generat.** Player universal (toate 5 motoare inline, boot din hash). Generat cu
+  `playerHTML()` din builder și commitat în repo pentru GitHub Pages. **Regenerează după orice
+  modificare la motoare:** `node --input-type=module < /tmp/gen-player.mjs` (sau echivalent Playwright)
+  → `git add play.html && git commit && git push github main`.
 - **Stare.** Obiectul `state` (titlu, poveste, culoare, `style`, `puzzles`) se persistă în
   `localStorage` sub cheia `escape-builder-v1`; export/import ca JSON. Editorul scrie via `data-g` →
   `onChange()` → persist + `refreshPreview()` (debounce 400ms) care setează `iframe.srcdoc`.
diff --git a/README.md b/README.md
index 81806d3..fe0a470 100644
--- a/README.md
+++ b/README.md
@@ -19,6 +19,13 @@ URL-ul pointeaza spre player-ul universal hostat pe GitHub Pages:
 Jocul calatoreste comprimat in URL (deflate-raw + base64url); playerul il decodeaza local,
 fara server, fara baza de date. 12+ puzzle-uri incap in ~636 bytes.
 
+> **`play.html` este un fișier generat** — conține toate 5 motoare de joc inline.
+> Dupa modificari la motoare, regenereaza si recommita:
+> ```bash
+> node --input-type=module < /tmp/gen-player.mjs   # sau din builder: playerHTML()
+> git add play.html && git commit -m "regen play.html" && git push github main
+> ```
+
 ## Folosire
 
 Deschide `escape-builder.html` in browser (dublu-click, merge si de pe `file://`).