Anidoodle

anidoodle

Pictures, films and interactive pieces drawn entirely in code. One pure function paints every frame; another composes the score and plays it. The same source rebuilds the same pixels and the same sound on any machine, at any size, at any length. Eight acoustic instruments can play recordings of real ones from an optional download. ASK the user before any score work; never download unasked.

The engine is the easy half. Work gets thrown away because it had no point, because the subject was an icon of itself, because a style was only a palette swap, because the music had no form, or because the person spent their patience approving fragments. This skill carries the craft that prevents each of those.

Start by asking, then build

Read references/workflows/start-here.md and run its intake: one question at a time, only what the request leaves open, your recommendation first. What are they making, in which style (show the gallery sheet, https://github.com/alexgreensh/anidoodle/blob/main/skills/anidoodle/assets/styles.jpg; the list is references/styles/INDEX.md), what shape (1x1, 9x16, 16x9, 4x5 or any W x H), how long (any length; never cap it), what sound (silent or a music style and mood), which characters. "You pick" means pick and say why in one line. Write the answers into a short brief before drawing.

What are you making?

• 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.
• 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.

The seven laws

1. Every piece has a point. A still: one idea, one focal subject, one light. A film: one transformation, one payoff, one token that returns. → references/storytelling.md
2. State the realism. Name the anatomy, the view and the reference you opened, for animals, objects and people alike. → references/realism-and-craft.md, references/anatomy.md
3. A style is a way of making marks. Change the medium, the edge and the order of the marks, beyond the palette. → references/styles.md
4. Prove the look on ONE still, then build end to end. After that, gates cost more than they save. → references/working-method.md
5. The contract is absolute. Pure in (frame, env) (and the input log, for interactive pieces), rng(seed) only, no clock, no ctx.filter. Nothing generated; images they bring may be embedded by hash, and the sound pack is a separate, hash-pinned download. → references/determinism-and-contract.md
6. Music gets a plan, never an adjective. A style, a mood per section, the notes as data, then measurements. You cannot hear it, so one human listens before it ships. → references/music/
7. One directs, one builds, both write everything down. When a session degrades, reset; the files are the memory. → references/working-method.md

Workflows

Still. (1) Say the idea in one sentence; name the focal subject and the light. (2) Open real reference for anything that exists, and note which. (3) Pick the style and read its plate's header first. (4) Draw in that medium's order. (5) Render with still.mjs at full size, run the detail pass on crops (faces, hands, feet, joins; references/craft-bar.md), critique in writing. ✋ One approval. (6) Deliver every size and shape asked for from the same source, and say reproducible was printed.

Loop. As a still, plus: every motion is periodic over the loop, the subject never stops, something moves every second. Check the seam (last frame against frame 0). ✋ One approval, on the moving file.

Film. (1) The story in three sentences (setup, transformation, payoff) and the token; for longer films, a spine plus one line per chapter. If you cannot write it, stop. (2) The grid: a beat is 60 x fps / bpm frames, the bpm from the brief's score; one cue table holds every frame number and a checker runs at load. (3) Real reference for anything that exists. (4) ONE look still, the hardest frame, critiqued in writing. ✋ Approval. (5) ONE 8-second music sample. ✋ Approval. (6) Build the whole film; mechanical checks run continuously. (7) Review once from the rendered file, as four readings with a scorecard (references/workflows/review.md). One ranked fix list, one rebuild. (8) ✋ Final approval. Say what you verified and what you cannot.

Three approval gates at most. Approval is a budget; spend it where being wrong is expensive.