Skip to content

Playbook and Three.js code kit for detailed dioramas: classic pixel art, stroked toon or pixel + stroke; two intake gates for look and model sourcing; free orbit, palette snap and ink; animated toy-scale cast; per-entity frame QA.

README: install prompt directly under the scene notes

sloemo6cd17dbc5dfa
diff --git a/README.md b/README.md
index 1b4ce3f..f003b0e 100644
--- a/README.md
+++ b/README.md
@@ -59,22 +59,6 @@ climbs the bank steps and the windows go red behind them, the sedan pulls away,
cruisers arrive and officers fan out across the street, then the street empties
again.
-## What is in here
-
-| Path | What it is |
-| --- | --- |
-| `SKILL.md` | The whole playbook: research gate, look contract, detail and animation bars, pipeline, recipes, QA, pitfalls. Start here. |
-| `templates/` | Copy-in modules: palette, post pass, camera, lighting, geometry, props, rig, poses, vehicle transfer, paths, combat, creature, water, effects, build script. |
-| `templates/DESIGN.md` | The design sheet you fill before modelling. |
-| `templates/SOURCES.md` | The research log you fill before modelling: query, what was found, decision. |
-| `templates/CREDITS.md` | The licence ledger for every imported model, clip or texture. |
-| `templates/creature.js` | Rigged-actor combat: stage-local aiming, bone-space effect anchors, upright billboards, hit severities, send-out geometry. |
-| `templates/qa/` | Eight verification scripts that check a build against frozen frames and printed numbers, including a per-entity frame recorder. |
-| `verify/water/` | A worked scene that exercises the water modules, with the screenshots the QA loop produced. |
-| `verify/climb/` | A unit test for the vehicle transfer maths. |
-| `verify/creature-battle/` | What a two-actor fight build proved: aiming, effect anchoring, send-out and hit numbers. |
-| `media/` | The preview GIFs and source captures shown above. |
-
## Install it
Paste this into an agent that can run shell commands. It asks where to put the
@@ -131,6 +115,22 @@ Needs `git`, or `curl` and `tar` for the fallback. The QA scripts need Node with
`three`, `esbuild` and `playwright-core`. The `media/` previews are about 20 MB
and can be deleted after the clone.
+## What is in here
+
+| Path | What it is |
+| --- | --- |
+| `SKILL.md` | The whole playbook: research gate, look contract, detail and animation bars, pipeline, recipes, QA, pitfalls. Start here. |
+| `templates/` | Copy-in modules: palette, post pass, camera, lighting, geometry, props, rig, poses, vehicle transfer, paths, combat, creature, water, effects, build script. |
+| `templates/DESIGN.md` | The design sheet you fill before modelling. |
+| `templates/SOURCES.md` | The research log you fill before modelling: query, what was found, decision. |
+| `templates/CREDITS.md` | The licence ledger for every imported model, clip or texture. |
+| `templates/creature.js` | Rigged-actor combat: stage-local aiming, bone-space effect anchors, upright billboards, hit severities, send-out geometry. |
+| `templates/qa/` | Eight verification scripts that check a build against frozen frames and printed numbers, including a per-entity frame recorder. |
+| `verify/water/` | A worked scene that exercises the water modules, with the screenshots the QA loop produced. |
+| `verify/climb/` | A unit test for the vehicle transfer maths. |
+| `verify/creature-battle/` | What a two-actor fight build proved: aiming, effect anchoring, send-out and hit numbers. |
+| `media/` | The preview GIFs and source captures shown above. |
+
## Start a diorama
1. Read `SKILL.md`: `Research Before You Model`, `One Prompt, One Build`, `The Look