@funpixel/tools 0.1.0 → 0.1.1

package/plugins/robin/claude/skills/art/references/pipeline.md

@@ -2,7 +2,7 @@
 
 When a game makes more than a handful of assets from text, the games that shipped best kept them
 as data: what each piece is, one style file, and a record of what made each file. Four of our
-games (The Last Good Robot, The Hot Gates and two more) arrived at the same shape on their own.
+games arrived at the same shape on their own.
 `funtools assets` is that shape, on the shelf. Use all of it, part of it, or none: hand-made,
 procedural and one-off `gen` assets need no manifest, and nothing checks for one.
 
@@ -78,7 +78,7 @@ changed subject; `gen --only <name>` tries the same words again.
 
 ## At scale: the asset script
 
-Our own games carry 70 to 250 assets (Gallery Heist: 116 paintings, 183 sounds, 11 music cues, 25
+Our own games carry 70 to 250 assets (one heist game: 116 paintings, 183 sounds, 11 music cues, 25
 models). Nobody calls a tool 200 times by hand. The plan's `## Asset script` is the list, one row
 per family with a count, and it becomes the manifest:
 

package/plugins/robin/claude/skills/art/references/prompts.md

@@ -119,7 +119,7 @@ Taste goes to the `critic` agent, which grades craft within the declared style.
 
 ## Target frames at moments, and the loop that closes the gap
 
-Held Note (a three.js horror game, 29 Sep 2026) made its target frames for moments of the GDD's
+A three.js horror game (29 Sep 2026) made its target frames for moments of the GDD's
 moment ladder (0:10 the moon pool, 1:00 the first enemy, 2:00 the dodge, 3:00 the splice, 5:00 the
 seam), so each capture has one picture it should match. The loop that closed its look gap:
 
@@ -134,13 +134,13 @@ floor fixed it), a camera inside lockers the hero could walk into (collision), a
 inside a door. The owner's note that started the second art pass was the same comparison: "what
 we imagined was better; we must get close to it".
 
-A capture only counts if it shows the moment. Held Note's third panel scored 4.9 because every
+A capture only counts if it shows the moment. That game's third panel scored 4.9 because every
 view silently sat at t = 0 behind the opening shot after a refactor; looking at the captures before
 reading the score found it.
 
 ## Judging generated art in the game's own light
 
-A generator's preview is lit for the generator. Under the game's light Held Note's generated
+A generator's preview is lit for the generator. Under its own light that game's generated
 textures read near-black, so the enemy's albedo was lifted ×1.9 to read in the dark; a few metres
 into the torch's spot it then went pure white with no face. Albedo above 1 has nowhere to go under
 a strong light. The lift went back to 1.05 and a cold rim light did the reading-in-the-dark job
@@ -153,7 +153,7 @@ When something white appears that should not, suspect a light first and hide one
 
 ## A rubric for a 3D cast, written before generating
 
-Held Note wrote ten lines before its first 3D model, each tied to an AD rule or a target frame, and
+The horror game wrote ten lines before its first 3D model, each tied to an AD rule or a target frame, and
 turned every model on a turntable against them. Three show the shape: "light is the palette:
 surfaces desaturated, the only saturated hues amber (station), cyan (hero, safe tech), coral
 (enemies)"; "reads at phone size: at about 120 px tall the silhouette alone says what it is";

package/plugins/robin/claude/skills/art/references/ui.md

@@ -5,17 +5,17 @@ in the game's world, played on a real phone and judged every round with the same
 characters and the levels, never a layer added at the end. The controls count too: the gesture
 on the play, how it feels and how it answers, is part of the look.
 
-The owner played our games on an iPhone (30 Sep 2026) and named the same fault in each. Fold
-Room's warm sandstone rooms wore a HUD of dark app pills with cyan outlines and system type, and
-its title was a white bold wordmark over the scene with a cyan pill and three icon circles. Floe's
-frosty board sat under the same pills and stock glyphs ("better icons, not emojis"). Saltwake had
-heavy navy slabs; Plush Pop's title stacked panels over its basket; Lantern Night's title floated a
-small dark board in an empty sky. Riad Rush looked better only because its creator happened to
-carve its HUD from the riad's wood. The cause was ours: the look's direction covered the world,
+The owner played our games on an iPhone (30 Sep 2026) and named the same fault in each. A puzzle
+game's warm sandstone rooms wore a HUD of dark app pills with cyan outlines and system type, and
+its title was a white bold wordmark over the scene with a cyan pill and three icon circles. An ice puzzle's
+frosty board sat under the same pills and stock glyphs ("better icons, not emojis"). A racer had
+heavy navy slabs; a toy game's title stacked panels over its basket; a night game's title floated a
+small dark board in an empty sky. One game looked better only because its creator happened to
+carve its HUD from its world's wood. The cause was ours: the look's direction covered the world,
 the cast and the target frames, but not the interface, so every game fell back to the scaffold's
-dark pill. All three of Fold Room, Floe and Lantern Night still ship the scaffold's own glyphs.
+dark pill. Three of them still ship the scaffold's own glyphs.
 
-We had the answer already. The Last Good Robot's GDD: "Every screen is drawn in the factory's own
+We had the answer already. One of our games' GDD: "Every screen is drawn in the factory's own
 kit (riveted steel plates, one hazard stripe, stencil type) and speaks in the world's voice. A
 screen that isn't specified gets invented by whoever reaches it first." So the look covers the UI
 by default, and the GDD specifies every screen in the world's kit: the screen list (title, how to
@@ -58,7 +58,7 @@ plan-at-size): a plate, a button in its states, a frame for cards, the icon fami
    with the game (two families at most); a system stack is a choice to name, not a default.
 3. **One icon family, drawn like the art.** Pause, sound, hint, undo, stars and the currency are
    one set: the art's outline weight, its corner radius, its two-tone fill, the palette's roles, a
-   motif of the world (Fold Room's sun banner, Floe's snowflake). Never a stock glyph set or emoji.
+   motif of the world (a sun banner, a snowflake). Never a stock glyph set or emoji.
    Read them at 24 and 48 px on the plate they sit on.
 4. **Colour roles from the palette.** Plate, plate edge, ink on the plate, the one accent (and what
    it means), harm. Contrast is computed: 4.5:1 for text, 3:1 for icons (skill
@@ -106,7 +106,7 @@ better. Five that fit most genres:
 | Objects of the world | plates, plaques, tags and buttons made of the world's material | puzzle, adventure, cosy, 3D rooms |
 | The frame holds the numbers | the board's or jar's own frame carries score and next | merge, match, board puzzles |
 | The thin bar | one slim strip along an edge, everything else on the actors | cards, strategy, roguelikes |
-| On the actor | health and state on the hero or the tool (Held Note: "the suit is the HUD", a wrist gauge strapped to her arm) | action, platformers, 3D |
+| On the actor | health and state on the hero or the tool (a horror game: "the suit is the HUD", a wrist gauge strapped to her arm) | action, platformers, 3D |
 | Paper and ink | margin notes, stamps, torn labels, a hand-drawn line | narrative, cosy, crafting |
 
 Then make it this game's: `npx @funpixel/tools variety` sets the title screen beside the other
@@ -133,8 +133,8 @@ game's style from its style frame and saved under `design/first-look/`; each is
 the plan and judged like the HUD:
 - **The title** is the game's first promise and the frame a player judges first. Title key art:
   the game's own scene, never a board preview floating on a flat colour. The overlay comes from the
-  world: the wordmark carved into or lit on its surface, the start as a thing of the world (Fold
-  Room's glowing fold: step in to start), menu buttons of the world's material, icons drawn like
+  world: the wordmark carved into or lit on its surface, the start as a thing of the world (a
+  glowing fold: step in to start), menu buttons of the world's material, icons drawn like
   its motifs, the caption in the display face. Ask of it what a player asks: does it make me want
   to press Play? A white bold wordmark over a pill and three icon circles is the overlay the
   owner called plain, however good the scene behind it.
@@ -150,8 +150,8 @@ the plan and judged like the HUD:
   `fp:verifying`, fidelity).
 - `npx @funpixel/tools look --hud` reads the play and the title for the scaffold's clothes: the
   system type stack, dark neutral plates, the scaffold's own glyphs, icons typed as characters (a
-  "★" or an emoji in a label, what the owner called "emojis" on Floe), a wordmark that is plain
-  system text (a gradient washed over it is still system text: Floe's R4 title). It informs; a creator who chose any of them names why in the hand-back.
+  "★" or an emoji in a label, what the owner called "emojis" on one game), a wordmark that is plain
+  system text (a gradient washed over it is still system text: one game's R4 title). It informs; a creator who chose any of them names why in the hand-back.
 
 How to dress the scaffold's HUD and screens, with worked examples: skill `fp:mobile-ui`, its
 reference `restyle-ui.md`.

package/plugins/robin/claude/skills/art/references/unity.md

@@ -4,7 +4,7 @@
 
 ## Tools
 
-The studio's `com.joydle.core` package carries two of the import rules (fp:unity-game, `references/studio-packages.md`): `SplashImport` scales the studio splash's parts to a power of two with mipmaps, and `BuildTools.TestFlight` refuses to build without `Assets/_Game/Art/Icon/app_icon.png`, importing it at 1024, uncompressed, no alpha. Not shipped by the kit or the package: the Unity starter, its checks and the studio scripts (`key_green.py`, `cut_sheet.py`, a font builder). Do the rest with what exists:
+Have the build method refuse to build without `Assets/_Game/Art/Icon/app_icon.png`, imported at 1024, uncompressed, no alpha. Not shipped by the kit: the Unity starter, its checks and the studio scripts (`key_green.py`, `cut_sheet.py`, a font builder). Do the rest with what exists:
 
 - Generate with the hosted `generate_image` or `generate_sprite`, or `npx @funpixel/tools gen sprite "<prompt>" --size 1024x1024 --references target.png --unity .`: into `Assets/_Game/Generated/Sprites/` (`Images/` for plates, `Textures/` for tiles), imported on first sight as Sprite, no mipmaps, ASTC 5×5 (plates 6×6), by the rule it writes beside them (`Generated/Editor/FunpixelGenImport.cs`; no `.meta` written). Sign in once with `npx @funpixel/tools login`. Give the size: a 9:16 default made a 720×1280 icon. The studio's `gen_image.py` calls the provider with a `.env` key: no metering, no cost log.
 - Key with the hosted `key_sprite`, or ask for `--transparent` art; cut a sheet with `npx @funpixel/tools parts sheet.png --grid 4x2 --key auto` (or `cut` for a painted reference sheet).
@@ -18,7 +18,7 @@ Checks: `texture_audit`, `glyph_coverage`, `tmp_assets_small` and `import_clean`
 ## Procedure
 
 1. Generate sheets against the game's target image, on a green screen, and key them (`key_sprite`, or `--transparent` art). Background removal with BiRefNet ate white objects (a whole plate).
-2. Read every word in generated art by OCR; the report's example is "JOTDLB". Which OCR tool is not in the report.
+2. Read every word in generated art by OCR; a misspelt logo got through. Which OCR tool is not in the report.
 3. Check sprite fill: 0.85 or more of the canvas. One sprite filled only 73%. How to measure fill is not in the report.
 4. Rasterise at the size the sprite is drawn. The reason is not in the report.
 5. Reuse web art: `dwebp` to PNG, pivots from the web's anchors at 100 pixels per unit.
@@ -31,7 +31,7 @@ Checks: `texture_audit`, `glyph_coverage`, `tmp_assets_small` and `import_clean`
    | Splash, any mipmapped art | scaled to power of two |
    | App icon | 1024×1024, uncompressed, no alpha |
 
-7. Pick the ASTC block by role and measure it: round-trip each atlas with astcenc, and use 4×4 if it scores under 35 dB. 6×6 put ringing on Scrap Riot's ink outlines (27–35 dB); 4×4 everywhere costs +2.4 MB.
+7. Pick the ASTC block by role and measure it: round-trip each atlas with astcenc, and use 4×4 if it scores under 35 dB. 6×6 put ringing on one game's ink outlines (27–35 dB); 4×4 everywhere costs +2.4 MB.
 8. Use one material per atlas.
 9. Match colour space to the source renderer on day one. Pixi and canvas blend in gamma; under Linear their translucent overlays were about 2× too strong.
 10. After swapping a PNG, check its sprite rect. A PNG of a new size keeps the old rect and Unity drops the sprite; re-importing an atlas regenerates sprite ids. `import_clean`: a fresh import gives 0 `.meta` diffs and every rect fits its texture.
@@ -42,37 +42,37 @@ Text and glyphs:
 12. Import TMP Essential Resources first, once in the Editor, or `CreateFontAsset` returns null (`funtools doctor` fails a project without them).
 13. Build fonts from the full font file. A web subset lacked Ş, Ğ and İ; Nunito lacks ▶, ◀ and ★.
 14. Run `glyph_coverage`: every character in UI strings and names exists in the atlas, 0 missing.
-15. Warm every glyph behind the title screen. First-use baking cost 183–266 ms in Dawg Ball and 50–270 ms in Pocket Crew (17–20 ms after warm-up); a missing glyph was The Hot Gates' last 48 ms hitch.
+15. Warm every glyph behind the title screen. First-use baking cost 183–266 ms in one game and 50–270 ms in another (17–20 ms after warm-up); a missing glyph was a third game's last 48 ms hitch.
 16. Atlases are 1024×1024 SDF, sampling 64–90, padding 8–12. The report does not settle static against dynamic.
 
    | Atlas | Cost | Seen in |
    |---|---|---|
-   | Static | about 5 MB for 1024² atlases | Scrap Riot, which then went dynamic |
-   | Dynamic | rewritten by every batch run, conflicts on every merge, 8 MB each in git after captures | Pocket Crew (`Nunito ExtraBold SDF.asset`) |
+   | Static | about 5 MB for 1024² atlases | one game, which then went dynamic |
+   | Dynamic | rewritten by every batch run, conflicts on every merge, 8 MB each in git after captures | one game (`Nunito ExtraBold SDF.asset`) |
 
    If dynamic, clear the atlases after captures. `tmp_assets_small`: every `*SDF.asset` in git under 50 KB.
 17. Ship TMP outline and underlay variants as material assets (`Resources/UiFontVariants`). Variants of materials made at runtime are stripped from release builds.
 18. Use `textWrappingMode`; `enableWordWrapping` is obsolete in Unity 6 (`funtools doctor` warns).
-19. Judge icon candidates small and against competitors: The Hot Gates masked them at 100, 60 and 40 px in a mock search row with 41 competitor icons, for $5.95.
+19. Judge icon candidates small and against competitors: one game masked them at 100, 60 and 40 px in a mock search row with 41 competitor icons, for $5.95.
 
 ## Worked example
 
-Dead Letter (a 2D port from Pixi), texture pass:
+A 2D port from Pixi, texture pass:
 
 1. Web sprites as PNG; pivots from the web's anchors at 100 pixels per unit, set in the game's setup script.
 2. Colour space switched from Linear to Gamma, because translucent overlays were about 2× too strong.
 3. ASTC by role: painted plates 8×8, sprites 6×6, hero and HUD art 5×5.
 4. Result: textures 69 → 50 MB with no visible change.
-5. The power-of-two splash fix (PR #14) made every game 7–8 MiB smaller; Koi Out's resources went 11.7 → 3.8 MB.
+5. The power-of-two splash fix made every game 7–8 MiB smaller; one game's resources went 11.7 → 3.8 MB.
 
 ## Common mistakes
 
 - A mipmapped texture that is not a power of two. The splash shipped 10.3 MB raw in every game.
-- One block size for everything. 6×6 rang the ink outlines on Scrap Riot's atlases.
-- Text in generated art not read: "JOTDLB" (game not named).
+- One block size for everything. 6×6 rang the ink outlines on one game's atlases.
+- Text in generated art not read: a misspelt logo (game not named).
 - Art that does not fill its canvas: spool art at 73% fill (game not named).
 - A swapped PNG that kept its old sprite rect: an empty logo on TestFlight (game not named).
 - A subset font: "KARABAŞ" broke (game not named).
-- Outline variants not shipped: outlined numbers drew as cream blobs in The Hot Gates' player build.
-- Dynamic atlases left after captures: 8 MB each in git. Two review builds (Dead Letter, Scrap Riot) carried uncommitted reimports of 4 TMP font assets, so main no longer matched what Apple reviewed.
-- Icons by prompt: Dawg Ball spent $21.46 over 7 rounds before a pick; round one came out 720×1280 from the 9:16 default.
+- Outline variants not shipped: outlined numbers drew as cream blobs in one game's player build.
+- Dynamic atlases left after captures: 8 MB each in git. Two review builds carried uncommitted reimports of 4 TMP font assets, so main no longer matched what Apple reviewed.
+- Icons by prompt: one game spent $21.46 over 7 rounds before a pick; round one came out 720×1280 from the 9:16 default.

package/plugins/robin/claude/skills/audio/references/adaptive-music.md

@@ -159,7 +159,7 @@ music.muffle(0.2);
 ## Prove it follows play (free, before anyone listens)
 
 A mix driven by a timer reads as a playlist; one that never moves is a single loop with extra
-files. Keep the decision pure and beside the rules, as Gesundheit's `src/mix.ts` does:
+files. Keep the decision pure and beside the rules, as one game's `src/mix.ts` does:
 `musicMix(run, screen, lift) → { calm, swarm, lift }`, where `swarm` rises with the bugs on the
 field and sniffling ones count more. The `Music` class sets gains from it each frame, and a probe
 can chart the same function while a bot plays, with no browser and no audio device:
@@ -171,7 +171,7 @@ timelines: [{ name: 'wave 3', follow: [{ layer: 'swarm', driver: 'threats' }], r
 ```
 
 `npx @funpixel/tools sim` then says, per layer: it never moved (warn), it moved but not with what
-it follows (note, with the correlation), or it follows (r and the sample count). Gesundheit's
+it follows (note, with the correlation), or it follows (r and the sample count). That game's
 `music-timeline.ts` printed the same chart as bars per half second with the chain and bloom
 marks beside them, which is how its creator saw the lift arrive on the payoff. The numbers
 cannot say it sounds good; listen once the chart says it moves.
@@ -183,8 +183,8 @@ cannot say it sounds good; listen once the chart says it moves.
   between them is part of the music.
 - The set piece: `muffle()` down for a beat before it, `sting()` on the reveal, then
   `switchOnBar()` to the `wonder` take, and leave it on while the player looks.
-- A score built on the game's own sound. Held Note (a horror game, 29 Sep 2026) built its music
-  on one held note that bends as an enemy nears and gains layers with the threat, per-room ambience
+- A score built on the game's own sound. A horror game (29 Sep 2026) built its music
+  on one sustained note that bends as an enemy nears and gains layers with the threat, per-room ambience
   beds under it, stingers on reveals, and real silence between phrases; the silence is what
   makes the next phrase land. Its radio voices were band-limited and driven like a small speaker
   with line noise, so a recording sounds like a recording.

package/plugins/robin/claude/skills/audio/references/engine.md

@@ -21,10 +21,10 @@ line below answers a failure our games shipped with.
   sound per overlapping frame turns one hit into four (the tide-pool chime in the skill's worked
   example read `sounds` +4 per match until a 50 ms cooldown made it 1). ±6% pitch jitter keeps a
   repeated sound from reading as a loop. For the sounds a player hears most (footsteps, the core
-  hit), Held Note generated 2–4 takes and picked one at random per play with ±4% pitch and ±2 dB,
+  hit), one game generated 2–4 takes and picked one at random per play with ±4% pitch and ±2 dB,
   which hid the repeat better than jitter on one take.
 - **Voices over everything else.** Duck music and beds under a voice line, and let a sound
-  behind a wall go through a low-pass (Held Note's occlusion), so the voice and the room stay
+  behind a wall go through a low-pass (occlusion), so the voice and the room stay
   legible.
 - **Mute where the player looks first.** Players who want silence look on the first screen and in
   the HUD; a mute that resets on reload, or lives only in a settings menu, sends them away.

package/plugins/robin/claude/skills/audio/references/measure.md

@@ -88,7 +88,7 @@ ffmpeg -i pool.mp3 -af loudnorm=I=-18:TP=-1 -ac 1 -b:a 96k pool-m.mp3
 ```
 
 `loudnorm` cannot measure a clip under about 0.4 s (its integrated loudness needs longer blocks),
-and on short files it silently changes how it behaves. Held Note (29 Sep 2026) levelled its short
+and on short files it silently changes how it behaves. One game (29 Sep 2026) levelled its short
 sounds by their loudest 100 ms instead (the snippet above uses a 300 ms window; shorten `w` for
 clips that short), and kept `loudnorm` for music and loops.
 

package/plugins/robin/claude/skills/audio/references/unity.md

@@ -4,9 +4,10 @@ The audio bug these games hit most was no sound at all. Four games went to TestF
 
 ## Tools
 
-The studio's `com.joydle.core` package carries the player side (fp:unity-game, `references/studio-packages.md`): `Sfx.Create(musicClip)` makes 8 pooled one-shot sources and one looping music source at volume 0.45 and calls `Sfx.EnsureListener()`, which adds an `AudioListener` when none exists; `Play(clip, volume)` jitters pitch by 0.06; `Settings.Sound` and `Settings.Music` are the player's toggles; `BuildTools.SimulatorMuted` builds a Simulator build with audio off for captures and restores the setting after. Not shipped by the kit or the package: the Unity starter, its checks and the studio scripts (the upload pre-flight, a music length check, a one-funnel effect tap, the audio import rule). Do those with what exists:
+Not shipped by the kit: the Unity starter, its checks and the studio scripts (the upload pre-flight, a music length check, a one-funnel effect tap, the audio import rule). Do those with what exists:
 
 - Generate into the project: `npx @funpixel/tools gen sound "<cue>" --unity .` (`gen music`, `gen line`; `--loop` for a bed), after `npx @funpixel/tools login`. It lands 48 kHz WAV (ffmpeg trims the MP3's encoder padding) in `Assets/_Game/Generated/Sfx/`, `Loops/`, `Music/` or `Voice/`, and a rule set once per file: effects mono, ADPCM, decompress on load, normalisation off; loops PCM; music Vorbis, streaming. The studio's `gen_sfx.py` and `gen_music.py` call the same providers with `.env` keys: no metering, no cost log.
+- A sound class of your own: 8 pooled one-shot sources with a pitch jitter of about 0.06, one looping music source at volume 0.45, an `AudioListener` added when none exists, and the player's Sound and Music toggles.
 - Before every upload, read `ProjectSettings/AudioManager.asset` yourself: `grep "m_DisableAudio: 1"` must find nothing.
 - `npx @funpixel/tools loudness Assets/Audio` reads every cue against its loudness target (ffmpeg EBU R128); ffmpeg's `ebur128`, `volumedetect` and `silencedetect` filters do the same by hand. `npx @funpixel/tools beats Assets/Audio/Music` writes each track's beat map.
 - Music length: an Edit Mode test that compares each clip's `AudioClip.samples` with its reference length.
@@ -18,7 +19,7 @@ Checks: `audio_runtime` and `recording_check` are proposed, not built. The studi
 
 ## Procedure
 
-1. Make exactly one AudioListener and assert it at startup. A scene generated by code gets none by default; `Sfx.Create` adds it (or call `Sfx.EnsureListener()`).
+1. Make exactly one AudioListener and assert it at startup. A scene generated by code gets none by default; have the sound class add one when none exists.
 2. Set the project through the setup script, not a copied file: audio on (`m_DisableAudio: 0`) and `m_SampleRate` 48000. A cloned project carried `m_DisableAudio: 1`, and the Simulator mixed at 24 kHz without the rate.
 3. Write import rules in code and change the rule, never the `.meta`. A size pass that edited 190 SFX metas by hand was silently reverted by the rule on the next import.
 
@@ -35,23 +36,23 @@ Checks: `audio_runtime` and `recording_check` are proposed, not built. The studi
 
    | Game | Figure |
    |---|---|
-   | Pocket Crew | music −18.5 LUFS, peaks at most −1 dBFS |
-   | Stitch Pop | SFX mean −18 to −28 dB; music volume 0.45, about 7 dB under SFX |
-   | Noodle Nights | crowd bed −30 LUFS |
-
-8. Mix in code. No game uses an AudioMixer asset. Dead Letter ports its web mixer: buses, an 8-voice cap, round-robin variants, cooldowns, ±6% pitch, music crossfade, stinger ducks, and a tension loop that ducks music by 4 dB.
-9. In a port, route every sound through one tap so an audit runs headless. Pocket Crew: 468 events, 0 mismatches against the web.
-10. Re-render procedural web audio offline in C# instead of synthesising live. Dawg Ball's 70 clips (17.7 s) warm in 64 ms at boot; The Hot Gates' 41 cues and 3 loops match Chromium sample for sample (138 tests).
-11. Handle interruptions: an Ambient audio session (it respects the silent switch and other apps), sound held on pause and during the studio splash (`JoydleSplash` pauses the game's audio until it ends; start the title music once `JoydleSplash.Playing` is false), resumed after backgrounding, calls or Siri. `OnApplicationPause(true)` also fires on resign-active (Control Center, Siri, call banners, Face ID).
+   | A 3D platformer | music −18.5 LUFS, peaks at most −1 dBFS |
+   | A casual game | SFX mean −18 to −28 dB; music volume 0.45, about 7 dB under SFX |
+   | An idle game | crowd bed −30 LUFS |
+
+8. Mix in code. No game uses an AudioMixer asset. One port carries over its web mixer: buses, an 8-voice cap, round-robin variants, cooldowns, ±6% pitch, music crossfade, stinger ducks, and a tension loop that ducks music by 4 dB.
+9. In a port, route every sound through one tap so an audit runs headless. One port: 468 events, 0 mismatches against the web.
+10. Re-render procedural web audio offline in C# instead of synthesising live. One game's 70 clips (17.7 s) warm in 64 ms at boot; another's 41 cues and 3 loops match Chromium sample for sample (138 tests).
+11. Handle interruptions: an Ambient audio session (it respects the silent switch and other apps), sound held on pause, resumed after backgrounding, calls or Siri. `OnApplicationPause(true)` also fires on resign-active (Control Center, Siri, call banners, Face ID).
 12. Run `audio_runtime` in the player: 1 listener, 48 kHz output, music playing within 3 s (of the splash's end, when one plays).
 13. Before sharing or uploading any video, run `recording_check`: 0 frame gaps over 34 ms and audio at 44.1 kHz or higher.
 14. Run the numeric lint (LUFS, peak, seam), then have a person listen. An agent can measure audio but not hear it, so the listen is a required gate on every game's ship-blocker list.
 
-Music that follows play: Dawg Ball's crowd volume swells near goals; Dead Letter crossfades and ducks on stingers. No game has layered adaptive music.
+Music that follows play: one sports game's crowd volume swells near goals; another game crossfades and ducks on stingers. No game has layered adaptive music.
 
 ## Worked example
 
-Scrap Riot (a 2D port from Pixi), music loops and SFX levels:
+A 2D port from Pixi, music loops and SFX levels:
 
 1. The MP3 loops decoded 1,245–1,997 samples long, so loops gapped.
 2. The loops were rebuilt as OGG from the web's `.m4a` at exact sample counts. Background music went 96 → 10 MB.
@@ -62,12 +63,12 @@ Scrap Riot (a 2D port from Pixi), music loops and SFX levels:
 ## Common mistakes
 
 - A code-made camera with no AudioListener: all four first games reached TestFlight silent; it cost one TestFlight round for three of them. `funtools doctor` warns when nothing adds one.
-- A cloned ProjectSettings: Dead Letter inherited `m_DisableAudio: 1`; the studio's upload pre-flight (proposed for the kit) caught it.
-- No 48 kHz setting: The Hot Gates mixed at 24 kHz and sounded muffled.
-- MP3 or ADPCM for loops: gaps (Scrap Riot) or clicks.
-- Uncommitted reimports: two review builds (Dead Letter, Scrap Riot) carried 190 reimported `.wav.meta` files, so main no longer matched what Apple reviewed.
-- Showing a recording before measuring it: a `simctl recordVideo` capture of The Hot Gates had 19 frame gaps up to 0.85 s and 24 kHz audio, cost about 1 h and was cancelled.
-- Generated audio nobody heard: Dawg Ball's 70 sounds, as of 29 Sep.
-- Many relaunches wedge the Simulator's CoreAudio (crash at audio init); `BuildTools.SimulatorMuted` (audio off for that build only, restored after) avoids it for capture runs, and the upload pre-flight refuses any build with audio off.
+- A cloned ProjectSettings: one game inherited `m_DisableAudio: 1`; the studio's upload pre-flight (proposed for the kit) caught it.
+- No 48 kHz setting: one game mixed at 24 kHz and sounded muffled.
+- MP3 or ADPCM for loops: gaps or clicks.
+- Uncommitted reimports: two review builds carried 190 reimported `.wav.meta` files, so main no longer matched what Apple reviewed.
+- Showing a recording before measuring it: a `simctl recordVideo` capture of one game had 19 frame gaps up to 0.85 s and 24 kHz audio, cost about 1 h and was cancelled.
+- Generated audio nobody heard: one game's 70 sounds, as of 29 Sep.
+- Many relaunches wedge the Simulator's CoreAudio (crash at audio init); a Simulator build with audio off for that build only, restored after, avoids it for capture runs, and the upload pre-flight refuses any build with audio off.
 - `git commit -a` after a headless run: every run rewrites AudioManager.
 - The silent switch mutes Unity's Ambient session; accepted for casual games.

package/plugins/robin/claude/skills/game-feel/SKILL.md

@@ -46,7 +46,7 @@ responses. More particles or shake do not automatically mean better feel.
    compulsory bundle. Keep the most important event distinct from routine actions. In an action
    game with several weapons, one contact function they all call keeps the feel consistent and
    tunable in one place; a new weapon that opens or cashes a state the old verbs already make
-   (a reeling enemy) gives combos without new systems. Held Note's values, its weapons as tools
+   (a reeling enemy) gives combos without new systems. One action game's values, its weapons as tools
    of a pillar, and what its blind player caught: [references/contact.md](references/contact.md).
 
 3. **Protect control and fairness.** Hitstop freezes the picture, not the player: a press during
@@ -92,13 +92,13 @@ input problem may instead need a contact pose and a short impact cue.
 - Deleting feedback in reduced motion instead of replacing uncomfortable effects.
 - Calling effects measured in a quiet one-second sample proof that attacks read correctly.
 - A verb that exists only in the sim: with no pose, sound or visible result, players report it
-  missing (Held Note's shove, for weeks).
-- Limiting a helper the genre's hit never limits (Lantern Night's capped jar, reported as a bug
+  missing (one game's shove, for weeks).
+- Limiting a helper the genre's hit never limits (one game's capped jar, reported as a bug
   twice; Peggle's bucket never runs out). A real resource keeps its empty state visible.
 - A tell carried by sound alone: a muted phone never hears it, so the visual has to build across
   the whole warning.
 
-Where this comes from: our own games (the juice tables, Held Note's contact work, the `feel`
+Where this comes from: our own games (the juice tables, one action game's contact work, the `feel`
 measures) and the hits in research 18; the juice vocabulary from Vlambeer's talks and "Juice it or
 lose it"; review habits from Claude Code Game Studios (MIT); hitstop that freezes the picture, not
 the player, began as a platform engine note.

package/plugins/robin/claude/skills/game-feel/references/contact.md

@@ -1,6 +1,6 @@
 # Contact, verbs and weapons in an action game
 
-What one 3D action game learned about hits, verbs and weapons. Held Note is a third-person
+What one 3D action game learned about hits, verbs and weapons. It is a third-person
 deep-sea horror game in three.js, built with the GDK's tools in September 2026 (its making notes:
 `design/MAKING.md`, `PERF.md`, `assets.md`). Between its first and second playtest, the round
 that added the contact work below, the blind critic panel's juice score went 5.60 → 6.17 and look
@@ -9,10 +9,10 @@ reason, not a proven recipe. A quiet puzzle needs none of this.
 
 ## One contact function
 
-Every weapon in Held Note calls one `impact(target, dir, kind)`, so a weapon added later inherits
+Every weapon in it calls one `impact(target, dir, kind)`, so a weapon added later inherits
 the feel, and tuning happens in one place. What that function did:
 
-| Part | Held Note's value | Why |
+| Part | Its value | Why |
 |---|---|---|
 | Target jolt | along the hit direction | shows where the force went |
 | Flash | the struck part goes white for a few frames | says "that one", even in the dark |
@@ -40,7 +40,7 @@ export function impact(t: Target, dir: Vec3, kind: 'hit' | 'sever' | 'kill') {
 
 ## A verb nobody can see does not exist
 
-Held Note's shove worked in the sim for weeks with no body animation, and the owner asked "don't we
+The game's shove worked in the sim for weeks with no body animation, and the owner asked "don't we
 have a melee attack?". To a player, a verb without a pose, a sound and a visible result is not
 there. A two-handed shove and a slash fixed it. `funtools feel` reads each actor's look per state
 ([measure](measure.md)), which shows a state that borrows another's pose.
@@ -61,7 +61,7 @@ A question to ask of any new verb or weapon: which state does it open, and which
 
 ## Weapons as tools that serve a pillar
 
-Held Note's three tools each answer a design pillar and draw on the one shared resource (the gas
+The game's three tools each answer a design pillar and draw on the one shared resource (the gas
 canister), so adding them kept the economy:
 
 - the cutter takes joints (the core verb);
@@ -104,7 +104,7 @@ sound can add to it without carrying it alone.
 
 ## Films need a bot that fights
 
-Held Note's route bots only cut, so films made from their runs showed no combat and a review could
+The game's route bots only cut, so films made from their runs showed no combat and a review could
 not judge the weapons. A `fighter` bot style, for films only (the tests keep the median bot), plays
 the verbs a keen player would: Counters, knives, rivets, a death. If the payoff is a fight, film a
 fight.

package/plugins/robin/claude/skills/game-feel/references/unity.md

@@ -1,28 +1,23 @@
 # Game feel: motion, juice and haptics
 
-Feel bugs pass every test. Dawg Ball's sim (the engine-free rules, stepped at a fixed 60 Hz) was correct, but 1 frame in 8 advanced 0 or 2 sim ticks, so the ball stalled and then jumped all match; the owner called it trembling. This skill gives each moment a measured answer and names the effects that were built, then removed.
+Feel bugs pass every test. One soccer game's sim (the engine-free rules, stepped at a fixed 60 Hz) was correct, but 1 frame in 8 advanced 0 or 2 sim ticks, so the ball stalled and then jumped all match; the owner called it trembling. This skill gives each moment a measured answer and names the effects that were built, then removed.
 
 ## Tools
 
-The studio's `com.joydle.core` package carries the tweens and haptics (fp:unity-game, `references/studio-packages.md`):
-
-- `Juice.Tween(duration, step, unscaled)` with `EaseOutBack`, `EaseOutCubic` and `EaseInQuad`; `Juice.Pop` (scale 0.18 over 0.22 s, keeping the true rest scale) and `Juice.Shake` (0.08 over 0.25 s); `Juice.Ring` and `Juice.Dot` sprites for ripples and sparkles.
-- `Haptics.Light`, `Medium`, `Heavy`, `Success` and `Error`: iOS taptics through the package's native plugin, Android vibration effects, off when `Settings.Haptics` is. The throttle and merge in step 5 are the game's.
-
-Not in the kit or the package: the Unity starter, a frame-owner `GameDriver`, an interpolation blend with a trace flag, a near-miss tracker and the `moment_freq` check. Write those yourself:
+Not in the kit: the Unity starter, coroutine tweens (a pop, a shake, eases), haptics by strength (iOS taptics through a native plugin, Android vibration effects, off with the player's setting), a frame-owner `GameDriver`, an interpolation blend with a trace flag, a near-miss tracker and the `moment_freq` check. Write those yourself:
 
 - A frame owner: one `MonoBehaviour` that reads input, steps the sim at a fixed rate (`sim.Update(dt)`), sends events to presenters and draws with `Render(alpha)`.
 - Interpolation and its trace: blend the drawn state between the last two ticks, and a dev-only launch flag that writes per-frame tick counts to a `trace.csv`.
 - A near-miss detector in the engine-free core, so bots can count it.
 - Frequency tests: bot batches in an Edit Mode test (`funtools unity run -- -nographics -runTests -testPlatform EditMode -testResults results.xml`, never with `-quit`: the test runner exits by itself), or `dotnet test` on an engine-free core, at 30 and 60 fps.
 
-No game uses DOTween (`Juice` does the tweens). Gallery Heist's views branch aims its camera with Cinemachine 6.6 and plays its intro on Timeline; the rest drive the camera in code. Nothing checks sliding feet or loop pops.
+No game uses DOTween (coroutine tweens do). One game's views branch aims its camera with Cinemachine 6.6 and plays its intro on Timeline; the rest drive the camera in code. Nothing checks sliding feet or loop pops.
 
 ## Procedure
 
 1. Render interpolated between the last two fixed sim ticks. Check: 100% of frames with steps other than 1 are blended, and drawn-ball jerk p99 is under a threshold (value not in the report). A teleported or thrown ball blends for 0.18 s.
 2. Tie per-frame effects to sim steps, or scale them by dt (`1 - Math.Pow(0.4, dt*60)`). Check: headless runs at 60 and 120 Hz give the same end-state hash and effect counts per sim second.
-3. Buffer the main action. Dawg Ball's kick has a 200 ms buffer (`BufferMs`): a press arms it and the foot swings when the ball arrives.
+3. Buffer the main action. The soccer game's kick has a 200 ms buffer (`BufferMs`): a press arms it and the foot swings when the ball arrives.
 4. Answer each moment from the table.
 
    | Moment | Answer | Duration |
@@ -37,9 +32,9 @@ No game uses DOTween (`Juice` does the tweens). Gallery Heist's views branch aim
    | Goal | net bulge, goal shake, the only big callout | no slow-mo |
 
 5. Map haptics by strength: a web vibration of 30 ms or more is heavy, 14 ms or more medium, else light. Throttle to 80–90 ms and merge pulses inside 120 ms into the strongest, so a light tap does not swallow a heavy one.
-6. Keep each tween's true rest scale (`Juice.Pop` keys it by Transform); otherwise a second pop records a mid-pop scale as the base.
-7. Draw particles from fixed pools; the pool is the budget. Dead Letter: 2 quad batches, 600 particles. Dawg Ball: 220 sprites, 120 confetti, 14 rings in 6 batched meshes. At most 120 spawns per second, oldest recycled; ambient at most 40 live.
-8. Frequency-test every juice event with bot batches at 30 and 60 fps. Dawg Ball's targets: own goals at most 0.3 per match, misses and blocks 2–5 per 90 s.
+6. Keep each tween's true rest scale (key it by Transform); otherwise a second pop records a mid-pop scale as the base.
+7. Draw particles from fixed pools; the pool is the budget. One 2D game: 2 quad batches, 600 particles. The soccer game: 220 sprites, 120 confetti, 14 rings in 6 batched meshes. At most 120 spawns per second, oldest recycled; ambient at most 40 live.
+8. Frequency-test every juice event with bot batches at 30 and 60 fps. The soccer game's targets: own goals at most 0.3 per match, misses and blocks 2–5 per 90 s.
 9. Keep in-match overlays minimal; do not freeze or slow play while the clock runs.
 10. Measure a camera change against the problem it is meant to fix, in frames.
 11. Honour the effects setting: shake is skipped when "Shake & flashes" is off, and the kickoff dolly (about 1/3 closer over the 1.5 s countdown) when screen effects are off.
@@ -48,17 +43,17 @@ No game uses DOTween (`Juice` does the tweens). Gallery Heist's views branch aim
    | Role | How | Numbers |
    |---|---|---|
    | Hero | code; ports copy the web's procedural rig | pose tweens 0.22–0.4 s |
-   | Rigged cast (Noodle Nights only) | Animator blend trees | transitions 0.12–0.15 s, exit time 0.9 |
-   | Crowd (The Hot Gates) | vertex-animation textures, GPU instancing | 1,800 units in 18 draws |
+   | Rigged cast (one game only) | Animator blend trees | transitions 0.12–0.15 s, exit time 0.9 |
+   | Crowd | vertex-animation textures, GPU instancing | 1,800 units in 18 draws |
    | UI | coroutine tweens | defaults above |
 
    Root motion is off everywhere: the sim owns positions.
 13. Show the owner a zoomed close-up on one asset before rolling out a style.
-14. Finish with a person playing on a phone: Dawg Ball's feel bugs came from the owner's TestFlight play.
+14. Finish with a person playing on a phone: the soccer game's feel bugs came from the owner's TestFlight play.
 
 ## Worked example
 
-Dawg Ball (a 3D port from three.js):
+A soccer game (a 3D port from three.js):
 
 1. A dev trace flag wrote `trace.csv`: at a 60 Hz sim, 1 frame in 8 (12%) advanced 0 or 2 ticks.
 2. A blend draws every frame between the last two ticks.
@@ -68,11 +63,11 @@ Dawg Ball (a 3D port from three.js):
 
 ## Common mistakes
 
-- Slow-mo on goals (Dawg Ball): fired 14 times a match, read as lag, and shipped in every TestFlight build until 1 Oct.
-- A follow camera (Dawg Ball) showed both goals only 18–40% of the time; reverted to a fixed full-pitch view. With the next item, two rounds lost.
-- A camera lift for barks (Dead Letter): changed 0 covered frames (2–8 of 165 either way) and added a 25–69 pt view shift; PR #11 was reverted in PR #12.
-- A sticker-border shader (Dawg Ball): a 2D mock-up style put on dogs, ball and goals before a close-up was shown. It did not transfer to 3D, broke static merging (dozens more draws), cost about 3 builds and was removed: "it was much better before". Four more decorations were reverted the same way in 24 h.
-- A 1.6 s freeze after goals (Dawg Ball) read as "freezy".
-- Effects per render frame: at 120 Hz Pocket Crew's bobs and sparkles ran twice as fast.
+- Slow-mo on goals: fired 14 times a match, read as lag, and shipped in every TestFlight build until 1 Oct.
+- A follow camera showed both goals only 18–40% of the time; reverted to a fixed full-pitch view. With the next item, two rounds lost.
+- A camera lift for barks (a 2D game): changed 0 covered frames (2–8 of 165 either way) and added a 25–69 pt view shift; PR #11 was reverted in PR #12.
+- A sticker-border shader: a 2D mock-up style put on dogs, ball and goals before a close-up was shown. It did not transfer to 3D, broke static merging (dozens more draws), cost about 3 builds and was removed: "it was much better before". Four more decorations were reverted the same way in 24 h.
+- A 1.6 s freeze after goals read as "freezy".
+- Effects per render frame: at 120 Hz one game's bobs and sparkles ran twice as fast.
 - Concurrent pop tweens on one Transform: the cash pill grew huge (game not named).
-- "44 of 304 kicks connected" (Dawg Ball) is cited for this skill; its cause and fix are not in the report.
+- "44 of 304 kicks connected" (the soccer game) is cited for this skill; its cause and fix are not in the report.

package/plugins/robin/claude/skills/game-logic/SKILL.md

@@ -49,7 +49,7 @@ native in about a day each, and the ports found four bugs the tests had missed (
    `__FPX_STATE__()` exposes `seed`.
 3. **Rules as numbered, named constants** (`R1 jump height 3.2 tiles`, `R2 coyote 80 ms`) in
    `src/sim/rules.ts`, listed in the design note, each proved by a test named after it
-   (`R2: a jump 70 ms after leaving a ledge still fires`). Dead Letter's rule ids let traversal tests
+   (`R2: a jump 70 ms after leaving a ledge still fires`). One game's rule ids let traversal tests
    catch a ledge with 64 px of headroom (research 12); a change then moves the note, the constant and
    the test together.
 4. **Determinism as a test.** Same seed and inputs, same state hash; a tiebreaker on every sort and a
@@ -68,7 +68,7 @@ hand-made anchors plus a seeded recipe the bots check: [references/content-at-sc
 ## Escalation changes what the player does
 
 Faster alone leaves the game the same, only harder to read, and `check_plan` flags a ramp that is
-speed alone. Dead Letter's review found its ramp invisible: the area indicator was computed and not
+speed alone. One game's review found its ramp invisible: the area indicator was computed and not
 drawn. A ramp as a list of what changes, new things one at a time, waves with rests, and a ramp the
 player can see: [references/escalation.md](references/escalation.md).
 
@@ -83,7 +83,7 @@ option with its reason; the bots below measure them.
 
 A headless loop over `src/sim` plays thousands of runs in seconds, where a browser session plays
 one, so tuning from bots, a frozen novice floor, a bot that finishes the level in `npm test` (in
-Held Note it caught a speed change that starved a route), a blind phone player, a parameter sweep
+one game it caught a speed change that starved a route), a blind phone player, a parameter sweep
 and a hunt for what bots never do all come cheap once the rules stand alone. Each, with its reason
 and where it came from: [references/balance.md](references/balance.md); the five probe players and
 `sim`: [references/probes.md](references/probes.md).

package/plugins/robin/claude/skills/game-logic/references/balance.md

@@ -33,10 +33,10 @@ fitted the seeds or the game. This floor is a regression check: it predicts no h
 and fails the suite when it no longer reaches the end, is the other half: a balance change that
 makes the level unfinishable turns the tests red at once. A `funtools init` game starts with one
 (`rules.test.ts`: `botRound` wins a round on seed 5); a longer game grows it. This is a lesson from
-one game, Held Note (a 3D horror chapter, September 2026, gathered by the Held Note lane), and no
+one game (a 3D horror chapter, September 2026, gathered by its lane), and no
 first-try action game has tested it yet.
 
-Held Note's chapter test (`chapter.test.ts`, "Contract H", named after the GDD's numbers) carried:
+Its chapter test (`chapter.test.ts`, "Contract H", named after the GDD's numbers) carried:
 
 - `median_bot_finishes` for each of two routes (seal every weldable door, or fight through) on five
   seeds. The bot plays through the same intent a thumb produces, with a human reaction budget.

package/plugins/robin/claude/skills/game-logic/references/depth.md

@@ -4,8 +4,8 @@ What a player gets from a game over ten minutes, and what brings them back for r
 in one session can match a hit on feel per second; the next thing it loses on is depth. In our
 head-to-heads against the genre hits (29 Sep), the player seat chose the hit almost every time and
 said why: "a dense, escalating ten-minute score attack against a single sparse maze, a 1:38 run"
-(Riad Rush against Pac-Man CE DX), "the early basket is too sparse, there is no packing pressure"
-(Plush Pop against Suika Game), "no endless mode, no leaderboard" (Gesundheit). Depth here is
+(a maze game against Pac-Man CE DX), "the early basket is too sparse, there is no packing pressure"
+(a merge game against Suika Game), "no endless mode, no leaderboard" (an arcade game). Depth here is
 structure and numbers, not content volume, so it is within a session's reach. Everything below is an
 option with its reason; pick what serves the game and write the choice into the design note.
 

package/plugins/robin/claude/skills/game-logic/references/escalation.md

@@ -1,7 +1,7 @@
 # Escalation that changes what the player does
 
 Detail for the escalation section of the game-logic skill. Faster alone leaves the game the same,
-only harder to read. Dead Letter's review found its ramp invisible: the area indicator was computed
+only harder to read. One game's review found its ramp invisible: the area indicator was computed
 and not drawn. What has worked:
 
 1. A ramp written as a list of what changes: a new enemy type, a pattern, a narrower gap, a second
@@ -19,12 +19,12 @@ and not drawn. What has worked:
 novice and skilled players, how many clear each level, how many lose there and how long they spend.
 It warns on four shapes that lost players on 30 Sep:
 
-- **Flat**: everyone clears it, nobody loses, in under 45 s (Lantern Night's first garden gave three
+- **Flat**: everyone clears it, nobody loses, in under 45 s (one game's first garden gave three
   stars in 35 s). A first level may teach; a flat level mid-ramp is time with nothing to learn.
-- **A wall for people**: the skilled bot clears it only at 60 decisions a second (Saltwake's Dusk
-  Cup). Wrap the sharp policy in `humanRate` (12 decisions a second, 200 ms to react; a thumb makes
+- **A wall for people**: the skilled bot clears it only at 60 decisions a second (one racer's last
+  cup). Wrap the sharp policy in `humanRate` (12 decisions a second, 200 ms to react; a thumb makes
   10–15) and read both: a level the twin cannot clear asks for superhuman input.
-- **Cannot be lost**: no player lost a run over minutes of play (Sunhop). A puzzle or toy on purpose
+- **Cannot be lost**: no player lost a run over minutes of play (one of our games). A puzzle or toy on purpose
   says so; else a threat, a clock or a resource can end a run.
 - **No ramp**: the novice loses no more and takes no longer later than early.