Add packed stack blocks and chain timer loss

README.md

@@ -38,3 +38,9 @@ Physilinks is a browser-based physics linking game built with Matter.js. Match a
 - No build step. Open `index.html` directly in the browser.
 - Key files: `index.html` (layout), `styles.css` (styling), `src/ui.js` (DOM/HUD), `src/main.js` (physics/game logic), `src/scenes/index.js` (scene registration).
 - Adjust or add scenes by extending the files in `src/scenes/` with config and a `createBodies(width, height)` function.
+
+## Adding a new scene
+- Create `src/scenes/scene-<your-id>.js` based on `src/scenes/scene-template.js` or an existing scene, and keep the `id` aligned to the filename suffix.
+- Add the script tag to `index.html` with the other scene files so it loads in the browser.
+- Register the scene id in `src/scenes/index.js` (append to `desiredOrder` or rely on the unordered fallback).
+- If the scene uses new DOM ids/classes or storage keys, document them in your commit notes per the repo guidelines.