@funpixel/tools 0.1.0 → 0.1.1

package/plugins/claude/skills/store/references/unity-store.md

@@ -4,9 +4,6 @@ Four of eight first submissions were rejected (guideline 2.1(b) twice, 2.3.3, 2.
 
 ## Tools
 
-- The studio's `com.joydle.core` (`fp:unity-game`, `references/studio-packages.md`):
-  `IapService(catalog, grant)` with `Init()`, `Buy(id)`, `Restore(done)` and `Price(id)`;
-  `Ads.CreateDefault(font)` and `Ads.Available`; `Telemetry` with `com.joydle.firebase` as its sink.
 - `npx @funpixel/tools store init --store ios` writes `store/answers.json` (listing, products, the
   SDK list, review notes); `npx @funpixel/tools store lint --store ios` checks lengths, price words and
   the privacy answers against the SDKs. App Store Connect (web or API) takes the listing.
@@ -31,13 +28,13 @@ Four of eight first submissions were rejected (guideline 2.1(b) twice, 2.3.3, 2.
 
 ## Procedure
 
-1. Sell only what the binary holds (`iap_truth`). Every IAP id needs an App Store Connect product and an entry point, and copy names nothing unbuilt. Store copy promised modes that existed only as data, and a Supporter IAP had nothing to buy (guideline 3.1.1). No ad network is live, so hide No Ads (four such IAPs had to be held): while `Ads.Available` is false, every ad button is hidden. Put one purchase gate at the first line of `StartLevel`, and a store interface even when 1.0 sells nothing (report §12).
+1. Sell only what the binary holds (`iap_truth`). Every IAP id needs an App Store Connect product and an entry point, and copy names nothing unbuilt. Store copy promised modes that existed only as data, and a Supporter IAP had nothing to buy (guideline 3.1.1). No ad network is live, so hide No Ads (four such IAPs had to be held): while no ad network is available, every ad button is hidden. Put one purchase gate at the first line of `StartLevel`, and a store interface even when 1.0 sells nothing (report §12).
 2. Put Buy within two taps of the title on a fresh install (`iap_reach`): an Unlock row in Settings next to Restore, plus a title-screen entry. Name the path in the review notes.
-3. Make Restore real (`restore_real`). It calls `RestoreTransactions` only from a tap, because a launch-time restore shows an Apple sign-in prompt, and it ends in "restored" or "nothing to restore". App Review always taps Restore; Scrap Riot's only fetched purchases and spun for 45 s.
-4. Show prices only from `Price(id)`, the store's localised string. Failure text is plain; a cancel says nothing.
-5. Grant a pending order exactly once (`iap_pending_once`). Unity IAP 5 routes pending orders to `OnPurchasePending`; the shared `IapService` granted them again from the fetch too, until the fix of 7 Oct (it now grants once per transaction). A game built before it needs a new build.
+3. Make Restore real (`restore_real`). It calls `RestoreTransactions` only from a tap, because a launch-time restore shows an Apple sign-in prompt, and it ends in "restored" or "nothing to restore". App Review always taps Restore; one game's only fetched purchases and spun for 45 s.
+4. Show prices only from the store's localised string. Failure text is plain; a cancel says nothing.
+5. Grant a pending order exactly once (`iap_pending_once`). Unity IAP 5 routes pending orders to `OnPurchasePending`; a shared purchase service granted them again from the fetch too, until the fix of 7 Oct (it now grants once per transaction). A game built before it needs a new build.
 6. Buy end to end before review. Products never load on the Simulator without a StoreKit configuration, and no game bought an IAP end to end before submitting; a person checks IAP and Restore on a device.
-7. Derive App Privacy from the SDKs linked (`store lint`: declared ⊇ collected). With `com.joydle.firebase` the games declare Device ID, Coarse Location, Product Interaction and Crash Data, plus Purchase History where there is an IAP: not linked, no tracking, no tracking prompt (the package turns off the advertising identifier). A person enters them.
+7. Derive App Privacy from the SDKs linked (`store lint`: declared ⊇ collected). With Firebase Analytics and Crashlytics the games declare Device ID, Coarse Location, Product Interaction and Crash Data, plus Purchase History where there is an IAP: not linked, no tracking, no tracking prompt (with the advertising identifier turned off). A person enters them.
 8. Pick the icon small. 1024×1024 RGB, no alpha (check with `sips`); one big idea, judged at 60 and 40 px against competitors. Make candidates with `npx @funpixel/tools gen image "<the idea>" --size 1024x1024 --out design/icons/` (metered, after `npx @funpixel/tools login`; a generator's default may be 9:16); the pick goes to `Assets/_Game/Art/Icon/app_icon.png`.
 9. Compose 5–8 screenshots at 6.9": 1320×2868 portrait or 2868×1320 landscape, from real captures taken at game-state markers in the log. `store_shots` passes when sizes are exact, the real HUD is visible, no tutorial UI shows and each caption is true of its frame. How capture bursts are taken: not in the report.
 10. Validate any video before it is shared or uploaded. `recording_check`: 0 frame gaps over 34 ms, audio ≥ 44.1 kHz. `preview_validate`: 15–30 s, ≤ 30 fps, bt709 tags, square pixels, AAC ≤ 256 kb/s; after upload, `previewImage.width > 0`.
@@ -47,12 +44,12 @@ Rejections by guideline, what 1.0 sold and the ad plan: `purchases-and-review.md
 
 ## Worked example
 
-Pocket Crew's App Preview: 25 s, 1920×886, cuts about every 1.5 s. App Store Connect showed a red "!" on it twice. The causes were an sRGB colour tag where bt709 is required, non-square pixels, and audio at 263 kb/s against the 256 cap. Setting the poster time through the API then made the preview image 0×0. What held: validate with `ffprobe`, upload, read back `previewImage.width > 0`, leave the poster frame alone.
+One game's App Preview: 25 s, 1920×886, cuts about every 1.5 s. App Store Connect showed a red "!" on it twice. The causes were an sRGB colour tag where bt709 is required, non-square pixels, and audio at 263 kb/s against the 256 cap. Setting the poster time through the API then made the preview image 0×0. What held: validate with `ffprobe`, upload, read back `previewImage.width > 0`, leave the poster frame alone.
 
 ## Common mistakes
 
-- Resubmitting fast instead of linting first: Dead Letter, Scrap Riot and Noodle Nights each went back to "Waiting for Review" for over a week.
-- Icons by prompt alone: Dawg Ball spent $21.46 over 7 rounds before a pick, round one at 720×1280 from the 9:16 default, no competitor benchmark until round 4. The Hot Gates' bake-off cost $5.95.
+- Resubmitting fast instead of linting first: three games each went back to "Waiting for Review" for over a week.
+- Icons by prompt alone: one game spent $21.46 over 7 rounds before a pick, round one at 720×1280 from the 9:16 default, no competitor benchmark until round 4. Another's bake-off cost $5.95.
 - A Restore label whose hit area covers the shop card: taps on products showed "Restoring purchases" in four games.
 - "Data Not Collected" left in the docs after Firebase shipped in all games.
-- A Simulator recording shown before it was measured: The Hot Gates' `simctl recordVideo` clip had 19 gaps up to 0.85 s and 24 kHz audio.
+- A Simulator recording shown before it was measured: one game's `simctl recordVideo` clip had 19 gaps up to 0.85 s and 24 kHz audio.

package/plugins/claude/skills/unity-game/SKILL.md

@@ -1,20 +1,17 @@
 ---
 name: unity-game
-description: Use when making a game in Unity (new from the starter, a port of a web game, a clone of a sibling), measuring or improving its frame time, memory, battery, load time or size, or running several agents on Unity projects on one Mac. Covers the studio's packages, rules in C# tested outside the Editor, settings by script, launch flags, parity, player-side probes and Simulator leases.
+description: Use when making a game in Unity (new from the starter, a port of a web game, a clone of a sibling), measuring or improving its frame time, memory, battery, load time or size, or running several agents on Unity projects on one Mac. Covers rules in C# tested outside the Editor, settings by script, launch flags, parity, player-side probes and Simulator leases.
 ---
 
 # Making a game in Unity
 
 Games rebuilt from web builds played end to end 2 hours after kickoff. What goes wrong is silent:
 all four first games reached TestFlight with no sound, cloned projects inherited a sibling's
-settings, and Simulator timings measured the host. This skill starts a game on the studio's
-packages when it uses them, makes the rest a failed check at scaffold, and routes the measuring and
-the shared Mac to their references.
+settings, and Simulator timings measured the host. This skill makes each of these a failed check
+at scaffold, and routes the measuring and the shared Mac to their references.
 
 ## Tools
 
-- The studio's packages, `com.joydle.core` and `com.joydle.firebase`, are optional (Floe Jam uses
-  neither): adding them and what each settles, `references/studio-packages.md`.
 - `funtools gen <kind> "…" --unity .` (after `funtools login`): pictures, sounds, music and models
   into `Assets/_Game/Generated/` with import settings, metered; never a provider call with a `.env` key.
 - `funtools unity run -- -nographics -executeMethod Setup.Configure`: your editor script, queued
@@ -43,41 +40,38 @@ the shared Mac to their references.
    landscape), devices (a phone game: iPhone only for 1.0, oldest iPhone 11 at a locked
    60 fps), the business model (skill `fp:store`, `references/money.md`), a content
    minimum, which visual elements carry rules, and the name on the App Store. Targets: iOS
-   first, Android (`BuildTools.Android`); WebGL without Firebase, whose C++ SDK has no web build
-   (Floe Jam: `unity/build.sh webgl`); Mac and Windows by the game's own build methods (Knockout Lap).
-3. Add what the game uses: the studio packages if any, Input System 1.20.0, uGUI 2.6.0, URP 17.6.0
-   unless it stays built-in (Floe Jam), glTFast 6.20.0 for 3D ("latest" was an
+   first, Android; WebGL without Firebase, whose C++ SDK has no web build; Mac and Windows by the
+   game's own build methods.
+3. Add what the game uses: Input System 1.20.0, uGUI 2.6.0, URP 17.6.0
+   unless it stays built-in, glTFast 6.20.0 for 3D ("latest" was an
    experimental 7.0). Remove collab-proxy, learn and visual scripting. Import TMP Essential
    Resources.
 4. Lay out `Assets/_Game/` as `Scripts/Core`, `Scripts/Game`, `Editor`, `Tests/Editor` (or
    `Tests/EditMode`), `Art`, `Fonts`, `Scenes`, plus `design/`, `store/` and a README. The rules go
    in `Scripts/Core`, an asmdef with `noEngineReferences: true`; the rest stays in Assembly-CSharp
-   (the monorepo games) or splits into Game, View and World asmdefs (Knockout Lap). Add `CoreTests~`
+   (the monorepo games) or splits into Game, View and World asmdefs. Add `CoreTests~`
    for `dotnet test` and un-ignore its project (`!**/CoreTests~/*.csproj`): the root `.gitignore`
-   drops every `*.csproj`. Play Mode tests get an asmdef of their own (Floe Jam's `Tests/Play`).
+   drops every `*.csproj`. Play Mode tests get an asmdef of their own (`Tests/Play`).
 5. Generate the one scene from code: a camera and one `GameDriver` (input, sim, each event to every
-   presenter once, render), so agents rebuild it headless and never conflict on a scene. `Sfx.Create(music)`
-   adds the AudioListener a code-made camera lacks; hold `audio_runtime`: 1
+   presenter once, render), so agents rebuild it headless and never conflict on a scene. Add the
+   AudioListener a code-made camera lacks; hold `audio_runtime`: 1
    listener, 48 kHz, music within 3 s (of the splash's end, if one plays).
-6. Set every setting in `Setup.Configure`: `ProjectConfig.ApplyIOS(name, bundleId, "1.0.0",
-   landscape)` and `ApplyAndroid(bundleId)` with the package (else set what they set), then colour
+6. Set every setting in `Setup.Configure`: company name, bundle id, version, IL2CPP, a fixed
+   orientation, Unity splash off, the Android API levels and ARM64, then colour
    space, 48 kHz audio, render scale 1, ProMotion, accelerometer off, physics auto-simulation off with
-   your own sim, and `ProjectSettings/JoydleLz4hc.txt` for LZ4HC. Build through it. Keep a per-game manifest
+   your own sim, and LZ4HC compression. Build through it. Keep a per-game manifest
    (orientation, bundle id, colour space, a unique productGUID, audio on, render scale) to diff against.
 7. Register the bundle id, the profile and (with Firebase) one Firebase project per game at scaffold; agents may,
    with approval (who does what: fp:store).
 8. Add dev-only launch flags for every screen and state, `-tour`, `-smoke` (plays to an ending, writes
-   `smoke.txt`) and the probe (`unity probe install`), read through one wrapper over `LaunchArgs.Get()` that returns nothing
-   unless `Debug.isDebugBuild` (on iOS the package does not gate them), with `Telemetry.Muted` set
+   `smoke.txt`) and the probe (`unity probe install`), read through one wrapper that returns nothing
+   unless `Debug.isDebugBuild`, with analytics muted
    while a flag is on. Keep flag names apart from save keys: `-coins` shadows the PlayerPrefs key
    `coins`. Judged frames: `references/traps.md`.
-9. With the package, wire its pieces switched off: `IapService` with the catalog (Buy and Restore in
-   Settings from the first build), `Ads.CreateDefault` (none in release), a `.storekit` file for Xcode runs.
-10. Never make a splash or a "Funpixel presents" card. With a studio splash package (today Joydle
-    Core's `JoydleSplash`), wire it on day one: the opt-in asset `Assets/_Game/Resources/JoydleSplashOn.txt`;
-    it plays before the first scene holding the game's audio, skipped in the Editor and on any `-flag`
-    (`-splash` forces it); title music waits on `JoydleSplash.Playing`; credits name that studio.
-11. Plug content in through a registry, so parallel agents add files: Pocket Crew's branches
+9. Wire purchases and ads switched off: the catalog with Buy and Restore in
+   Settings from the first build, no ads in release, a `.storekit` file for Xcode runs.
+10. Never make a splash or a "Funpixel presents" card.
+11. Plug content in through a registry, so parallel agents add files: one game's branches
     without one cost 43 hand-resolved merge hunks.
 12. Give each agent its own worktree and Simulator; one Editor per project, closed by its
     opener (`references/agent-ops.md`).
@@ -94,17 +88,16 @@ Other day-one rules:
 
 ## Worked example
 
-Koi Out, a new 2D puzzle game (URP 2D, Linear, portrait):
+A new 2D puzzle game (URP 2D, Linear, portrait):
 Playable on the Simulator in about 1.5 hours; 600 levels by reverse removal, solvable by
-construction, 29 tests. The first TestFlight on day 1 was silent (no AudioListener, fixed once in
-`Sfx`), and its `-setcoins` flag worked in release builds (no dev gate, step 8).
+construction, 29 tests. The first TestFlight on day 1 was silent (no AudioListener), and its `-setcoins` flag worked in release builds (no dev gate, step 8).
 
 ## Common mistakes
 
-- Cloning a sibling: Dawg Ball and Pocket Crew launched in portrait, Dead Letter inherited
-  `m_DisableAudio: 1`, and Particle Rush still carries The Hot Gates' `.gitattributes` paths.
-- URP `m_RenderScale: 0.8`: Dawg Ball drew soft.
-- Writing again what the packages give, or patching one game's copy.
-- Ungated debug flags: `-lgr-unlocked` granted paid floors in Scrap Riot's release build.
-- Rebuilding a web game from its design doc instead of its shipped code: Scrap Riot's improvised
+- Cloning a sibling: two games launched in portrait, one inherited
+  `m_DisableAudio: 1`, and one still carries a sibling's `.gitattributes` paths.
+- URP `m_RenderScale: 0.8`: one game drew soft.
+- Patching one game's copy of shared code instead of the shared package.
+- Ungated debug flags: an unlock flag granted paid floors in one game's release build.
+- Rebuilding a web game from its design doc instead of its shipped code: one port's improvised
   fixes were torn out (`references/from-a-web-game.md`).

package/plugins/claude/skills/unity-game/references/agent-ops.md

@@ -1,6 +1,6 @@
 # Several agents on one Mac
 
-Unity allows one Editor per project and every game here was built on one Mac with no CI, so parallel agents share a lock, the Simulators and the host's load. When they also shared a Simulator or scratch folder, runs were invalidated. When liveness meant "the process exists", a performance agent on The Hot Gates sat idle about 8 hours overnight. This skill gives each agent its own resources and makes progress measurable.
+Unity allows one Editor per project and every game here was built on one Mac with no CI, so parallel agents share a lock, the Simulators and the host's load. When they also shared a Simulator or scratch folder, runs were invalidated. When liveness meant "the process exists", a performance agent on one game sat idle about 8 hours overnight. This skill gives each agent its own resources and makes progress measurable.
 
 ## Tools
 
@@ -26,29 +26,29 @@ build: `handing-off.md`.
 
 1. Claim four things before the first build: a worktree, a leased Simulator, a remote-play port and a scratch folder. `sim_isolation` passes when the Simulator id, port and folder are unique per agent.
 2. Send every batch run through `funtools unity run`, and run the engine-free tests between them. One batch run (1–2 min) per project serialised parallel agents, and a half-written file broke other agents' compiles until each had its own build folder.
-3. One Editor per project, opened by the agent that needs it (`--open`, with the bridge) and closed by it (`funtools unity editor close`), never by another. With none open, batch through the queue. MCP for Unity got 0 calls in 29 sessions under a no-Editor rule: no `.mcp.json`, `settings.local.json` disables it, only Koi Out lists `com.coplaydev.unity-mcp` (unpinned, `#main`).
+3. One Editor per project, opened by the agent that needs it (`--open`, with the bridge) and closed by it (`funtools unity editor close`), never by another. With none open, batch through the queue. MCP for Unity got 0 calls in 29 sessions under a no-Editor rule: no `.mcp.json`, `settings.local.json` disables it, only one game lists `com.coplaydev.unity-mcp` (unpinned, `#main`).
 4. Run anything over a minute in the background. Background agents stalled on the 600 s stream watchdog during foreground Unity and Xcode steps. Read the whole output; `| tail` hid a failing compile check and a commit went through.
 5. Judge a running agent by progress (`agent_liveness`): files under the game changed in the last 30 minutes, or a Unity or `xcodebuild` process at work.
 6. Expect host load to change results. Parallel sessions caused a Burst timeout in one export and slowed another session's 363-test suite from 10–15 to about 27 minutes, so read export logs before trusting a build made under load.
 7. Stage by path. A broad commit glob staged another session's 18 files. Keep `git stash pop` and pattern `pkill` out of agent scripts; both hit work that was not the agent's (see Common mistakes).
 8. Commit and push as work lands, and keep nothing in scratch or /tmp. `lfs_audit` passes at 0 tracked binaries over 500 KB outside LFS, 0 untracked paid art and 0 unpushed LFS objects; about 840 MB of paid generations lived on one Mac.
 9. Publish status at milestones, merged, with the session id on every entry: a network drop killed three sessions and nobody knew which was which. The owner asked "where we are? what's left? how long?" every 20–60 minutes in long sessions; answer from a tracker updated by tools (step, status, who, clock time), not memory.
-10. Sync before saying it is synced. The owner asked "did you sync to remote?" on Dawg Ball, The Hot Gates and Scrap Riot. Push after green checks, rewrite status sections from repo state, and run a docs-freshness check at the end of each task.
+10. Sync before saying it is synced. The owner asked "did you sync to remote?" on three games. Push after green checks, rewrite status sections from repo state, and run a docs-freshness check at the end of each task.
 11. Show nothing unverified: `ffprobe` gaps = 0 before sharing a video, and read a published page back. After a change, show the real draw path with the real HUD at full resolution, the player log's exception count, before and after numbers, and the all-screens sheet for UI work; never the Scene view.
-12. After each change, sweep for leftovers: a workaround, a dead flag, a comment that says `(was …`, a date or "the owner". The owner on Dawg Ball: "no workarounds, remove all leftovers". Never delete an "unused" asset unasked: an agent deleted 20 files the game loads by name.
-13. End a report with at most 3 numbered decisions, each with options, a default, and a picture when it is visual. The owner on Dawg Ball: "What actually you're asking me now?"
+12. After each change, sweep for leftovers: a workaround, a dead flag, a comment that says `(was …`, a date or "the owner". The owner: "no workarounds, remove all leftovers". Never delete an "unused" asset unasked: an agent deleted 20 files the game loads by name.
+13. End a report with at most 3 numbered decisions, each with options, a default, and a picture when it is visual. The owner: "What actually you're asking me now?"
 14. At hand-back, stop what you started (`agent_hygiene`): `funtools sim release` each lease, then your Unity batch processes, child processes and monitors, and only your own. Never quit Simulator.app or run `xcrun simctl shutdown all`.
 
 ## Worked example
 
-The Hot Gates performance pass, overnight. The agent stalled twice on the stream watchdog and then sat about 8 hours idle; its login had expired. The heartbeat only checked that the agent existed. The probe that would have caught it is `find -mmin -30` under the game folder plus `pgrep Unity|xcodebuild`: no changed file and no build process for 30 minutes means stalled.
+One game's performance pass, overnight. The agent stalled twice on the stream watchdog and then sat about 8 hours idle; its login had expired. The heartbeat only checked that the agent existed. The probe that would have caught it is `find -mmin -30` under the game folder plus `pgrep Unity|xcodebuild`: no changed file and no build process for 30 minutes means stalled.
 
 ## Common mistakes
 
-- Sharing a Simulator or scratch folder (Scrap Riot, Pocket Crew): invalidated runs, a tap in another agent's app, an install that killed the coordinator's remote-play session; quitting Simulator.app or `shutdown all` killed other agents' runs three times (Knockout Lap).
+- Sharing a Simulator or scratch folder: invalidated runs, a tap in another agent's app, an install that killed the coordinator's remote-play session; quitting Simulator.app or `shutdown all` killed other agents' runs three times.
 - A repo-wide status Stop hook (studio-wide): it forced a publish on every turn, fired on other sessions' files, hit the 200/day publish cap; the agent could not edit its own settings.
-- `git stash pop` in a script (Dead Letter seam fix, 30 Sep): an unquoted zsh `$FILES` stashed nothing, and the pop applied and dropped a stash that was not the agent's.
+- `git stash pop` in a script (a seam fix, 30 Sep): an unquoted zsh `$FILES` stashed nothing, and the pop applied and dropped a stash that was not the agent's.
 - `pkill -f` by pattern (Atlas session, 4 Oct): it killed other agents' runs.
-- Uncommitted work: The Hot Gates port lived 11+ hours uncommitted, and 79 files of a size pass were nearly lost.
+- Uncommitted work: one port lived 11+ hours uncommitted, and 79 files of a size pass were nearly lost.
 - Infrastructure in /tmp: a restart wiped a Caddy config and build 22 shipped pointing at a dead tunnel.
 - Simulators left running: 5 at about 200% CPU, and a stale app ran 8.8 hours.

package/plugins/claude/skills/unity-game/references/fixes.md

@@ -5,36 +5,36 @@ From the Unity field report, sections 3 (lighting and materials), 6 (post-proces
 
 ## Fixes, before and after
 
-| Fix | Before → after | Game |
-|---|---|---|
-| Split GLBs, ASTC for model textures | data 315 → 61 MB (app 386 → 106 MB with the size settings) | Noodle Nights |
-| Size settings (stripping High, engine stripping, IL2CPP OptimizeSize) | engine 66–69 → 40–42 MB | all |
-| LZ4HC player data (about 25 minutes of work) | 126 → 94 MB installed | The Hot Gates |
-| Shaders, pipeline states and the Vase grab warmed on the first frames | worst frame of the tide 249 → 18.6 ms | The Hot Gates |
-| A throwaway run prewarmed behind the title | Play tap 87 → 1.9 ms | The Hot Gates |
-| Glyph warm-up | 183–266 ms (Dawg Ball), 50–270 ms (Pocket Crew) → 17–20 ms first use | Dawg Ball, Pocket Crew |
-| No world drawn behind opaque menus; menus at 30 fps | 759 M → 0 3D px/s; CPU 94 → 32 ms/s; GC 52 → 2.4 KB/s | Dawg Ball |
-| A blur that stopped re-rendering the world (it did 20 times a second) | about a third of all draws gone | Pocket Crew |
-| Instanced sets culled, cheap shadow proxies, far LODs | World 1 376–448k → 116–224k triangles | Pocket Crew |
-| The next level built while a menu is up; every level warmed | 82–99 ms (and 398 ms) → under 34 ms | Pocket Crew |
-| A quality governor that judges the median of 90 frames, not the mean | one hitch no longer drops a resolution rung | The Hot Gates |
+| Fix | Before → after |
+|---|---|
+| Split GLBs, ASTC for model textures | data 315 → 61 MB (app 386 → 106 MB with the size settings) |
+| Size settings (stripping High, engine stripping, IL2CPP OptimizeSize, every game) | engine 66–69 → 40–42 MB |
+| LZ4HC player data (about 25 minutes of work) | 126 → 94 MB installed |
+| Shaders, pipeline states and the Vase grab warmed on the first frames | worst frame of the tide 249 → 18.6 ms |
+| A throwaway run prewarmed behind the title | Play tap 87 → 1.9 ms |
+| Glyph warm-up | 183–266 ms (one game), 50–270 ms (another) → 17–20 ms first use |
+| No world drawn behind opaque menus; menus at 30 fps | 759 M → 0 3D px/s; CPU 94 → 32 ms/s; GC 52 → 2.4 KB/s |
+| A blur that stopped re-rendering the world (it did 20 times a second) | about a third of all draws gone |
+| Instanced sets culled, cheap shadow proxies, far LODs | World 1 376–448k → 116–224k triangles |
+| The next level built while a menu is up; every level warmed | 82–99 ms (and 398 ms) → under 34 ms |
+| A quality governor that judges the median of 90 frames, not the mean | one hitch no longer drops a resolution rung |
 
 ## The phone pipeline the games used
 
 - No light probes or lightmaps in any game; mostly unlit or emissive materials.
-- The Hot Gates' phone pipeline: no realtime shadows, MSAA 4×, HDR off, SRP Batcher on.
-  Post-processing is off on The Hot Gates and Dawg Ball.
-- Noodle Nights keeps bloom and ACES tone mapping in a night volume: an emissive strength of 3.5 blew
+- One game's phone pipeline: no realtime shadows, MSAA 4×, HDR off, SRP Batcher on.
+  Post-processing is off on it and on another.
+- One game keeps bloom and ACES tone mapping in a night volume: an emissive strength of 3.5 blew
   the bloom out (down to 2.2), and the HDR glow washed out the price text.
-- Scrap Riot's URP bloom and depth-of-field shaders were found stripped from its builds: check a
+- One game's URP bloom and depth-of-field shaders were found stripped from its builds: check a
   post effect in the player build, not the Editor.
-- Pocket Crew carries three.js's physical shading over in HLSL with quality tiers that drop shadows and
+- One port carries three.js's physical shading over in HLSL with quality tiers that drop shadows and
   render scale on a hot or Low Power phone. Shed load through render scale, never MSAA (step 7).
 - No millisecond cost of any post effect was measured on a device.
 
 ## Load
 
-Boot to title 0.32 s (The Hot Gates); title interactive in 0.22 s and floor 1 playable 3.0 s after
-launch (Scrap Riot). About 14 MB of textures still load synchronously at boot in Scrap Riot, which
-uses no Addressables (Gallery Heist's views branch loads each room through them). A lobby frame of 50 ms went once each screen's textures were preloaded
+Boot to title 0.32 s (one game); title interactive in 0.22 s and floor 1 playable 3.0 s after
+launch (another). About 14 MB of textures still load synchronously at boot in the second, which
+uses no Addressables (a third game's views branch loads each room through them). A lobby frame of 50 ms went once each screen's textures were preloaded
 while loading. Memory measured 117–174 MB in use; there is no memory budget yet.

package/plugins/claude/skills/unity-game/references/from-a-web-game.md

@@ -1,9 +1,9 @@
 # A Unity game from a web game
 
 Five of the nine Unity games started as Funpixel web games (Pixi or three.js) and were rebuilt in
-Unity. That rebuild is hours of work when it has a fixed contract. The Hot Gates and Pocket Crew
+Unity. That rebuild is hours of work when it has a fixed contract. Two of them
 each had a bit-exact C# core checked against golden traces recorded from the web sim, and both
-played end to end on the Simulator about 2 hours after kickoff. Scrap Riot had a moving spec: it
+played end to end on the Simulator about 2 hours after kickoff. A third had a moving spec: it
 logged 85 entries in its iOS phase, agents built seven fixes from one-line descriptions, and their
 versions were torn out when the web game's author shipped different code. This page keeps the
 rebuild on the contract: shipped web code, goldens and `parity.md`. Field report sections 0, 1, 2
@@ -35,13 +35,13 @@ and 10, and its dead ends.
    the web sim under node, and capture reference frames of the web game at phone sizes. The
    project adds `design/web-ref` and `parity.md`.
 2. Fix the content minimum before the rebuild. The owner asked for "at least 5 different levels":
-   Dead Letter grew from 1 letter to 5 in about 7 hours, Pocket Crew from 4 levels to 26.
+   one game grew from 1 letter to 5 in about 7 hours, another from 4 levels to 26.
 3. Fix colour space on day one to match the source renderer. Pixi and three.js without a linear
-   composer blend in gamma: Dead Letter, Scrap Riot, Hot Gates and Dawg Ball are Gamma. Pocket
-   Crew, whose web build used a linear composer, stays Linear.
+   composer blend in gamma: four of the ports are Gamma. The one whose web build used a linear
+   composer stays Linear.
 4. Rebuild the Core first, in an asmdef with `noEngineReferences: true`. Copy web numbers verbatim
-   into `Scripts/Core/Config.cs`, carry every web test over 1:1 to NUnit (Scrap Riot 98 of 98
-   cases), and load the web's level JSON from `Resources/Data`. Dead Letter's core had 229 tests
+   into `Scripts/Core/Config.cs`, carry every web test over 1:1 to NUnit (one port: 98 of 98
+   cases), and load the web's level JSON from `Resources/Data`. One port's core had 229 tests
    about 50 minutes after kickoff.
 5. Apply the determinism kit while writing it, because C# and V8 disagree silently:
 
@@ -58,7 +58,7 @@ and 10, and its dead ends.
    `DateTime.Now` outside the shims; until it exists, search for them.
 6. Replay the goldens. Pass is 0 diffs at zero tolerance, and the same hash under IL2CPP. Where the
    web's own math is not reproducible, bit-exact is not the rule: V8's libm (fdlibm `sin`, `log10`) is
-   compiled with fused multiply-adds on arm64, which C# cannot match bit for bit. Particle Rush (Oct 2026)
+   compiled with fused multiply-adds on arm64, which C# cannot match bit for bit. One port (Oct 2026)
    compares at a relative tolerance of 1e-9 with identical events, frames and results (80 runs), and
    records it as a `parity.md` row.
 7. Record every deviation as a `parity.md` row and a default-off `Rules` flag, then check that
@@ -68,10 +68,10 @@ and 10, and its dead ends.
 
    | Reuse | What |
    |---|---|
-   | As it is | sim rules, tests, tuning, level JSON (Pocket Crew: 1,515 numbers bit-identical), save formats (33 Scrap Riot fixtures loaded byte-identical), sprite art, audio clips, key art |
+   | As it is | sim rules, tests, tuning, level JSON (one port: 1,515 numbers bit-identical), save formats (33 fixtures of one port loaded byte-identical), sprite art, audio clips, key art |
    | After conversion | WebP to PNG; WOFF2 to TTF with full fonts; meshopt and WebP GLBs decoded; loops rebuilt as OGG at exact sample counts; Web Audio synths re-rendered offline in C# |
    | Redo | every view, HUD and menu (UGUI in code), input, haptics, app lifecycle, shaders, store art, icon, the IAP and economy layer |
-   | No path yet | online play: the kit's relay client is the JavaScript SDK (`fp:game-spine`), with no C# client. The one online Unity game, Dawg Ball (branch `dawg-ball/online`), vendors LiteNetLib with its own `Server~` and `Api~` matchmaker |
+   | No path yet | online play: the kit's relay client is the JavaScript SDK (`fp:game-spine`), with no C# client. The one online Unity game vendors LiteNetLib with its own `Server~` and `Api~` matchmaker |
 
 9. Build the views in parallel behind the written APIs. One frame owner, `GameDriver`, runs
    input, `sim.Update(dt)`, each `SimEvent` to every presenter, then `Render(alpha)`, so every
@@ -82,7 +82,7 @@ and 10, and its dead ends.
 
 ## Worked example
 
-The Hot Gates, from three.js (about 20,000 lines) to URP 3D, Gamma, portrait:
+A port from three.js (about 20,000 lines) to URP 3D, Gamma, portrait:
 1. A bit-exact core checked against goldens: seed 1 ended on the web's hash 1936916133.
 2. 358 core tests run with `dotnet test`.
 3. The web's 41 procedural audio cues were re-rendered offline in C#, correlation 0.999998
@@ -92,17 +92,17 @@ The Hot Gates, from three.js (about 20,000 lines) to URP 3D, Gamma, portrait:
 
 ## Common mistakes
 
-- Improvising fixes: Scrap Riot's agents built 8 props, a chain shockwave, a countdown, a
+- Improvising fixes: one port's agents built 8 props, a chain shockwave, a countdown, a
   recolour and a 4 s PA delay that were torn out, and 3 of 6 earlier fixes were never re-audited
   and still differed from the web.
 - `Math.Round` in the Core: banker's rounding drew 2 sparks where the web drew 3 (game not in the
   report).
-- Tidying art that encodes a rule: an agent "cleaned up" Dawg Ball's goal sill, which held the
+- Tidying art that encodes a rule: an agent "cleaned up" one game's goal sill, which held the
   balance up.
-- Linear colour space on a Pixi game: overlays about 2× too strong in Dead Letter until it
+- Linear colour space on a Pixi game: overlays about 2× too strong in one game until it
   switched to Gamma.
 - Web MP3s as loops: they ran 1,245–1,997 samples long.
-- Importing a web GLB undecoded: glTFast imports it as nothing with no error; Dawg Ball's 12
+- Importing a web GLB undecoded: glTFast imports it as nothing with no error; one game's 12
   heads "did not import at all".
-- A UI with its own catch-up loop: Dead Letter's seal pick never reached audio or FX.
-- An ignored `.csproj`: Dead Letter's tests could not run from a fresh clone.
+- A UI with its own catch-up loop: One game's seal pick never reached audio or FX.
+- An ignored `.csproj`: One game's tests could not run from a fresh clone.

package/plugins/claude/skills/unity-game/references/handing-off.md

@@ -18,8 +18,8 @@ From the Unity field report, section 14 (agents making Unity games) and the owne
 On what looks fine in its own captures: no sound (captures are silent), settings inherited from a
 cloned project, UI that overflows only at the owner's phone shape, keyboard wording, a level that
 breaks only when reached from the one before, and art that passes every gameplay gate while looking
-like grey blockout (Pocket Crew's Worlds 3 and 4). Then on taste: it adds decoration the owner
-removes (5 reverts in 24 hours on Dawg Ball) and grades its own art favourably. The answer to both is
+like grey blockout (one game's Worlds 3 and 4). Then on taste: it adds decoration the owner
+removes (5 reverts in 24 hours on one game) and grades its own art favourably. The answer to both is
 evidence a person can judge: the real frame at full size against the target and the competitors.
 
 ## What the owner asked for again and again
@@ -28,7 +28,7 @@ evidence a person can judge: the real frame at full size against the target and
 |---|---|
 | "where we are? what's left? how long?" | a tracker updated by tools (step, status, who, clock time), with the session id on every entry |
 | "did you sync to remote?" | push after green checks; rewrite status sections from repo state; a docs-freshness check at the end of each task |
-| "add joydle splash to dawg ball as we did for other games" | carry every studio standard from the start (the studio's packages, `fp:unity-game`) and check parity with the sibling games: splash, store fields, Restore placement |
+| "…as we did for other games" | carry every studio standard from the start and check parity with the sibling games: store fields, Restore placement |
 | "no workarounds, remove all leftovers" | a leftover sweep and a comment lint after each change |
 | "What actually you're asking me now?" | a report that ends with at most 3 numbered decisions, each with options, a default and a picture when it is visual |
 | "go do it by yourself" (website, Firebase) | the list of what an agent may do (bundle id, profile, Firebase, an upload with approval) against what only a person does (app record, App Privacy, agreements, the first purchase tick, Submit) |
@@ -36,7 +36,7 @@ evidence a person can judge: the real frame at full size against the target and
 ## What earns trust in a build an agent made
 
 The checks green, the launch with no flags clean, the smoke run reaching an ending on a stripped
-build, the archive pre-flight passed, and the owner's own 15-minute session on a phone. Pocket Crew's
+build, the archive pre-flight passed, and the owner's own 15-minute session on a phone. One game's
 build 1 was "mostly liked" and still unshippable: a production gate (fresh install, every level
 through the real flows, 7 kill-and-relaunch cycles, every setting persisted) found 4 more bugs behind
 1,377 green tests. A hand-off with a dirty worktree is refused: commit by path first.

package/plugins/claude/skills/unity-game/references/performance.md

@@ -4,10 +4,6 @@ This skill turns a performance worry into a number measured in the player, befor
 
 ## Tools
 
-- The studio's `com.joydle.core` (`fp:unity-game`, `studio-packages.md`): every
-  `BuildTools` build applies the size settings (stripping High, engine stripping, IL2CPP OptimizeSize);
-  `ProjectSettings/JoydleLz4hc.txt` turns on LZ4HC; `JoydleSplash` holds on black until the first
-  scene has loaded and 10 smooth frames pass.
 - `npx @funpixel/tools unity probe --target mac|sim --path path.json`: the kit's in-player probe
   (`com.funpixel.probe`, added by `unity probe install`; development builds only). It builds or reuses
   the player through the Unity queue, plays the path, reads `ProfilerRecorder` per frame (frame, main,
@@ -29,10 +25,10 @@ This skill turns a performance worry into a number measured in the player, befor
 | Frame rate | 60 fps locked on iPhone 11 (A13); 120 Hz on ProMotion only when cool; menus 30 fps | |
 | Frames | first entry to a screen or level under 34 ms; none over 20 ms after warm-up; p99 at most 17.5 ms | `unity probe` |
 | GC | 0 B per warm sim step or quiet frame | `alloc_quiet` |
-| Draws, triangles | 120 and 250k per view (Pocket Crew, a 3D platformer) | |
+| Draws, triangles | 120 and 250k per view (a 3D platformer) | |
 | Behind a full-screen menu | 0 world cameras or passes; 1 pass in play | `invisible_work` |
 | Look | `RenderSettings` and shared materials identical before and after each level and warm-up | `look_leak` |
-| Unpacked `.app` | 2D 80 MB, 3D 100 MB, engine 45 MB, at most 2 MiB unexplained growth per build (proposed; Dead Letter, 2D, is 133 MB) | `size_budget` |
+| Unpacked `.app` | 2D 80 MB, 3D 100 MB, engine 45 MB, at most 2 MiB unexplained growth per build (proposed; one 2D game is 133 MB) | `size_budget` |
 | `Resources/` | 0 bytes of test-only or Editor-only files | `resources_hygiene` |
 | Memory | 117–174 MB was measured; a budget is not in the report | |
 
@@ -40,24 +36,24 @@ Per tier (phone, tablet, Mac): `unity probe --tier`, from `probe.md`.
 
 ## Procedure
 
-1. Measure in a player build, with `unity probe`. Editor draws read 134–151 against 74–114 in the player. Under URP draws read 0 in some players (Particle Rush), so read SetPass calls too.
+1. Measure in a player build, with `unity probe`. Editor draws read 134–151 against 74–114 in the player. Under URP draws read 0 in some players, so read SetPass calls too.
 2. Attribute each slow frame before fixing it: game work, GC, the host Mac, or your own screenshot. A `ScreenCapture` costs 100–130 ms, and it and a Mac at load 36 were blamed on the game twice; game work in those frames was 0.4–0.7 ms. The probe reports hitches with their own work and skips 4 frames after each capture.
 3. Fix first-use stutters. Put every level id in the warm queue; warm glyphs, the first level's shaders (a ShaderVariantCollection, never `Shader.WarmupAllShaders`) and sounds behind the title; build the next level while a menu is up. Then run `look_leak`, since a warm-up can leave global state changed.
 4. Turn off invisible work: no world drawn behind opaque menus, and menus at 30 fps.
 5. Take allocations to 0 B. Use flat `struct` events in a reused list, no LINQ, closures or string building per frame, and rebuild text only on change. Measure in a release player, since 30–200 B per frame in the dev player is engine-side.
-6. Load: hold the splash on black until the scene is loaded and 10 smooth frames pass (1 s minimum, 3 s cap; `JoydleSplash` does). Async-preload each screen's textures while loading, and prewarm a throwaway run behind the title: The Hot Gates' Play tap went from 87 to 1.9 ms.
-7. Heat and battery: poll thermal state and Low Power Mode every 2 s. Hot or Low Power drops render scale from 0.83 to 0.66; critical caps matches at 30 fps; 120 Hz only when cool, falling back with a doubling back-off. Keep MSAA fixed, because changing it at runtime recompiled every pipeline state in Pocket Crew (a 1.5 s frame). Turn off Unity's own thermal frame-rate adjust: two controllers on one knob.
+6. Load: hold the splash on black until the scene is loaded and 10 smooth frames pass (1 s minimum, 3 s cap). Async-preload each screen's textures while loading, and prewarm a throwaway run behind the title: one game's Play tap went from 87 to 1.9 ms.
+7. Heat and battery: poll thermal state and Low Power Mode every 2 s. Hot or Low Power drops render scale from 0.83 to 0.66; critical caps matches at 30 fps; 120 Hz only when cool, falling back with a doubling back-off. Keep MSAA fixed, because changing it at runtime recompiled every pipeline state in one game (a 1.5 s frame). Turn off Unity's own thermal frame-rate adjust: two controllers on one knob.
 8. Size: measure the unpacked `.app` from the archive, with a delta against the last build. Apply the size settings (stripping High, engine stripping, IL2CPP OptimizeSize), then LZ4HC. Keep test files out of `Resources/`: the Unity test runner drops `PerformanceTestRun*.json` there, and it ships.
 9. Report every claim as before and after. The owner's direction ("ensure the performance is top") became `frame_budget` and `invisible_work` in every round.
    The fixes that gave the most, each with its before and after: `fixes.md`.
 
 ## Worked example
 
-The Hot Gates, the whole seed-7 run. Over 17,246 frames, frames over 34 ms went from 17 to 2 and the worst frame from 98.4 to 19.0 ms; p99 was 18.2 ms. Warming shaders, pipeline states and the Vase grab on the first frames took the worst frame of the "tide" (a moment the report does not define) from 249 to 18.6 ms. The last 48 ms hitch was a missing glyph, and the last allocation was a "+N" badge string; the game holds 0 B over 600 frames. The quality governor now judges the median of 90 frames, so one hitch no longer drops a resolution rung.
+A port from three.js, the whole seed-7 run. Over 17,246 frames, frames over 34 ms went from 17 to 2 and the worst frame from 98.4 to 19.0 ms; p99 was 18.2 ms. Warming shaders, pipeline states and the Vase grab on the first frames took the worst frame of the "tide" (a moment the report does not define) from 249 to 18.6 ms. The last 48 ms hitch was a missing glyph, and the last allocation was a "+N" badge string; the game holds 0 B over 600 frames. The quality governor now judges the median of 90 frames, so one hitch no longer drops a resolution rung.
 
 ## Common mistakes
 
-- A short warm list. Pocket Crew warmed World 1 only, so World 2 started with a 398 ms hitch.
-- A warm-up that leaves global state changed. Pocket Crew's left fog and sky altered and every launch flashed violet for about 1 s; another kept references, so movers drew frozen.
-- Reading "Complete build size": in Hot Gates it was the Xcode project.
-- Test files in `Resources/`. Pocket Crew's release export carried about 1 MB of test reference meshes.
+- A short warm list. One game warmed World 1 only, so World 2 started with a 398 ms hitch.
+- A warm-up that leaves global state changed. One game's left fog and sky altered and every launch flashed violet for about 1 s; another kept references, so movers drew frozen.
+- Reading "Complete build size": in one game it was the Xcode project.
+- Test files in `Resources/`. One game's release export carried about 1 MB of test reference meshes.

package/plugins/claude/skills/unity-game/references/probe.md

@@ -1,10 +1,10 @@
 # Measuring the player: com.funpixel.probe and funtools unity probe
 
-Five games each wrote a probe of their own: Knockout Lap's `HitchProbe`, Particle Rush's `PerfProbe`, The Hot Gates' `PerfRecorder`, Pocket Crew's `PerfProbe` and `Hitch`, and Gallery Heist's. Pocket Crew also wrote a 661-line `RemotePlay.cs` for input over TCP. The kit now ships one package with both halves. Don't write another probe; give the package your game's facts instead.
+Five games each wrote a probe of their own (`HitchProbe`, `PerfProbe`, `PerfRecorder`, `PerfProbe` and `Hitch`, and one more). One of them also wrote a 661-line `RemotePlay.cs` for input over TCP. The kit now ships one package with both halves. Don't write another probe; give the package your game's facts instead.
 
 ## Getting it into a project
 
-`npx @funpixel/tools unity probe install --project <dir>` adds one line to `Packages/manifest.json` and prints it. The line is a `file:` path to the kit's copy, relative to `Packages/`, the way the studio's games reference `com.joydle.core`. Pass `--git <url> --ref <tag>` for a pinned git URL; an unpinned one is refused. `--tests` also lists the package under `testables`; leave it off on a game whose test count is a baseline. `unity probe uninstall` takes the line out. Nothing is installed silently: `probe`, `play` and `capture` refuse a project without the line and say how to add it.
+`npx @funpixel/tools unity probe install --project <dir>` adds one line to `Packages/manifest.json` and prints it. The line is a `file:` path to the kit's copy, relative to `Packages/`, the way a game references a local package. Pass `--git <url> --ref <tag>` for a pinned git URL; an unpinned one is refused. `--tests` also lists the package under `testables`; leave it off on a game whose test count is a baseline. `unity probe uninstall` takes the line out. Nothing is installed silently: `probe`, `play` and `capture` refuse a project without the line and say how to add it.
 
 What reaches a store build: nothing. The player assembly (`Funpixel.Probe.Player`) has define constraints `DEVELOPMENT_BUILD || UNITY_EDITOR || FUNPIXEL_PROBE` and `!FUNPIXEL_NO_PROBE`. The game calls `FunpixelProbe`, whose methods are `[Conditional]`, so in a release build the calls and their arguments are compiled away. `FUNPIXEL_PROBE` exists only for the capture build (below), and the package's build guard fails any build whose Player Settings carry it.
 
@@ -53,7 +53,7 @@ Left out, and counted: the first 30 frames of the path, every capture frame and
 | tablet | 17.5 ms | 20 ms | 34 ms | 160 | 200 | 400k | 256 B | 1536 MB |
 | mac | 17.5 ms | 20 ms | 34 ms | 400 | 400 | 4M | 256 B | 3072 MB |
 
-The frame numbers are `frame_budget`; draws and triangles are Pocket Crew's per view; SetPass and memory are Particle Rush's tiers. The GC line allows the 30–200 B a development player allocates in the engine. Judge 0 B (`alloc_quiet`) in a release player or in tests. A Mac target is judged as `mac`, and a Simulator as `phone` or `tablet` by its device name. `--tier` and `--budget '{"draws": 200}'` (or a file, one budget per tier) override this.
+The frame numbers are `frame_budget`; draws and triangles are one game's per view; SetPass and memory are another's tiers. The GC line allows the 30–200 B a development player allocates in the engine. Judge 0 B (`alloc_quiet`) in a release player or in tests. A Mac target is judged as `mac`, and a Simulator as `phone` or `tablet` by its device name. `--tier` and `--budget '{"draws": 200}'` (or a file, one budget per tier) override this.
 
 Three states, as on the web: a number the player did not report is "not observed", never a pass. A run under 120 measured frames does not judge frame time.
 
@@ -68,7 +68,7 @@ A Simulator, or a Mac at load 36 or more, adds single long frames the game did n
 - `play key Space`, `play pad south` and `play act "stick 1 0 800"`;
 - `play state`, `play ui` (every pressable thing with its rect), `play views` and `play scene Level2`;
 - `play shot --out f.png`, upright at full resolution;
-- `play record --seconds 10`: frames plus a WAV of the game's own mix, through Unity's offline `AudioRenderer` after Floe Jam's `Recorder.cs`, joined into an MP4 when ffmpeg is there;
+- `play record --seconds 10`: frames plus a WAV of the game's own mix, through Unity's offline `AudioRenderer` after one game's `Recorder.cs`, joined into an MP4 when ffmpeg is there;
 - `play end`.
 
 Input goes in as Input System device state (touch, mouse with `--mouse`, keyboard, pad), so it takes the path a finger takes.

package/plugins/claude/skills/unity-game/references/shared-mac.md

@@ -8,7 +8,7 @@ now has one of each, shared by every session of this user on the Mac.
 ## Unity: `funtools unity run`
 
 ```
-funtools unity run -- -nographics -buildTarget iOS -executeMethod Joydle.Core.Editor.BuildTools.SimulatorDev
+funtools unity run -- -nographics -buildTarget iOS -executeMethod Setup.BuildSimulator
 funtools unity run --project ../my-game -- -nographics -runTests -testPlatform EditMode -testResults results.xml
 funtools unity jobs
 ```

package/plugins/claude/skills/unity-game/references/traps.md

@@ -12,14 +12,14 @@ starts Unity, and prints each finding with its fix. One line per trap it catches
 - Git LFS pointer files where binaries belong (FSBTool "Failed decoding audio clip", blank textures): fails, names the repository to pull in.
 - `activeInputHandler: 0`, the old Input Manager alone, on an iOS or Android project (no touch in a player build): fails.
 - `UnityEngine.Input` calls on a project set to the Input System only (each throws): fails.
-- The Input System hooked at `AfterAssembliesLoaded` (throws on iOS; `BackButton` hooks on first read): warns.
+- The Input System hooked at `AfterAssembliesLoaded` (throws on iOS; hook on first read): warns.
 - TextMesh Pro used with no Essential Resources (`CreateFontAsset` returns null): fails; a batch-mode ImportPackage of them (hangs): warns.
-- A camera in a scene or made in code with nothing adding an AudioListener (a silent build; `Sfx.EnsureListener()`): warns.
+- A camera in a scene or made in code with nothing adding an AudioListener (a silent build): warns.
 - `Shader.WarmupAllShaders` (segfaults with URP keyword spaces; warm a ShaderVariantCollection): fails on URP.
 - A GLB glTFast cannot decode (meshopt, Draco or Basis without its decoder package, WebP ever): fails, because it imports as nothing.
 - `Shader.Find` of a project shader nothing references (null in a build): warns.
 - `enableWordWrapping`, a bare `new RenderParams{}`, runtime `QualitySettings.antiAliasing`, `-quit` with `-runTests`: warn.
-- ProjectSettings drifted from the project's setup method (Knockout Lap's iOS graphics APIs went back to automatic three times): warns; build through `Setup.Configure`.
+- ProjectSettings drifted from the project's setup method (one game's iOS graphics APIs went back to automatic three times): warns; build through `Setup.Configure`.
 - A build module a target needs (Mac IL2CPP and Windows were missing): warns with the Unity Hub line.
 - No distribution certificate, Xcode account or App Store Connect key on an iOS project (each blocks TestFlight): warns.
 
@@ -29,31 +29,30 @@ starts Unity, and prints each finding with its fix. One line per trap it catches
   says nothing about it (`fp:art`, Unity page).
 - glTFast decodes textures embedded in a GLB to RGBA32; its "latest" tag pointed at an experimental
   7.0, so pin 6.20 (`fp:3d`, Unity page).
-- `UnityRuntime.framework`'s plist says iOS 15.0 and its binary 16.0: ITMS-90208 (`IosPostprocess`).
+- `UnityRuntime.framework`'s plist says iOS 15.0 and its binary 16.0: ITMS-90208: stamp each embedded framework's minimum OS with the app's in a post-process step.
 - High stripping removes an assembly reached only through `RuntimeInitializeOnLoadMethod`, and Unity
-  ignores a package's own `link.xml` (`com.joydle.firebase` hands its file to the linker).
+  ignores a package's own `link.xml` (hand that file to the linker yourself).
 - TMP outline and underlay variants of materials made at runtime are stripped, and so are
   `shader_feature` variants: use `multi_compile_local`.
 - TMP lives in uGUI 2.x, not a package of its own; its Essential Resources still go in `Assets/TextMesh Pro`.
 - Burst can time out under heavy host load; never ship that export.
 - Re-importing an atlas regenerates sprite ids, and a PNG of a new size keeps the old sprite rect, so
   Unity drops the sprite.
-- iOS caches launch storyboards by name across updates: rename the storyboard (`JoydleLaunch`).
+- iOS caches launch storyboards by name across updates: rename the storyboard.
 - A project can be URP with `GraphicsSettings` saying none: the monorepo games assign the URP asset only
-  in `QualitySettings` (`m_CustomRenderPipeline: {fileID: 0}`), while Knockout Lap, Gallery Heist and
-  Particle Rush set it in `GraphicsSettings`. Read both before calling a project built-in; Floe Jam is
-  the one that is.
+  in `QualitySettings` (`m_CustomRenderPipeline: {fileID: 0}`), while others set it in
+  `GraphicsSettings`. Read both before calling a project built-in.
 - A WebGL build compressed with Brotli fails on a phone over the Mac's LAN address
   (`ERR_CONTENT_DECODING_FAILED`: Brotli needs https or localhost): serve it with `funtools serve`,
   which falls back to gzip there.
 - Addressables bundles built uncompressed (for a CDN to Brotli) weigh about twice as much from a
-  server that sends them raw (Gallery Heist's Room 1: 99.7 MB against 47.3 MB). `funtools serve`
+  server that sends them raw (one game's Room 1: 99.7 MB against 47.3 MB). `funtools serve`
   compresses them on the fly as a CDN would, so its sizes and load times are what a player gets;
   `--no-compress` shows the raw weight.
 
 ## Runtime
 
-- Mono never sees `simctl launch` arguments: read them natively (`LaunchArgs.Get()`).
+- Mono never sees `simctl launch` arguments: read them natively.
 - PlayerPrefs reads the launch-argument domain first: a flag `-coins` shadows the save key `coins`.
 - A Unity API call in a field initializer throws: move it to `Start`.
 - `OnApplicationPause(true)` also fires on resign-active (Control Center, Siri, call banners, Face ID).
@@ -64,7 +63,7 @@ starts Unity, and prints each finding with its fix. One line per trap it catches
 - `Screen.cutouts` allocates on every call: read it when the screen changes.
 - `preserveAspect` fits around the pivot; a `Slider` stretches to the row height; stretch anchors
   plus a non-zero `sizeDelta` double the width.
-- The first scene load can eat about 1 s of a startup animation (`JoydleSplash` waits for it).
+- The first scene load can eat about 1 s of a startup animation (wait for it before one starts).
 - Unity 6 renamed the draw-call profiler counter, so an old probe reads 0.
 - C# `Math.Round` is banker's rounding, `List.Sort` is unstable, `Math.Sin` differs from V8 on about
   6% of inputs and a naive hypot on about 40% (`references/from-a-web-game.md`).
@@ -75,7 +74,7 @@ starts Unity, and prints each finding with its fix. One line per trap it catches
 - `Object.Destroy` does nothing in edit-mode captures: use `DestroyImmediate`.
 - `CaptureScreenshotIntoRenderTexture` is upside down on Metal, and `ScreenCapture` stalls the next
   frames.
-- Frames a judge scores come from a capture rig, not the Editor (Particle Rush, Oct 2026):
+- Frames a judge scores come from a capture rig, not the Editor (Oct 2026):
   - a player build with a scripting define that turns the launch flags on and is not a development
     build, because a development build stamps its watermark and console into every frame;
   - `-shotscale 2` (passed to `ScreenCapture.CaptureScreenshot`'s supersize) for a full-resolution phone
@@ -97,7 +96,7 @@ starts Unity, and prints each finding with its fix. One line per trap it catches
 - TMP dynamic font assets are rewritten by every batch run and conflict on every merge: keep shipped
   fonts static, or clear them after captures.
 - The root `.gitignore`'s `*.csproj` silently drops hand-written test and server projects.
-- A copied project keeps its source's identity: Particle Rush's `.gitattributes` names The Hot Gates'
+- A copied project keeps its source's identity: one game's `.gitattributes` names its source's
   paths, its Android id is still Unity's template `com.UnityTechnologies…urpblank`, and standalone ids
   are left as `com.DefaultCompany.2D-URP`. Check the ids and `.gitattributes` against the game's name.