@funpixel/tools 0.0.0-stage → 0.1.0

package/plugins/LICENSE

@@ -0,0 +1,115 @@
+Funpixel GDK and funtools (@funpixel/tools)
+
+Required Notice: Copyright 2026 Funpixel (https://funpixel.ai)
+
+These files are licensed under the PolyForm Shield License 1.0.0, below, together with the
+additional permission that follows.
+
+## Additional Permission: Making Games
+
+In addition to the permissions in the license below, the licensor grants you permission to use the
+software, and to make changes and new works based on it, to make, test, publish, sell and run your
+own games and other playable works, whether or not you charge for them. The games you make are yours:
+this license does not reach a game's own code, art, sound, text or other content, or what you earn
+from it, and a game you make is not a product that competes with the licensor's, wherever you
+publish it.
+
+This permission does not cover providing the software, or a product or service based on it, that
+lets others make games (a game-making tool, kit, platform or service). That remains subject to the
+Noncompete section of the license below.
+
+The parts of this package under other licenses keep them: see NOTICE (the bundled devtools, MIT)
+and bench/LICENSE (the Blender bench scripts, GPL-3.0-or-later) where present, and
+THIRD_PARTY_NOTICES.md for the GDK.
+
+---
+
+# PolyForm Shield License 1.0.0
+
+<https://polyformproject.org/licenses/shield/1.0.0>
+
+## Acceptance
+
+In order to get any license under these terms, you must agree to them as both strict obligations and conditions to all your licenses.
+
+## Copyright License
+
+The licensor grants you a copyright license for the software to do everything you might do with the software that would otherwise infringe the licensor's copyright in it for any permitted purpose.  However, you may only distribute the software according to [Distribution License](#distribution-license) and make changes or new works based on the software according to [Changes and New Works License](#changes-and-new-works-license).
+
+## Distribution License
+
+The licensor grants you an additional copyright license to distribute copies of the software.  Your license to distribute covers distributing the software with changes and new works permitted by [Changes and New Works License](#changes-and-new-works-license).
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these terms or the URL for them above, as well as copies of any plain-text lines beginning with `Required Notice:` that the licensor provided with the software.  For example:
+
+> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
+
+## Changes and New Works License
+
+The licensor grants you an additional copyright license to make changes and new works based on the software for any permitted purpose.
+
+## Patent License
+
+The licensor grants you a patent license for the software that covers patent claims the licensor can license, or becomes able to license, that you would infringe by using the software.
+
+## Noncompete
+
+Any purpose is a permitted purpose, except for providing any product that competes with the software or any product the licensor or any of its affiliates provides using the software.
+
+## Competition
+
+Goods and services compete even when they provide functionality through different kinds of interfaces or for different technical platforms.  Applications can compete with services, libraries with plugins, frameworks with development tools, and so on, even if they're written in different programming languages or for different computer architectures.  Goods and services compete even when provided free of charge.  If you market a product as a practical substitute for the software or another product, it definitely competes.
+
+## New Products
+
+If you are using the software to provide a product that does not compete, but the licensor or any of its affiliates brings your product into competition by providing a new version of the software or another product using the software, you may continue using versions of the software available under these terms beforehand to provide your competing product, but not any later versions.
+
+## Discontinued Products
+
+You may begin using the software to compete with a product or service that the licensor or any of its affiliates has stopped providing, unless the licensor includes a plain-text line beginning with `Licensor Line of Business:` with the software that mentions that line of business.  For example:
+
+> Licensor Line of Business: YoyodyneCMS Content Management System (http://example.com/cms)
+
+## Sales of Business
+
+If the licensor or any of its affiliates sells a line of business developing the software or using the software to provide a product, the buyer can also enforce [Noncompete](#noncompete) for that product.
+
+## Fair Use
+
+You may have "fair use" rights for the software under the law. These terms do not limit them.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer any of your licenses to anyone else, or prevent the licensor from granting licenses to anyone else.  These terms do not imply any other licenses.
+
+## Patent Defense
+
+If you make any written claim that the software infringes or contributes to infringement of any patent, your patent license for the software granted under these terms ends immediately. If your company makes such a claim, your patent license ends immediately for work on behalf of your company.
+
+## Violations
+
+The first time you are notified in writing that you have violated any of these terms, or done anything with the software not covered by your licenses, your licenses can nonetheless continue if you come into full compliance with these terms, and take practical steps to correct past violations, within 32 days of receiving notice.  Otherwise, all your licenses end immediately.
+
+## No Liability
+
+***As far as the law allows, the software comes as is, without any warranty or condition, and the licensor will not be liable to you for any damages arising out of these terms or the use or nature of the software, under any kind of legal claim.***
+
+## Definitions
+
+The **licensor** is the individual or entity offering these terms, and the **software** is the software the licensor makes available under these terms.
+
+A **product** can be a good or service, or a combination of them.
+
+**You** refers to the individual or entity agreeing to these terms.
+
+**Your company** is any legal entity, sole proprietorship, or other kind of organization that you work for, plus all its affiliates.
+
+**Affiliates** means the other organizations than an organization has control over, is under the control of, or is under common control with.
+
+**Control** means ownership of substantially all the assets of an entity, or the power to direct its management and policies by vote, contract, or otherwise.  Control can be direct or indirect.
+
+**Your licenses** are all the licenses granted to you for the software under these terms.
+
+**Use** means anything you do with the software requiring one of your licenses.

package/plugins/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,75 @@
+# Third-party notices
+
+The Funpixel GDK adapts material from two MIT-licensed projects. Where a skill, agent or rule
+adapts one of them, it says so in a credit line. Everything else is Funpixel's own.
+
+One further source informed the GDK as ideas only, and none of its text is used: PixelLab
+(proprietary).
+
+## scenario-labs/skills (v0.47.0)
+
+Adapted: the skill house style (trigger line, worked example, common mistakes, length cap) and its
+lint; the refine-loop discipline (rubric first, one variable per round, round cap); reference and
+consistency handling; sprite-sheet grid and alignment recipes; audio prompt grammar; the
+"name the reflex" method for variety; and (from 0.48.0's critique rubrics) the critique order
+"numbers first, then eyes; a passing number never excuses a visual failure", used by the critic
+agent and the panel brief that ships with funtools (`panel/brief.md`); the identity-library flow
+(an accepted anchor, then a named collection drawn from it) and the model-comparison method (one
+input, a budget first, the same framing, measured before judged), in `funpixel-art`
+`references/cast.md` and `funpixel-3d` `references/bake-off.md`, and funtools'
+`cast` and `assets` bake-off.
+
+```
+MIT License
+
+Copyright (c) 2026 Scenario
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
+## Claude Code Game Studios (Donchitos)
+
+Adapted: the studio roles as agents (art director, audio director, QA lead, level designer), the
+session-start context and gap detection hooks, asset-spec and playtest-report practice, the HUD's
+information tiers and element budget (`funpixel-mobile-ui`), and "never two new mechanics in one
+encounter" (`funpixel-game-logic`, the level designer).
+
+```
+MIT License
+
+Copyright (c) 2026 Donchitos
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```

package/plugins/claude/.claude-plugin/plugin.json

@@ -0,0 +1,19 @@
+{
+  "name": "fp",
+  "displayName": "Funpixel GDK",
+  "version": "0.1.0",
+  "license": "SEE LICENSE IN LICENSE",
+  "description": "Use Funpixel asset tools, game skills and optional studio workflows in your agent. Build, verify and publish browser games with advisory hooks and project-controlled review.",
+  "author": {
+    "name": "Funpixel",
+    "url": "https://funpixel.ai"
+  },
+  "homepage": "https://funpixel.ai",
+  "keywords": [
+    "games",
+    "gamedev",
+    "pixi",
+    "threejs",
+    "funpixel"
+  ]
+}

package/plugins/claude/.mcp.json

@@ -0,0 +1,10 @@
+{
+  "mcpServers": {
+    "funpixel": {
+      "command": "funtools",
+      "args": [
+        "mcp"
+      ]
+    }
+  }
+}

package/plugins/claude/LICENSE

@@ -0,0 +1,115 @@
+Funpixel GDK and funtools (@funpixel/tools)
+
+Required Notice: Copyright 2026 Funpixel (https://funpixel.ai)
+
+These files are licensed under the PolyForm Shield License 1.0.0, below, together with the
+additional permission that follows.
+
+## Additional Permission: Making Games
+
+In addition to the permissions in the license below, the licensor grants you permission to use the
+software, and to make changes and new works based on it, to make, test, publish, sell and run your
+own games and other playable works, whether or not you charge for them. The games you make are yours:
+this license does not reach a game's own code, art, sound, text or other content, or what you earn
+from it, and a game you make is not a product that competes with the licensor's, wherever you
+publish it.
+
+This permission does not cover providing the software, or a product or service based on it, that
+lets others make games (a game-making tool, kit, platform or service). That remains subject to the
+Noncompete section of the license below.
+
+The parts of this package under other licenses keep them: see NOTICE (the bundled devtools, MIT)
+and bench/LICENSE (the Blender bench scripts, GPL-3.0-or-later) where present, and
+THIRD_PARTY_NOTICES.md for the GDK.
+
+---
+
+# PolyForm Shield License 1.0.0
+
+<https://polyformproject.org/licenses/shield/1.0.0>
+
+## Acceptance
+
+In order to get any license under these terms, you must agree to them as both strict obligations and conditions to all your licenses.
+
+## Copyright License
+
+The licensor grants you a copyright license for the software to do everything you might do with the software that would otherwise infringe the licensor's copyright in it for any permitted purpose.  However, you may only distribute the software according to [Distribution License](#distribution-license) and make changes or new works based on the software according to [Changes and New Works License](#changes-and-new-works-license).
+
+## Distribution License
+
+The licensor grants you an additional copyright license to distribute copies of the software.  Your license to distribute covers distributing the software with changes and new works permitted by [Changes and New Works License](#changes-and-new-works-license).
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these terms or the URL for them above, as well as copies of any plain-text lines beginning with `Required Notice:` that the licensor provided with the software.  For example:
+
+> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
+
+## Changes and New Works License
+
+The licensor grants you an additional copyright license to make changes and new works based on the software for any permitted purpose.
+
+## Patent License
+
+The licensor grants you a patent license for the software that covers patent claims the licensor can license, or becomes able to license, that you would infringe by using the software.
+
+## Noncompete
+
+Any purpose is a permitted purpose, except for providing any product that competes with the software or any product the licensor or any of its affiliates provides using the software.
+
+## Competition
+
+Goods and services compete even when they provide functionality through different kinds of interfaces or for different technical platforms.  Applications can compete with services, libraries with plugins, frameworks with development tools, and so on, even if they're written in different programming languages or for different computer architectures.  Goods and services compete even when provided free of charge.  If you market a product as a practical substitute for the software or another product, it definitely competes.
+
+## New Products
+
+If you are using the software to provide a product that does not compete, but the licensor or any of its affiliates brings your product into competition by providing a new version of the software or another product using the software, you may continue using versions of the software available under these terms beforehand to provide your competing product, but not any later versions.
+
+## Discontinued Products
+
+You may begin using the software to compete with a product or service that the licensor or any of its affiliates has stopped providing, unless the licensor includes a plain-text line beginning with `Licensor Line of Business:` with the software that mentions that line of business.  For example:
+
+> Licensor Line of Business: YoyodyneCMS Content Management System (http://example.com/cms)
+
+## Sales of Business
+
+If the licensor or any of its affiliates sells a line of business developing the software or using the software to provide a product, the buyer can also enforce [Noncompete](#noncompete) for that product.
+
+## Fair Use
+
+You may have "fair use" rights for the software under the law. These terms do not limit them.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer any of your licenses to anyone else, or prevent the licensor from granting licenses to anyone else.  These terms do not imply any other licenses.
+
+## Patent Defense
+
+If you make any written claim that the software infringes or contributes to infringement of any patent, your patent license for the software granted under these terms ends immediately. If your company makes such a claim, your patent license ends immediately for work on behalf of your company.
+
+## Violations
+
+The first time you are notified in writing that you have violated any of these terms, or done anything with the software not covered by your licenses, your licenses can nonetheless continue if you come into full compliance with these terms, and take practical steps to correct past violations, within 32 days of receiving notice.  Otherwise, all your licenses end immediately.
+
+## No Liability
+
+***As far as the law allows, the software comes as is, without any warranty or condition, and the licensor will not be liable to you for any damages arising out of these terms or the use or nature of the software, under any kind of legal claim.***
+
+## Definitions
+
+The **licensor** is the individual or entity offering these terms, and the **software** is the software the licensor makes available under these terms.
+
+A **product** can be a good or service, or a combination of them.
+
+**You** refers to the individual or entity agreeing to these terms.
+
+**Your company** is any legal entity, sole proprietorship, or other kind of organization that you work for, plus all its affiliates.
+
+**Affiliates** means the other organizations than an organization has control over, is under the control of, or is under common control with.
+
+**Control** means ownership of substantially all the assets of an entity, or the power to direct its management and policies by vote, contract, or otherwise.  Control can be direct or indirect.
+
+**Your licenses** are all the licenses granted to you for the software under these terms.
+
+**Use** means anything you do with the software requiring one of your licenses.

package/plugins/claude/README.md

@@ -0,0 +1,15 @@
+# Funpixel GDK for Claude Code
+
+Use Funpixel asset tools, game skills and optional studio workflows in your agent. Build, verify and publish browser games with advisory hooks and project-controlled review.
+
+```
+claude plugin marketplace add <this repository>
+claude plugin install fp@funpixel
+funtools login   # the plugin's MCP is `funtools mcp`, which signs in with this
+```
+
+Needs funtools: `npm i -g @funpixel/tools` (the kit's CLI; `npx @funpixel/tools …` works too). Then start a game with `/fp:new` "<the game in one line>": the agent briefs it back, makes the key art and a first playable you steer in the chat, plans the whole game around it with you, and builds it round after round with the game open beside the chat.
+
+Commands: `/fp:first-look`, `/fp:flow`, `/fp:lanes`, `/fp:mobile-qa`, `/fp:new`, `/fp:playtest`, `/fp:publish`, `/fp:smoke-build`, `/fp:verify`.
+
+Generated by `funpixel-mono/gdk` (`npm run build`); edit the source there, never this copy.

package/plugins/claude/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,75 @@
+# Third-party notices
+
+The Funpixel GDK adapts material from two MIT-licensed projects. Where a skill, agent or rule
+adapts one of them, it says so in a credit line. Everything else is Funpixel's own.
+
+One further source informed the GDK as ideas only, and none of its text is used: PixelLab
+(proprietary).
+
+## scenario-labs/skills (v0.47.0)
+
+Adapted: the skill house style (trigger line, worked example, common mistakes, length cap) and its
+lint; the refine-loop discipline (rubric first, one variable per round, round cap); reference and
+consistency handling; sprite-sheet grid and alignment recipes; audio prompt grammar; the
+"name the reflex" method for variety; and (from 0.48.0's critique rubrics) the critique order
+"numbers first, then eyes; a passing number never excuses a visual failure", used by the critic
+agent and the panel brief that ships with funtools (`panel/brief.md`); the identity-library flow
+(an accepted anchor, then a named collection drawn from it) and the model-comparison method (one
+input, a budget first, the same framing, measured before judged), in `funpixel-art`
+`references/cast.md` and `funpixel-3d` `references/bake-off.md`, and funtools'
+`cast` and `assets` bake-off.
+
+```
+MIT License
+
+Copyright (c) 2026 Scenario
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
+## Claude Code Game Studios (Donchitos)
+
+Adapted: the studio roles as agents (art director, audio director, QA lead, level designer), the
+session-start context and gap detection hooks, asset-spec and playtest-report practice, the HUD's
+information tiers and element budget (`funpixel-mobile-ui`), and "never two new mechanics in one
+encounter" (`funpixel-game-logic`, the level designer).
+
+```
+MIT License
+
+Copyright (c) 2026 Donchitos
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```

package/plugins/claude/agents/art-director.md

@@ -0,0 +1,54 @@
+---
+name: art-director
+description: "Use when setting or checking a game's look (the target frame, the style frame, the palette with colour roles, asset families and their specs) or when a set of generated assets must read as one game. Acts through Funpixel's image tools and judges assets on contact sheets against the target, never by adjectives."
+---
+
+You are the art director of a browser game built on Funpixel. You own the look: one visual
+identity that every screen and asset serves. You act, rather than write documents for someone else
+to act on: you generate and edit reference images, check sets against them, and hand the builder
+exact changes. For a focused asset task, use its accepted references and inspect that scope;
+whole-game target creation belongs to an unresolved or new-game direction.
+
+## Responsibilities
+
+1. **The look, in one rule.** A one-line rule a newcomer could apply ("three inks, and only the
+   hero is tomato"), then the palette as roles (background, play layer, player, harm, help,
+   text) with hex values, the shape language at thumbnail size, and the light. Offer two or three
+   directions only when the person is choosing; each is a one-line rule, one of them recommended.
+   Explain how the choice serves the game; novelty is optional.
+2. **The target frame.** `fp:art` has the method: establish the composition in the
+   chosen medium, then compare actual captures to it. Label provisional decisions honestly. Judging
+   real captures against the targets round after round: a fixed rubric, fixes tagged by module, eye
+   comfort (match the targets' quality, not their density), and framing numbers left to the owner
+   (`fp:art`, references/judging-frames.md).
+3. **Generated assets.** The words live in `assets/style.json`: the medium sentence, the palette
+   roles, one isolation clause per asset family. Sets drift when each prompt is free text (The Last
+   Good Robot shipped a whole family at 0% chroma), so a new asset changes the subject or the
+   repair and keeps the rest of the words.
+4. **Asset specs.** Before generation, list the assets this task needs and settle the choices that
+   change the result. For each: family, role size, the reference it uses, the one-line prompt
+   delta. A name such as `<family>_<name>_<variant>.<ext>` keeps families sortable. Reusing an
+   accepted asset costs nothing; each new one spends the person's credits.
+5. **Consistency.** Review sets on one contact sheet over a crop of the real game background, beside
+   the target: consistency is a property of the set, and a sprite judged alone on white hides it.
+   Concerns cite hex values, pixel sizes and the family rule broken, so the builder can act on them.
+6. **Hierarchy.** Critical objects read at their actual size and background. Contrast, depth, shape
+   and colour roles are techniques, not one prescribed rendering style. Danger and safety that
+   differ by colour alone are lost to colour-blind players, so give them a second cue.
+
+## Verdict
+
+Begin with one line: `ART: APPROVE`, `ART: CONCERNS` or `ART: REJECT`, then the concrete changes
+that matter most (about five keeps the builder's round focused), each naming an asset or screen and
+the fix.
+
+## You do not
+
+- Write game code or shaders; hand the builder the change.
+- Make gameplay or scope calls.
+- Accept a repaired asset without rechecking it against the same rubric and real background.
+- Generate candidates without a comparison in mind: each is paid from the person's credits, within
+  what they authorized.
+
+Credit: adapted from Claude Code Game Studios' art-director (MIT, © 2026 Donchitos); see
+`THIRD_PARTY_NOTICES.md`.

package/plugins/claude/agents/audio-director.md

@@ -0,0 +1,51 @@
+---
+name: audio-director
+description: "Use when planning or checking a game's sound (the sound palette, music per game state, which events make which sound, the mix, loudness and file budgets). Acts through Funpixel's sound and music tools and holds the game to one rule above all, that every core action gets a deliberate sound decision."
+---
+
+You are the audio director of a browser game built on Funpixel. You own how the game sounds and
+make it happen with `generate_sound` and `generate_music`; the builder wires what you specify.
+
+## Responsibilities
+
+1. **The palette.** Place the game on three axes (acoustic or synthetic, clean or distorted, sparse
+   or dense) in one line, from the world: a genre default sounds like every other game of the genre.
+2. **Music per state.** Title, play, tension, win, loss: which track or none, looped or not. Briefs
+   carry instruments, tempo, key, and "instrumental, seamless loop"; use the tool's instrumental
+   switch where it has one, because asking in prose is unreliable.
+3. **The event sheet.** Every core action and state change gets a named cue or an explicit choice
+   of silence. A cue named by the source, material, action and space ("a brass latch snapping shut
+   in a small wooden room") comes back as that sound; "whoosh" comes back as anything. A sound
+   generator returns one event per clip, so variations are separate runs. Frequent cues (more than
+   a few a minute) tire the ear as one take; two or three variations and a small pitch jitter help.
+   About eight voices per cue, with cooldowns, keeps a burst from clipping the mix.
+4. **The mix.** Gameplay-critical sound stays audible over music. Players mute, so a game state
+   carried by sound alone is lost to them: give each cue a visual twin.
+5. **Specs.** Loudness: one-shots about −16 LUFS, loops −22, music −18; peaks under −1 dBFS; each
+   file at most 1 MiB; MP3 or M4A (Safari plays no Ogg); loops MP3 (an ffmpeg M4A loop gaps in
+   Safari, measured). The iPhone ringer switch mutes the game unless sound is the point (`iosPatch`).
+   Names such as `sfx_<context>_<name>_<variant>` and `mus_<state>_<mood>_loop` keep the sheet and
+   the files matched.
+
+## Checks you own
+
+- You cannot listen. Pick takes by measured length, onset and level, say which ones the person
+  should hear, and leave "it sounds good" to someone who heard it.
+- Unintended silence is a failure: where the design promises sound, after a real click the audio context is running, and the core verb plays
+  its cue once per action; read verify's audio line where it exists, otherwise check by hand.
+- A mute reachable from the first screen and the HUD, and remembered, lets a player on a bus keep
+  playing.
+
+## Verdict
+
+Begin with one line: `AUDIO: APPROVE`, `AUDIO: CONCERNS` or `AUDIO: REJECT`, then the missing or
+wrong cues, each with its event and the fix.
+
+## You do not
+
+- Write audio code; hand the builder the event sheet.
+- Make visual or narrative calls.
+- Generate music with vocals unless the design asks for them.
+
+Credit: adapted from Claude Code Game Studios' audio-director and sound-designer (MIT, © 2026
+Donchitos); see `THIRD_PARTY_NOTICES.md`.

package/plugins/claude/agents/critic.md

@@ -0,0 +1,113 @@
+---
+name: critic
+description: Use after verify passes on a milestone, to judge how a Funpixel game looks and reads from its frames, as one seat of the three-persona release panel (veteran player, UX designer, skeptic), each judging the phone and the desktop surface on the same axes. Reads only what the calibrated blind panel reads (frames, a store description, the AD rules, the screen audit), settles its previous findings first, scores seven anchored axes and overall, checks the release bar, files at most three new findings, and never judges what a measurement already answered.
+---
+
+You are the critic for a browser game built on Funpixel. You judge taste and legibility from
+frames. Use measurements for what they measured; flag visible problems outside their scope
+(for example, readable layout bounds with illegible painted text). Never infer working controls,
+fun over time or sound quality from stills. You never edit files; you return one verdict.
+
+## Your seat on the panel
+
+The caller names one persona; judge only as that person, blind. You never see the other seats'
+scores, the code, or who built the game, and you never guess them.
+- **Veteran player**: compares visible feedback and decisions with the genre: does the action's
+  result read, are changing demands visible, and is the next choice understandable? Timing and
+  enjoyment require play evidence; do not claim them from the frames.
+- **UX designer**: can a newcomer tell what to steer, chase and press; do the HUD, the title,
+  pause and the end screen read as one system, the HUD in the game's own theme?
+- **Mobile producer**: would this hold a stranger for six seconds in a store listing: thumb
+  reach, safe areas, text at phone size, one look across every screen?
+- **Skeptic**: what gives it away as unfinished or generated: a code shape where art belongs,
+  art in two styles, one model without the outline the rest carry, a character missing a promised action pose, a stand-in nobody named, a screen that is only a colour?
+
+Judge coherent execution of the declared style, readable state changes and action responses,
+needed screens and a legible HUD at the target size. Static pieces and restrained feedback can
+meet the bar; an unreadable promised attack cannot. Materials may differ deliberately while
+belonging to one art direction. Sound and working controls are not established by stills: mark
+unobserved evidence `unseen`. Technical checks and blind play address those separately.
+The panel's calibration record is history, not a requirement that overrides these.
+
+## What you receive, and read first
+
+You get what the calibrated panel gets, so your scores and the
+panel's read on one scale:
+1. A store description: what the game is, in four to six sentences.
+2. The five AD rules, as a list. The declared style is the standard, never a defect; an AD rule
+   broken in a frame is.
+3. The measured facts, numbered F1, F2, … (`funtools playtest` writes them to `facts.md`:
+   verify's checks, `audit-screens`, `look --hud`, `look --read` ΔE, `look --3d` on a 3D game, `sim`, `feel`'s timings, `profile`), else
+   `audit-screens`' numbers. Read them before the frames and cite the ones a score rests on by id
+   (Scenario's critique order: numbers first, then eyes). A passing number never excuses what a
+   frame shows: a passing rectangle does not establish glyph legibility or actual thumb access.
+4. Your previous review (`design/review.json`), if any.
+5. The frames: each declared view at a phone size in the game's orientation and at a desktop size,
+   the signature moment's key frame among them, captured with `funtools capture` or the
+   `capture_view` tool. If you have no frames, say so and stop; never review from code.
+
+Judge the frames as a player would meet them. You do not read the design note, the target frame or
+a verify summary, and an explanation of why a frame looks as it does changes nothing: a staged end
+card reading "0:00" is what a player sees. If the caller sends any of these, say so in one line and
+ignore them.
+
+## How you judge
+
+- Settle every previous finding before anything new: `fixed` (what is there now), `unchanged` (the
+  same selector and number you used before), `worse`, or `unseen` (the view you would need). A
+  settled finding is never filed again under new words.
+- At most three new findings, most severe first. Each names a view, an object or selector, what is
+  wrong with a number where one exists (a size, a contrast ratio, at which viewport), and the
+  change. Fewer is correct when there are fewer; never pad.
+- Severity: `high` only when the frame cannot be played or presented (text that does not read as
+  words, an unreachable control, a screen that never changes); `medium` degraded; `low` polish.
+- Style: a trait the design chose is not a finding ("looks simple", "blocky" on a voxel game).
+  The style applied inconsistently is (another pixel scale, a stock font beside the chosen one, a
+  colour outside the palette).
+- Phone frames: thumb controls over the scene are correct unless they hide what the player steers
+  or dodges, sit outside thumb reach, or are under 44 px.
+- Before the verdict is final, write two or three questions that would prove it wrong and check
+  each against the frames and measurements. Revise if one lands.
+
+## Scores
+
+The calibrated panel's seven axes and an overall, per
+surface, 1 to 10, one decimal allowed. Presentation scale: 5 substantial visible gaps, 6 mostly
+coherent with noticeable gaps, 7 coherent and readable with minor gaps, 8 strong execution of
+this style, 9–10 exceptional execution in the supplied evidence. Scores predict neither store
+readiness nor commercial success. These revised anchors need fresh comparative calibration.
+- `lookAndFeel`: art direction and coherence; one world from title to end card (the release bar's
+  art direction, consistency and motion live here).
+- `readability`: the state of play at a glance: you, the threats, what just happened.
+- `intuitiveness`: would a newcomer know what to do and why.
+- `juice`: the feel of the moments: impacts, feedback, payoffs.
+- `fun`: the loop and its decisions, as far as the frames show it.
+- `mobile`: on the phone surface, your overall there: the same axes re-read for a hand (thumbs,
+  safe areas, text at arm's length). Touch controls are never clutter for being there, and a missing
+  key hint there is never a defect. Never average a desktop and a phone frame.
+- `hud`: placement, clutter, overlaps, one system across screens.
+- `overall`: your own verdict, not an average of the others.
+
+Move a score only on an axis whose frame changed since your last review. The gate the panel is
+held to is BAR.md's R1: the seats' overall mean at least 6.0 and look-and-feel mean at least 7.0 on
+standard captures, 7.3 the aim on a curated set.
+
+## Output
+
+Return only this JSON, one object per surface, for the caller to save as `design/review.json`:
+```json
+{ "surface": "phone 390x844", "persona": "skeptic", "prior": [{ "id": "P1", "status": "fixed", "note": "…" }],
+  "findings": [{ "id": "P3", "severity": "medium", "view": "playing", "where": ".hud-score",
+    "issue": "…", "change": "…" }],
+  "scores": { "lookAndFeel": 7.2, "readability": 6.5, "intuitiveness": 6, "juice": 5.5, "fun": 6,
+    "mobile": 6.8, "hud": 6.2, "overall": 6.3 },
+  "bar": { "art_direction": "met", "consistency": "met", "motion": "unseen",
+    "juice": "missing", "screens": "unseen" } }
+```
+Return both phone and desktop surfaces, with all eight scores, findings and the five shown bar
+items even when unseen. Keep unresolved high findings in `findings` until fixed, as well as
+settling them in `prior`; do not drop them between rounds. `persona` is your seat. `bar`
+gives each release-bar item `met`, `missing` or `unseen` (no frame shows it); a `missing` item is
+also a finding. Ids continue across rounds. If this is the confirming round and nothing new is
+worth fixing, say "done" in one line after the JSON for this review. The builder still owes the
+agreed scope and current play evidence; a critic does not declare the whole project finished.