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.
Reference scope
Load only when routed by SKILL.md. The core profile, scale, construction-first and evidence rules take precedence over legacy calibration counts, numerical examples or workflow order here. Subject-specific examples are recipes, not universal requirements. Paths beginning templates/, verify/ or media/ are relative to the skill root.
Changelog
5.2.0 — Pose-aware clearance. Adds actor/animal/building space reservation, seat frames/occupancy and action-path checks to both profiles. Ships sphere/capsule/OBB nearby-pair sampled audits with exact time-window contact rules and independent proxy inventory, plus live CPU skin/morph pose bounds. Regressions cover limbs/tails, seats/backrests, buildings, temporal crossings and missing/invalid coverage. Proxy/sample limits remain explicit; full guide, model-first sourcing and narrative no-education-UI preserved.
5.1.0 — Model-first by default. Requires finding, acquiring and using fitting commercially modifiable/redistributable internet assets for major roles, not merely logging a search. Retains Polyfork-first narrative sourcing and educational accuracy gates; verifies actual import/style/motion and final-scene inclusion. Free-first; paid assets require approval. Hand-building is a justified gap/fallback, not the default. Preserves the full long guide and narrative no-education-UI boundary.
5.0.0 — Long-form restoration. Restores the complete 3.18 guide and detailed design sheet after compact-profile educational UI leaked into ordinary scenes. Narrative by default; no educational card/dock/lessons/callouts without explicit explanatory intent. Keeps Polyfork sourcing, commercial/adaptation/redistribution checks, actual-subject representation and tested construction helpers. Profile-consumer tests are bounded evidence, not a rendered amusement-park benchmark.
4.6.0 — Actual named subject is the educational default, not a substitute tabletop teaching aid. Explicit real-subject/teaching-model/explanatory modes, ambiguity-only clarification, representation metadata and preservation on repair. Keeps style, scene/object presentation and Inside separate; natural subjects do not acquire invented stands/slabs/mechanical rigs. Semantic decision fixtures and instruction consistency are bounded checks, not a completed scene benchmark. Commercial asset sourcing and Polyfork narrative rules retained.
4.5.0 — Educational builds may use a verified external named object or subsystem, not only context. Adds a bounded three-candidate discovery/accuracy/import wrapper and recorded-evidence policy gate: free commercial adaptation and scene redistribution required, offline bundling/dependencies checked, CC0/CC-BY auto-accepted only with reviewed source evidence and appropriate notices. NC/ND/editorial/unknown permissions fail closed; SA/custom/public-domain/other permissive terms require compatibility review, not false relabelling. Separates rights from teaching/exterior/context readiness; preserves the user's narrative Polyfork sweep. Does not assert automated legal/scientific verification or a real-asset import benchmark.
4.4.0 — Narrative scenes now source the world instead of inventing it: the Polyfork catalogue is swept across every noun before modelling, with a recorded per-noun decision (
sweep.md), one full metadata enumeration, four query shapes per noun, kit adoption for places,matchingfan-out, and correct reading ofcoverage(none/poorversusfiltered_out). Educational builds keep the opposite rule — the named object is authored; borrowed geometry stays context. Hand-modelling is now the answer for what the sweep proves absent, or what must be selected, moved or explained.4.3.0 — Adds one routed reference for borrowing context models from the free Polyfork CDN (
external-models.md): ~2,800 low-poly assets, anonymous hotlink, real metres, origin at y=0, +Z front, flat-shaded vertex colours on one material, GLB or ES module. Covers discovery via/api/assetsand kit co-location, import-map andpreserveDrawingBuffertraps, palette retinting under the pixel and toon presets, one recorded uniform scale factor, and merging only unselectable dressing. The named teaching object is still authored, never borrowed. No new audit requirement; entry stays under 14 KB.4.2.0 — Generalizes the verified carousel mount repair into reserved local working volumes, shared support→fixture contact stacks and all-instance within-assembly checks. Adds a compact dependency-injected interface helper for actual-geometry bounds, bounded box seating, conservative keep-outs, exact scope membership, live local anchors and projected clipping. Its regression suite includes real failing geometry mutations; source integration checks the repaired eight-station carousel and parent relocation. Keeps the entry below 14 KB and the design sheet below 2 KB; adds no mandatory all-pairs solver or screenshot quota. Full-model quality/token savings remain unbenchmarked on the requested weak model.
4.1.0 — Performance/quality correction after the user-run rotary-filler evaluation. Small construction-first milestones, coherent reference-grounded ground/floor/interior/material realism, separate physical/selection registries, reuse of executable base/endpoints/real-hole/perspective-fit constructors, early hero/reverse/phone checks, one parameterized QA runner, two-failed-fix design-reset trigger and unchanged production-validator mutations. All-pairs nested AABB audits become optional, not a count-optimization loop. Source audit found actual misplaced repeated details, bearing gap, incompatible gear pitches, invalid narrow predicates and missing-evidence adjudication. Executable helper and saved-artifact framing tests are bounded evidence; the revised full scene has not been rerun on the requested weak model, and no token/runtime savings are claimed as measured.
4.0.0 (staged; not installed) — Split the 231,721-byte 3.18 monolith into a routed entry and 38 mapped specialist sections; compact design sheet, rigid scene-contract helper, local-anchor/ownership guidance. Fresh-agent planning and helper tests passed, but the user-run full rotary build exposed excessive audit ceremony and poor visual results. Preserved as a staged backup, not counted as a successful scene benchmark.
3.18.0 — Consolidates educational UI/selection/lesson rules into one V8-exact authority with crossrefs; resolves placement, focus, preset-intro, ghost-shell and reciprocal scale contradictions. Three quartz-watch evidence/test contracts: all repeated mating interfaces from shared anchors/axes with real holes and noncoplanar ends; assembly/piece inspection with class-safe reversible state; non-vacuous actual-geometry QA and fresh build identity. Ships rigid inspection and shared-interface helpers with class/ownership/empty-fixture failures and a three-preset rendered contrast/depth/restoration regression; preserves context and authorizes internal occluder removal explicitly. These tests are bounded helper evidence, not full mechanism/UI certification. Missing straps/back remain the existing 3.17 completeness gates, not new rules. Full 3.17.0 preserved as
SKILL.md.bak-v3.17.0.3.17.0 — Three whole-object completeness gates prompted by the user-reported quartz watch missing straps and back: whole silhouette/scope, exterior/rear attachment construction, and a reconciled completeness matrix with proof and negative checks. Extends the Detail Bar and design template across profiles/presets; preserves prior UI, mechanics and style contracts. Per-scene checks remain required; no model certification is claimed.
3.16.0 — Code-defined V8 educational UI contract and copy-in
education-v8.css: exact neutral tokens, reserved 360px right column/mobile dock, DOM/control hierarchy and measured regression gates. Records grandfather-clock beige/glass/detached-title drift; supersedes ambiguous default-placement wording without changing render presets or mechanics.3.15.0 — LEAP-1B repair checklist: retained preset provenance, closed exterior/explicit Inside/reset lifecycle, UI-safe complete-assembly fit with correct camera-axis sign, and reference-first white compact educational UI. Adds design fields and scoped white-stage CSS. Tests remain per-scene; geometry sampling does not imply full collision certification. v3.14.1 preserved as backup.
3.14.1 — Documents the calibrated V8 soft-glow/holographic inspection implementation: isolated material variants, ghost-shell depth policy, selective live-transform feature edges, multi-material restoration, ownership/disposal, and rigid-versus-deformed limitations. Adds matching design/QA acceptance fields; no renderer preset or scene behaviour changed. v3.14.0 preserved as
SKILL.md.bak-v3.14.0.3.14.0 — Three evidence-backed regression rules: mating interfaces/local axes/shared anchors with bore/bevel/axial budgets and connected ports/supports; full-assembly swept-clearance coverage with surface-scoped intended-contact policy and explicit sampled-proof limits; compact neutral sans educational UI with progressive causal steps bound to frozen scene state. Adds dependency-free mechanism-contract and education-dock templates, scalar/contact-policy and browser helper regressions, design/QA sheets. V8 rod repair and the incomplete earlier 12/12 report are the evidence, not a guarantee of future bug-free construction. v3.13.0 preserved as
SKILL.md.bak-v3.13.0.3.13.0 — Mandatory
Render Preset Gate: the agent asks once, at project start, which of the three looks to build in (pixel default, stroked-toon, pixel + stroke hybrid), instead of asking only once it had already decided to try the optional look. An explicit style in the request counts as the answer; naming a look in a reference, or the word "toon" on its own, does not; silence resolves to pixel and is recorded as a delegated default. The grey blockout and the research lookups continue while the answer is pending and only the presentation pass waits. Updates the frontmatter description, the intro,One Prompt, One Build,Step 0, both preset sections, the pipeline andtemplates/DESIGN.md. v3.12.0 preserved asSKILL.md.bak-v3.12.0.3.12.0 — Motion graphics hardened by a full-cycle, frame-by-frame audit of the four-stroke engine: effects are derived from the moving free volume instead of a spline that pierced the valve; the direction-dependent cone extent is fitted rather than only the centre; anchors, length normalization, single-row chevrons and flame-coupled fade are specified; ignition flash is capped; and every Y constant is declared in one local space. Adds the 720° vertex containment sweep, the adjacent-degree no-teleport bound and the 15°-step contact-sheet gate, plus nine new recorded failure modes. v3.11.0 preserved as backup.
3.11.0 — Motion-graphics primitives recorded as first-class geometry: forward-axis/tip convention tests, no arrows inside opaque bodies and no depth-test x-ray, minimum legible effect scale, free-volume sizing with a sign check, compact ignition kernels, one-idea arrows, un-outlined FX, phase-bound deterministic lifetimes, connected hollow outlets, real bores through crossed flanges, and reversible selection glow/dim/focus. Adds the ten recorded failure modes from the four-stroke engine. v3.10.0 preserved as backup.
3.10.0 — Mandatory user orbit for every preset with deterministic hero reset, no auto-spin; first-class educational mechanism profile, single accessible dock and one live part explanation; component manifest and ratio/kinematic/contact acceptance; optional confirmed low-resolution pixel+stroke helper with one selective outline pipeline. v3.9.0 preserved exclusively as backup.
3.9.0 — Optional subject-independent
stroked-toonillustrated-miniature preset, calibrated from the coffee-rig repairs: explicit ask-and-wait gate, native antialiasing, four-step toon ramp, selective warm ink outlines, bevelled assemblies, sound cavity/contact construction and related prop clusters. Pixel remains the default. Documents overrides to conflicting pixel-only camera/post/empty-paper rules, addstemplates/stroked-toon.jsand design-sheet consent/preset fields. Checks: material/ramp tests, module bundle, unrelated- subject spec review; renderer appearance still needs per-project visual QA.3.8.0 —
qa/frames.mjs: a per-entity frame recorder. Samples one dense series per entity across a window, isolates it (branch, siblings or full scene), fits one camera to its swept bounds so travel stays visible, and scores every entity:energy(flat means frozen),step(NDC jump means teleport),emptyframes,OFFSCREEN, withSTATIC=for actors meant to hold still. Each entity gets a contact sheet plus a row inreport.json, and the script exits non-zero on any flag. NewPer-entity frame recordingsection in Verification. NewLong builds and contextsection: compaction is lossy, so state lives inDESIGN.md,SOURCES.md,CREDITS.md,report.jsonand the beat table, and a post-compact agent re-runs the harness instead of trusting its summary.3.7.0 — Research-first release, from the Pikachu vs Charizard battle diorama. New
Research Before You Modelsection: step the source footage into contact sheets and write the motion grammar down before modelling, prefer game footage over fan cuts, and check free commercial-use libraries (Poly Pizza, Sketchfab CC0/CC-BY, Quaternius, Kenney, user-supplied AI meshes) before hand-modelling a creature;CREDITS.md+ licence gate +fitModelpipeline + forward-axis probing; shots-as-acceptance-test. NewField Notes: Two-Creature Combatsection: stage-local aiming with a numeric facing sweep, bone-space effect anchors, upright billboard basis, explosion vocabulary (no cones/bars/ scaffolding, per-layer scaling, one continuous stream), latching effect anchors to the impact point, send-out vs recall grammar (throw → arc → open → burst → full-size exit → ball returns; red beam only on recall), and severity-scaled hit reactions about the blow axis. Project layout gainsrefs/andCREDITS.md.3.6.0 — Renamed to Diorama throughout: the playbook, templates and QA docs now call the artifact a diorama. No code behaviour changed.
3.5.1 — Camera-scale rule made explicit:
subjectScaleis a post-fit multiplier (0.70= 30% smaller linearly), whilefillX/fillYstay a fit margin. The camera template now exposesfitDistanceandsubjectScale;qa/audit.mjsnow provesdistance ≈ fitDistance / subjectScalewhen those two fields are exposed, andpost.size ≈ CSS × renderScalewhen the post exposes it. Added the Dust Kings calibration (fit 67.93 → actual 97.05, projected slab 872 → 611 px) and a rule against shrinking the geometry or canvas frame to create margin.PixelPostgains arenderScaleargument; Dust Kings renders at 1.25× (buffer 1640 × 950 on a 1312 × 760 CSS canvas) so the smaller diorama keeps its edge detail without changing page size. The resolution section now separates buffer from layout and warns about the frame-rate cost.3.5.0 — Surface/Motion/Event-FX correction release from a truck-diorama postmortem: finish heightfield/slab edges flush (no lip or portal), keep every exiting mover visible until its world bounds clear the slab, never fade a solid hero with material opacity, gate exhaust/steam/dust by authored event windows with the emitter at the physical nozzle, and replace flat untextured halo quads with radial-alpha sprites. New
qa/audit.mjschecks flat glows, whole-group fades, early hides, teleports, idle/orphan emitters and paper-margin leaks;shoot,portrait,sweepandstripnow fail with a nonzero exit code; QA README documents the optional audit contract. New DESIGN audit sheet;detail.jsgainshaloPlane/softDiscTextureso a soft light card is the default.3.4.0 — The fragile code is now shipped, not described:
poses.js,transfer.js(climb, stand spots, facing),track.jsand astage.jsskeleton with a worked actor chain;qa/as runnable scripts (shoot, portrait, strip, probe, sweep) instead of a checklist; Numbers split into invariants and calibrated values. Water, wake and splash re-verified inverify/water/, which found two real defects: the splash usedMath.random(now seeded) and neither effect could be frozen (both now exposereset(); the harness re-simulates from zero and a two-frame diff fell from 334 to 18 pixels).build.mjswrites a favicon stub so the 404 stops polluting the console gate.3.3.0 — Social/life-scene release from the Night Market build: clothed-cast craft (skull/jaw head, hairline, layered garments, hands), carry/handoff and crate-loading rules, scooter/cargo-bike anatomy, two-wheeler mount with hip-Z abduction, service/queue state machine with
movinggates, Night Market worked example and fix table, 2x backing/scale-by-camera guidance, empty-paper rule, social verification logs, night/practical/headlight guidance, cutaway and glazing rules, bus/van anatomy, cat/dog quadruped rig and gait, generalisedDESIGN.mdwith Life/Service and Contact/Choreography sheets, newpeopleModel-street.jstemplate, scene fast path, and a laundromat/workshop router row.3.2.3 — Hollow-object rule: cannon bores, pipe mouths, chimney flues, lamp chimneys and tunnels need open collars, a recessed dark bore, a back disc and a lip ring. Added 1:1 bore audit and the brass-end-cap pitfall; the Bombard cannon now has an open muzzle instead of a cap.
3.2.2 — Fixed cannon ammo station rebuilt as a wall-mounted locker below the deck: shelf, brackets, powder chest, shot tray and hung rammer, outside both yaw sweep and barrel arc. Added bounding-box overlap check to the pivot audit and recorded the wall-locker pattern.
3.2.1 — Rotating-assembly parentage rule: only the gun may live under yaw; fixed deck stores go on a static group. Added pivot-parentage strip and acceptance check; cannon keg, shot and rammer moved off the yaw group.
3.2.0 — One-prompt commission mode: default commission table, assumption line, ten-scene router, universal four-question generator, bakery worked example, autonomous eight-pass build, cut-count-not-detail rule and one-prompt acceptance; reading order trimmed to the sections needed.
3.1.0 — Canonical numbers/camera/light/post/palette contract; field and machine grammar; goal-response vocabulary; FX edge, snap and contact-context rules; crew/defender rule; human death grammar; climb and rotating-emitter rules; expanded
DESIGN.md; newdetail.jsrope, trophy-board and contact-shadow helpers.3.0.0 — Detail Bar, Animation Bar, new-subject intake, reference density, detail recipes, system/combat animation, attack/death audits, beam/artifact triage, detail-and-animation QA,
templates/DESIGN.md,templates/detail.js,templates/combat.js.2.1.0 — Combat Readability section; threshold clearing, tower grammar, boss goal contact, death species, standalone
String.replaceguard.2.0.0 — Palette/post contract, camera solve, cast rig, vehicle/seat transfers, clipping, verification.