Skip to content

Art and animation, written as code. Illustrations, loops, interactive web art, launch-videos and scored films in dozens of styles, identical on every render.

docs: contract names the three pinned exceptions; intake asks 2D/3D and narration; music styles linked from SKILL.md

Alex Greenshpun3675004b4158
diff --git a/skills/anidoodle/SKILL.md b/skills/anidoodle/SKILL.md
index 5e2df2b..971dd34 100644
--- a/skills/anidoodle/SKILL.md
+++ b/skills/anidoodle/SKILL.md
@@ -44,7 +44,7 @@ or in 3D (one medium per film), what **shape** (1x1, 9x16, 16x9, 4x5 or any W x
| A score or soundtrack | `references/music/README.md` |
| Narration, a voice-over, word timing or subtitles | `references/workflows/narration.md` |
-- Music: pick a style vocabulary and mood, sketch the tension arc and motif, compose your own harmony, motif and form (references/music/compose.md, craft in references/music/theory/), revise until node tools/music.mjs craft shows only findings you chose, then check must PASS before a human listens. Styles give sound, never notes.
+- Music: pick a style vocabulary (`references/music/styles/vocabularies.md`; deep dives `references/music/styles/music-box.md`, `references/music/styles/lofi-electronic.md`) and mood, sketch the tension arc and motif, compose your own harmony, motif and form (references/music/compose.md, craft in references/music/theory/), revise until node tools/music.mjs craft shows only findings you chose, then check must PASS before a human listens. Styles give sound, never notes.
- Sound effects: references/music/sound-design.md. 14 layered, seeded effects cued by film frame (filmSfx); the score ducks, and every cue must be within 6 dB of it. Effects only on real direction changes, one riser + one impact per film.
- Launch films: `launchTemplate.ts` renders a product's launch from data (prompts, plates or its own UI, a score composed for it, words, install lines) in every shape from one timeline; `launch.mjs new|ship`. Habits that save tokens: `references/working-method.md`.
diff --git a/skills/anidoodle/references/determinism-and-contract.md b/skills/anidoodle/references/determinism-and-contract.md
index ed0c934..772c646 100644
--- a/skills/anidoodle/references/determinism-and-contract.md
+++ b/skills/anidoodle/references/determinism-and-contract.md
@@ -10,7 +10,10 @@
1. `renderFrame(frame, env)` is PURE. No state carried between frames, no module-level mutable state that touches pixels. Audio is the same: samples are a pure function of the sample rate.
2. Randomness only from `rng(seed)`. Never `Math.random`. Never `Date`, never `performance.now` in the core; timing belongs to hosts.
3. A restricted canvas: paths, fill, stroke, clip, transforms, alpha, composite operations, patterns, gradients, `drawImage`, image data, `fillText` with a preloaded font. **No `ctx.filter` in any form.** No DOM, no `window`, no `new OffscreenCanvas` or `new Image`; surfaces come from `env.canvas()`.
-4. **No assets.** No images, no fonts, no audio files in the repository. Lettering is pen strokes; texture is seeded noise; music is arithmetic. This is what makes the repo the whole film, with no licensing questions. The optional sound pack is the one thing fetched from outside, it is installed by hash, and a film renders without it.
+4. **No assets, with three named exceptions.** No images, no fonts, no audio files in the repository. Lettering is pen strokes; texture is seeded noise; music is arithmetic. This is what makes the repo the whole film, with no licensing questions. The optional sound pack is the one thing fetched from outside, it is installed by hash, and a film renders without it. Three things are carried as data because code cannot make them, each pinned by hash so a build can never change under a film:
+ - **three.js**, vendored at `engine/vendor/three/` (MIT, scanned and hash-pinned, `PROVENANCE.md` there). Films import it as `import * as THREE from "three"` in each file and never re-export the namespace: a re-export keeps three's file loaders, which can fetch, in the player, and the gate fails a player that can reach the network.
+ - **One font for 3D type**, Poppins Bold (SIL OFL 1.1), carried as a base64 module (`engine/assets/fonts/poppinsBold.ts`, provenance in `engine/assets/fonts/PROVENANCE.md`), so no file is read and nothing is fetched at draw time. 2D lettering stays pen strokes.
+ - **Baked narration takes**, the one generated input: only when the person asks for narration, in the voice they chose, each take cached by a hash of what made it and baked into the film as data by `tools/narrate.mjs bake` (`references/workflows/narration.md`). A take made with macOS `say` is a draft and is never committed.
5. Caches are legal only when the value is a pure function of its key, and **the key names everything the pixels depend on**. We found two violations by machine, never by eye: an annotation layer whose key omitted the crank angle two of its leaders pointed at, and one that omitted the pose. A cached frame and a cold frame of the same number must be the same pixels.
6. Never scale a bitmap up. Close shots are re-inked at that view; cached surfaces may only be downscaled, and only a little.
diff --git a/skills/anidoodle/references/workflows/start-here.md b/skills/anidoodle/references/workflows/start-here.md
index b846746..5d524e1 100644
--- a/skills/anidoodle/references/workflows/start-here.md
+++ b/skills/anidoodle/references/workflows/start-here.md
@@ -1,5 +1,7 @@
# Start here: agree the piece with the person, then build
+**Contents:** The intake · When they name a move · Defaults when they do not say · Write it down before you draw · Before the first full render · Alive means real motion
+
anidoodle makes many kinds of thing in many hands. Nothing about a piece is fixed in advance:
not its length, its shape, its style or its sound. So the first job is to find out what this
person wants, quickly, one question at a time, and to fill every gap with a stated default
@@ -14,20 +16,29 @@ pick", pick, say what you picked and why in one line, and carry on.
explainer, an infographic, a launch or product video, an interactive web piece, a drawing
lesson, a character, or a style matched from their image. The table in `SKILL.md` routes each
one to its workflow file.
-2. **Which style?** Show the gallery (https://github.com/alexgreensh/anidoodle/blob/main/skills/anidoodle/assets/styles.jpg, one tile per hand; the list with
+2. **Drawn or 3D?** One medium for the whole film. Recommend one with a reason: 3D for solid
+ things in light (extruded type, products, toys and puppets, a camera moving through space),
+ drawn for anything where the marks are the point. A drawn world with a 3D puppet pasted on read
+ as two films glued together on the last 3D film, so build a hybrid only when they ask for one.
+ 3D goes to `references/workflows/three-d.md`; the style question below is for drawn pieces.
+3. **Which style?** Show the gallery (https://github.com/alexgreensh/anidoodle/blob/main/skills/anidoodle/assets/styles.jpg, one tile per hand; the list with
each hand's medium is `references/styles/INDEX.md`). Recommend two or three hands that suit the
subject and the audience, with one reason each. Offer two other routes:
- **"Match my image"**: they bring a picture and you adapt its hand (`adapt-a-style.md`).
- **"A house style"**: they already picked one before; load it from `styles/house/`.
-3. **What shape and where will it live?** Square `1x1`, vertical `9x16`, wide `16x9`, portrait
+4. **What shape and where will it live?** Square `1x1`, vertical `9x16`, wide `16x9`, portrait
`4x5`, or any W x H they name. One source can ship several shapes (`references/formats.md`).
-4. **How long?** Any length. A three-second sticker, a ninety-second story, a five-minute
+5. **How long?** Any length. A three-second sticker, a ninety-second story, a five-minute
explainer, a twenty-minute lesson. Never cap it and never assume it. Long pieces get chapters
(`long-film.md`).
-5. **Sound?** Silent, or a score: name a music style and a mood per section
- (`references/music/`). Their own voice-over or track is theirs to bring; anidoodle composes
- and plays everything else.
-6. **Characters?** A new one (build it once, `character-consistency.md`), one they already have
+6. **Sound?** Silent, or a score: name a music style and a mood per section
+ (`references/music/`). Their own track is theirs to bring; anidoodle composes and plays everything else.
+7. **Narration?** None, their own recordings, or a generated voice they choose
+ (`references/workflows/narration.md`). Say it plainly when you offer one: macOS `say` is free
+ but for drafts only (Apple licenses its voices for personal, non-commercial use); Kokoro is free,
+ local and licence-clean; a cloud voice (Gemini, OpenAI, ElevenLabs) sends the script's text to
+ that company and costs money per use, so it runs only on their yes and with their own key.
+8. **Characters?** A new one (build it once, `character-consistency.md`), one they already have
in a module, or one from their image (reference, embedded only if they ask).
Stop asking the moment you can build. Two questions answered well beat six asked.
@@ -59,8 +70,8 @@ the reason in one line, record the alternative you will build, and let them veto
## Write it down before you draw
-One short brief file in the project: kind, style (and why), shape(s), length, sound (style +
-moods), characters, the one-sentence idea, and any named moves as name, duration, strength and
+One short brief file in the project: kind, medium (drawn or 3D), style (and why), shape(s), length, sound (style +
+moods), narration (and whose voice), characters, the one-sentence idea, and any named moves as name, duration, strength and
what moves (card defaults marked as such). Everything the person said goes in their words.
Everything you decided is marked as yours so they can veto it in one line.