@codyswann/lisa 2.160.0 → 2.162.0

package/plugins/lisa-harper-fabric/generated-artifact-globs.txt

@@ -0,0 +1,4 @@
+harper-app/resources.js
+harper-app/resource-*.js
+harper-app/web/**
+harper-app/lib/**

package/plugins/lisa-harper-fabric/hooks/block-generated-artifact-edits.sh

@@ -0,0 +1,72 @@
+#!/bin/bash
+# This file is managed by Lisa.
+# Do not edit directly - changes will be overwritten on the next `lisa` run.
+
+# PreToolUse hook: block Write/Edit/MultiEdit on generated Harper deploy
+# artifacts. Harper/Fabric projects build these files from TypeScript under
+# src/, so direct edits are overwritten by the next build and usually ship as
+# no-op fixes.
+# Reference: https://docs.claude.com/en/docs/claude-code/hooks
+# Exit code 2 blocks the tool call and surfaces stderr to Claude.
+
+JSON_INPUT=$(cat)
+
+command -v jq >/dev/null 2>&1 || exit 0
+
+FILE_PATH=$(printf '%s' "$JSON_INPUT" | jq -r '.tool_input.file_path // empty')
+[ -n "$FILE_PATH" ] || exit 0
+
+PLUGIN_ROOT=${CLAUDE_PLUGIN_ROOT:-}
+if [ -z "$PLUGIN_ROOT" ]; then
+  PLUGIN_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+fi
+GLOBS_FILE="$PLUGIN_ROOT/generated-artifact-globs.txt"
+[ -f "$GLOBS_FILE" ] || exit 0
+
+normalize_path() {
+  local path="$1"
+  path="${path#./}"
+  printf '%s' "$path"
+}
+
+matches_glob() {
+  local file="$1"
+  local glob="$2"
+
+  if [ "${glob: -3}" = "/**" ]; then
+    local dir="${glob%/**}"
+    case "$file" in
+      "$dir"/* | */"$dir"/*) return 0 ;;
+    esac
+    return 1
+  fi
+
+  case "$file" in
+    $glob | */$glob) return 0 ;;
+  esac
+
+  return 1
+}
+
+NORMALIZED_FILE=$(normalize_path "$FILE_PATH")
+
+while IFS= read -r glob || [ -n "$glob" ]; do
+  [ -n "$glob" ] || continue
+  case "$glob" in \#*) continue ;; esac
+
+  if matches_glob "$NORMALIZED_FILE" "$glob"; then
+    cat >&2 <<MSG
+Blocked: direct edit to generated Harper/Fabric artifact.
+
+File: $FILE_PATH
+Matched generated artifact pattern: $glob
+
+TypeScript under src/ is the source of truth for Harper resources, web assets,
+and shared libraries. Change the matching TypeScript source under src/ and run
+the project build to regenerate harper-app outputs.
+MSG
+    exit 2
+  fi
+done <"$GLOBS_FILE"
+
+exit 0

package/plugins/lisa-harper-fabric-agy/generated-artifact-globs.txt

@@ -0,0 +1,4 @@
+harper-app/resources.js
+harper-app/resource-*.js
+harper-app/web/**
+harper-app/lib/**

package/plugins/lisa-harper-fabric-agy/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-harper-fabric",
-  "version": "2.160.0",
+  "version": "2.162.0",
   "description": "Harper/Fabric-specific rules for TypeScript component apps",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-harper-fabric-copilot/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-harper-fabric",
-  "version": "2.160.0",
+  "version": "2.162.0",
   "description": "Harper/Fabric-specific rules for TypeScript component apps",
   "author": {
     "name": "Cody Swann"
@@ -9,6 +9,17 @@
     "lisa-typescript"
   ],
   "hooks": {
+    "preToolUse": [
+      {
+        "matcher": "Write|Edit|MultiEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/block-generated-artifact-edits.sh"
+          }
+        ]
+      }
+    ],
     "sessionStart": [
       {
         "matcher": "",

package/plugins/lisa-harper-fabric-copilot/generated-artifact-globs.txt

@@ -0,0 +1,4 @@
+harper-app/resources.js
+harper-app/resource-*.js
+harper-app/web/**
+harper-app/lib/**

package/plugins/lisa-harper-fabric-copilot/hooks/block-generated-artifact-edits.sh

@@ -0,0 +1,72 @@
+#!/bin/bash
+# This file is managed by Lisa.
+# Do not edit directly - changes will be overwritten on the next `lisa` run.
+
+# PreToolUse hook: block Write/Edit/MultiEdit on generated Harper deploy
+# artifacts. Harper/Fabric projects build these files from TypeScript under
+# src/, so direct edits are overwritten by the next build and usually ship as
+# no-op fixes.
+# Reference: https://docs.claude.com/en/docs/claude-code/hooks
+# Exit code 2 blocks the tool call and surfaces stderr to Claude.
+
+JSON_INPUT=$(cat)
+
+command -v jq >/dev/null 2>&1 || exit 0
+
+FILE_PATH=$(printf '%s' "$JSON_INPUT" | jq -r '.tool_input.file_path // empty')
+[ -n "$FILE_PATH" ] || exit 0
+
+PLUGIN_ROOT=${CLAUDE_PLUGIN_ROOT:-}
+if [ -z "$PLUGIN_ROOT" ]; then
+  PLUGIN_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+fi
+GLOBS_FILE="$PLUGIN_ROOT/generated-artifact-globs.txt"
+[ -f "$GLOBS_FILE" ] || exit 0
+
+normalize_path() {
+  local path="$1"
+  path="${path#./}"
+  printf '%s' "$path"
+}
+
+matches_glob() {
+  local file="$1"
+  local glob="$2"
+
+  if [ "${glob: -3}" = "/**" ]; then
+    local dir="${glob%/**}"
+    case "$file" in
+      "$dir"/* | */"$dir"/*) return 0 ;;
+    esac
+    return 1
+  fi
+
+  case "$file" in
+    $glob | */$glob) return 0 ;;
+  esac
+
+  return 1
+}
+
+NORMALIZED_FILE=$(normalize_path "$FILE_PATH")
+
+while IFS= read -r glob || [ -n "$glob" ]; do
+  [ -n "$glob" ] || continue
+  case "$glob" in \#*) continue ;; esac
+
+  if matches_glob "$NORMALIZED_FILE" "$glob"; then
+    cat >&2 <<MSG
+Blocked: direct edit to generated Harper/Fabric artifact.
+
+File: $FILE_PATH
+Matched generated artifact pattern: $glob
+
+TypeScript under src/ is the source of truth for Harper resources, web assets,
+and shared libraries. Change the matching TypeScript source under src/ and run
+the project build to regenerate harper-app outputs.
+MSG
+    exit 2
+  fi
+done <"$GLOBS_FILE"
+
+exit 0

package/plugins/lisa-harper-fabric-cursor/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-harper-fabric",
-  "version": "2.160.0",
+  "version": "2.162.0",
   "description": "Harper/Fabric-specific rules for TypeScript component apps",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-harper-fabric-cursor/generated-artifact-globs.txt

@@ -0,0 +1,4 @@
+harper-app/resources.js
+harper-app/resource-*.js
+harper-app/web/**
+harper-app/lib/**

package/plugins/lisa-harper-fabric-cursor/hooks/block-generated-artifact-edits.sh

@@ -0,0 +1,72 @@
+#!/bin/bash
+# This file is managed by Lisa.
+# Do not edit directly - changes will be overwritten on the next `lisa` run.
+
+# PreToolUse hook: block Write/Edit/MultiEdit on generated Harper deploy
+# artifacts. Harper/Fabric projects build these files from TypeScript under
+# src/, so direct edits are overwritten by the next build and usually ship as
+# no-op fixes.
+# Reference: https://docs.claude.com/en/docs/claude-code/hooks
+# Exit code 2 blocks the tool call and surfaces stderr to Claude.
+
+JSON_INPUT=$(cat)
+
+command -v jq >/dev/null 2>&1 || exit 0
+
+FILE_PATH=$(printf '%s' "$JSON_INPUT" | jq -r '.tool_input.file_path // empty')
+[ -n "$FILE_PATH" ] || exit 0
+
+PLUGIN_ROOT=${CLAUDE_PLUGIN_ROOT:-}
+if [ -z "$PLUGIN_ROOT" ]; then
+  PLUGIN_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+fi
+GLOBS_FILE="$PLUGIN_ROOT/generated-artifact-globs.txt"
+[ -f "$GLOBS_FILE" ] || exit 0
+
+normalize_path() {
+  local path="$1"
+  path="${path#./}"
+  printf '%s' "$path"
+}
+
+matches_glob() {
+  local file="$1"
+  local glob="$2"
+
+  if [ "${glob: -3}" = "/**" ]; then
+    local dir="${glob%/**}"
+    case "$file" in
+      "$dir"/* | */"$dir"/*) return 0 ;;
+    esac
+    return 1
+  fi
+
+  case "$file" in
+    $glob | */$glob) return 0 ;;
+  esac
+
+  return 1
+}
+
+NORMALIZED_FILE=$(normalize_path "$FILE_PATH")
+
+while IFS= read -r glob || [ -n "$glob" ]; do
+  [ -n "$glob" ] || continue
+  case "$glob" in \#*) continue ;; esac
+
+  if matches_glob "$NORMALIZED_FILE" "$glob"; then
+    cat >&2 <<MSG
+Blocked: direct edit to generated Harper/Fabric artifact.
+
+File: $FILE_PATH
+Matched generated artifact pattern: $glob
+
+TypeScript under src/ is the source of truth for Harper resources, web assets,
+and shared libraries. Change the matching TypeScript source under src/ and run
+the project build to regenerate harper-app outputs.
+MSG
+    exit 2
+  fi
+done <"$GLOBS_FILE"
+
+exit 0

package/plugins/lisa-harper-fabric-cursor/hooks/hooks.json

@@ -0,0 +1,11 @@
+{
+  "version": 1,
+  "hooks": {
+    "preToolUse": [
+      {
+        "command": "${CURSOR_PLUGIN_ROOT}/hooks/block-generated-artifact-edits.sh",
+        "matcher": "Write|Edit|MultiEdit"
+      }
+    ]
+  }
+}

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

@@ -1,6 +1,6 @@
 {
   "name": "lisa-nestjs",
-  "version": "2.160.0",
+  "version": "2.162.0",
   "description": "NestJS-specific skills (GraphQL, TypeORM) and hooks (migration write-protection)",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-nestjs/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-nestjs",
-  "version": "2.160.0",
+  "version": "2.162.0",
   "description": "NestJS-specific skills and migration write-protection hooks.",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-nestjs-agy/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-nestjs",
-  "version": "2.160.0",
+  "version": "2.162.0",
   "description": "NestJS-specific skills (GraphQL, TypeORM) and hooks (migration write-protection)",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-nestjs-copilot/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-nestjs",
-  "version": "2.160.0",
+  "version": "2.162.0",
   "description": "NestJS-specific skills (GraphQL, TypeORM) and hooks (migration write-protection)",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-nestjs-cursor/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-nestjs",
-  "version": "2.160.0",
+  "version": "2.162.0",
   "description": "NestJS-specific skills (GraphQL, TypeORM) and hooks (migration write-protection)",
   "author": {
     "name": "Cody Swann"

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

@@ -1,6 +1,6 @@
 {
   "name": "lisa-openclaw",
-  "version": "2.160.0",
+  "version": "2.162.0",
   "description": "Connect staff roles to Telegram or Slack via OpenClaw — facilitator/specialist hub-and-spoke routing and repo-coding topics, for Claude Code and Codex",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-openclaw/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-openclaw",
-  "version": "2.160.0",
+  "version": "2.162.0",
   "description": "Connect staff roles to Telegram or Slack via OpenClaw — facilitator/specialist hub-and-spoke routing and repo-coding topics, across Claude and Codex.",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-openclaw-agy/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-openclaw",
-  "version": "2.160.0",
+  "version": "2.162.0",
   "description": "Connect staff roles to Telegram or Slack via OpenClaw — facilitator/specialist hub-and-spoke routing and repo-coding topics, for Claude Code and Codex",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-openclaw-copilot/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-openclaw",
-  "version": "2.160.0",
+  "version": "2.162.0",
   "description": "Connect staff roles to Telegram or Slack via OpenClaw — facilitator/specialist hub-and-spoke routing and repo-coding topics, for Claude Code and Codex",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-openclaw-cursor/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-openclaw",
-  "version": "2.160.0",
+  "version": "2.162.0",
   "description": "Connect staff roles to Telegram or Slack via OpenClaw — facilitator/specialist hub-and-spoke routing and repo-coding topics, for Claude Code and Codex",
   "author": {
     "name": "Cody Swann"

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

@@ -0,0 +1,35 @@
+{
+  "name": "lisa-phaser",
+  "version": "2.162.0",
+  "description": "Phaser 4 game-development rules for TypeScript projects",
+  "author": {
+    "name": "Cody Swann"
+  },
+  "dependencies": [
+    "lisa-typescript"
+  ],
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/inject-rules.sh"
+          }
+        ]
+      }
+    ],
+    "SubagentStart": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/inject-rules.sh"
+          }
+        ]
+      }
+    ]
+  }
+}

package/plugins/lisa-phaser/.codex-plugin/hooks.json

@@ -0,0 +1,26 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${PLUGIN_ROOT}/hooks/inject-rules.sh"
+          }
+        ]
+      }
+    ],
+    "SubagentStart": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${PLUGIN_ROOT}/hooks/inject-rules.sh"
+          }
+        ]
+      }
+    ]
+  }
+}

package/plugins/lisa-phaser/.codex-plugin/plugin.json

@@ -0,0 +1,30 @@
+{
+  "name": "lisa-phaser",
+  "version": "2.162.0",
+  "description": "Phaser 4 game-development rules for TypeScript projects",
+  "author": {
+    "name": "Cody Swann"
+  },
+  "keywords": [
+    "lisa"
+  ],
+  "dependencies": [
+    "lisa-typescript"
+  ],
+  "skills": "./skills/",
+  "hooks": "./.codex-plugin/hooks.json",
+  "interface": {
+    "displayName": "lisa-phaser",
+    "shortDescription": "Phaser 4 game-development rules for TypeScript projects",
+    "longDescription": "Phaser 4 game-development rules for TypeScript projects",
+    "developerName": "Cody Swann",
+    "category": "Coding",
+    "capabilities": [
+      "Interactive",
+      "Write"
+    ],
+    "defaultPrompt": [
+      "Use lisa-phaser"
+    ]
+  }
+}

package/plugins/lisa-phaser/hooks/inject-rules.sh

@@ -0,0 +1,16 @@
+#!/usr/bin/env bash
+# Reads all .md files from the plugin's rules/ directory and injects them
+# into Claude context at session/subagent start.
+set -euo pipefail
+
+ROOT="${CLAUDE_PLUGIN_ROOT:-${CODEX_PLUGIN_ROOT:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)}}"
+RULES_DIR="$ROOT/rules"
+
+[ -d "$RULES_DIR" ] || exit 0
+
+for rule in "$RULES_DIR"/*.md; do
+  [ -f "$rule" ] || continue
+  printf '\n<lisa-phaser-rule path="%s">\n' "$rule"
+  cat "$rule"
+  printf '\n</lisa-phaser-rule>\n'
+done

package/plugins/lisa-phaser/rules/phaser.md

@@ -0,0 +1,59 @@
+# Phaser 4 Project Rules
+
+This is a **Phaser 4** (v4.1+ "Salusa") TypeScript game project. Phaser 4 is the
+only supported target — never introduce Phaser 3 idioms. The lint config enforces
+the bans below; do not disable those rules, fix the code.
+
+## Phaser 4 Only — Banned v3 Idioms
+
+- **No pipelines.** `setPipeline` / `setPostPipeline` / `resetPipeline` are gone.
+  Custom rendering is a **RenderNode** (registered via `render.renderNodes` in the
+  game config); post-processing is a **Filter** (`gameObject.filters` /
+  `camera.filters`). See the `phaser-rendering` skill.
+- **No preFX/postFX.** The v3 FX controllers were replaced by the unified Filter
+  system. `BitmapMask` → `Mask` filter.
+- **No `setTintFill`/`tintFill`.** Use `setTint()` + `setTintMode(Phaser.TintModes.FILL)`.
+- **No `Phaser.Geom.Point`** (removed — use `Phaser.Math.Vector2`) and **no
+  `Phaser.Struct.Set/Map`** (removed — use native `Set`/`Map`).
+- **No raw WebGL calls.** External GL work goes through the `Extern` game object.
+- **No `setPipeline('Light2D')`.** Lighting is `gameObject.setLighting(true)`.
+
+## Architecture
+
+- **One scene class per file** under `src/scenes/`, named after the scene key.
+  The scene flow is `Boot → Preloader → MainMenu → Game` (plus overlays). Boot
+  loads only what the Preloader needs; the Preloader loads everything else.
+- **Pure game logic lives outside scenes** in `src/logic/` (or `src/core/`) with
+  **no `phaser` imports** — plain TypeScript functions and classes that take and
+  return data. Scenes are thin orchestrators that wire logic to GameObjects.
+  This is what makes the game unit-testable; see the `phaser-testing` skill.
+- **Asset keys are typed constants** in `src/assets.ts` — never inline magic
+  strings for texture/audio/animation keys. Load via asset-pack manifests
+  (`this.load.pack`), not ad-hoc `load.image` lists scattered across scenes.
+
+## Determinism
+
+- **No `Math.random()` in game code.** Use the scene-seeded
+  `Phaser.Math.RandomDataGenerator` (`Phaser.Math.RND` or a local instance with
+  an explicit seed) so replays and tests are reproducible.
+- Arcade physics keeps its v4 default `fixedStep: true`. Do not switch physics to
+  variable step to "fix" a tunneling bug — fix the body/velocity configuration.
+
+## Performance
+
+- **No allocations in `update()`.** No `new`, array literals, closures, or
+  `.filter/.map` chains in per-frame paths — hoist scratch objects, reuse vectors.
+- **Pool, don't churn.** Bullets, enemies, particles, and pickups come from
+  `Group` pools (`get`/`killAndHide`), never `new`/`destroy` per spawn.
+- **Mass rendering uses the GPU layers.** Large static/animated sprite fields →
+  `SpriteGPULayer`; large tile maps → `TilemapGPULayer`. Texture atlases (PCT
+  where possible) over loose images — see the `phaser-assets` skill.
+- Target WebGL; the Canvas renderer is deprecated in v4 and only acceptable as an
+  explicit, documented fallback decision.
+
+## Verification
+
+Before reporting any change complete: run `bun run typecheck`, `bun run test`,
+and `bun run build`. For changes that affect rendering or input, verify in the
+real browser — `bun run dev` plus a Playwright check (the game boots, the canvas
+renders, no console errors). A green typecheck alone is not proof a game works.

package/plugins/lisa-phaser/skills/phaser-assets/SKILL.md

@@ -0,0 +1,96 @@
+---
+name: phaser-assets
+description: This skill should be used when loading or organizing assets in a Phaser 4 game — the Loader (images, texture atlases, spritesheets, audio, fonts), asset-pack manifests via this.load.pack, the new PCT compact atlas format (load.atlasPCT), typed asset keys, and where files live in the Vite project. Use it when adding any asset, restructuring loading, fixing a missing-texture/green-square bug, or optimizing load size. Pairs with phaser-project-structure, phaser-scenes, and phaser-gameobjects.
+---
+
+# Phaser 4 Assets and Loading
+
+## Overview
+
+All runtime assets live under `public/assets/` (served verbatim by Vite — never
+`import` game assets through the bundler) and are loaded by Phaser's Loader in a
+scene's `preload()`. The opinionated pattern: **one asset-pack manifest, loaded
+by the Preloader, with every key defined as a typed constant.**
+
+## Asset packs (the default loading strategy)
+
+A pack is a JSON manifest the Loader consumes wholesale:
+
+```json
+{
+  "main": {
+    "files": [
+      { "type": "atlasPCT", "key": "game-atlas", "url": "atlases/game.pct" },
+      { "type": "image", "key": "background", "url": "images/background.png" },
+      { "type": "audio", "key": "sfx-jump", "url": ["audio/jump.ogg", "audio/jump.m4a"] },
+      { "type": "spritesheet", "key": "explosion", "url": "sheets/explosion.png",
+        "frameConfig": { "frameWidth": 64, "frameHeight": 64 } }
+    ]
+  }
+}
+```
+
+```ts
+// Preloader.preload()
+this.load.pack("game-pack", "assets/pack.json");
+```
+
+Why packs: loading is declared in one reviewable file instead of scattered
+`load.*` calls; adding an asset never touches scene code beyond using the key.
+
+## Texture atlases — the rule, not the suggestion
+
+Individual images break sprite batching. Everything that renders together ships
+in an atlas:
+
+- **PCT (Phaser Compact Texture)** is the preferred v4 atlas format —
+  `this.load.atlasPCT(key, url)` — its manifests are 90–95% smaller than the
+  JSON-hash equivalent. JSON/XML/Unity/multi-atlas loaders still exist for
+  third-party toolchains.
+- Spritesheets (`load.spritesheet`) are acceptable only for uniform-grid
+  animation strips; anything else is an atlas.
+
+## Audio
+
+- Provide at least two encodings (`.ogg` + `.m4a`) in the url array; Phaser
+  picks the first the browser can play.
+- Web Audio is the default manager; it unlocks on first user gesture — never
+  autoplay sound before input (it will silently fail and "work on my machine").
+- Use audio sprites (`load.audioSprite`) for large sets of short SFX.
+
+## Typed keys
+
+Every key lives in `src/assets.ts`:
+
+```ts
+export const Tex = { GameAtlas: "game-atlas", Background: "background" } as const;
+export const Sfx = { Jump: "sfx-jump" } as const;
+export const SceneKeys = { Boot: "Boot", Preloader: "Preloader", Game: "Game" } as const;
+```
+
+Scenes use `Tex.GameAtlas`, never `"game-atlas"` inline. A bad inline key fails
+at runtime as a green square or silent missing audio; a bad constant fails in
+review and in tests that assert the pack manifest covers every constant.
+
+## Loading UX and failure handling
+
+- The Preloader binds `this.load.on("progress", …)` to a progress bar built from
+  Boot-loaded art ([[phaser-project-structure]]).
+- Handle `loaderror`: `this.load.on(Phaser.Loader.Events.FILE_LOAD_ERROR, …)` —
+  log the key and URL; a missing asset must fail loudly in dev, not render as a
+  placeholder in production.
+
+## Project conventions
+
+- `public/assets/` subdirs: `atlases/`, `images/`, `audio/`, `sheets/`, `fonts/`,
+  plus `pack.json` at the root of `assets/`.
+- Generated atlas files (PCT/JSON + PNG pages) are build inputs, committed to the
+  repo; their source art lives wherever the art pipeline keeps it.
+- A test should assert that every key constant in `src/assets.ts` appears in
+  `pack.json` (cheap manifest-coverage check; see [[phaser-testing]]).
+
+## Verification
+
+Asset changes are verified by booting the game and watching the network panel /
+console: every file 200s, no `FILE_LOAD_ERROR`, and the new asset visibly renders
+or audibly plays in the scene that uses it.

package/plugins/lisa-phaser/skills/phaser-assets/agents/openai.yaml

@@ -0,0 +1,4 @@
+display_name: "Phaser Assets"
+short_description: "loading or organizing assets in a Phaser 4 game — the Loader (images, texture atlases, spritesheets, audio, fonts), asset-pack manifests…"
+default_prompt:
+  - "Use $phaser-assets: loading or organizing assets in a Phaser 4 game — the Loader (images, texture atlases, spritesheets, audio, fonts), asset-pack manifests…."