forgecraft-mcp 1.2.0 → 1.4.0

package/templates/game/review.yaml

@@ -1,97 +1,97 @@
-tag: GAME
-section: review
-blocks:
-  - id: game-architecture-review
-    tier: recommended
-    dimension: architecture
-    title: "Game Architecture Review"
-    description: |
-      Evaluate scene structure, ECS separation, and dependency flow.
-    checklist:
-      - id: scene-responsibility
-        description: "Each Scene has a single responsibility. No god-scenes mixing physics, AI, UI, and audio logic."
-        severity: critical
-      - id: ecs-separation
-        description: "Entities are IDs, components are plain data, systems have no state. No logic in component structs."
-        severity: important
-      - id: no-scene-coupling
-        description: "Scenes communicate via EventEmitter or registry only. No direct scene-to-scene instance references."
-        severity: critical
-      - id: dependency-injection
-        description: "Services (audio manager, save system, analytics) injected via game registry. No module-level singletons."
-        severity: important
-      - id: worker-offload
-        description: "CPU-heavy tasks (pathfinding, procedural gen, physics sim) run in Web Workers, not the main thread."
-        severity: nice-to-have
-
-  - id: game-code-quality-review
-    tier: recommended
-    dimension: code-quality
-    title: "Game Code Quality Review"
-    description: |
-      Evaluate update loop cleanliness, resource handling, and input abstraction.
-    checklist:
-      - id: no-alloc-in-hot-path
-        description: "Zero object allocations in the update() hot path. Object pools used for bullets, particles, tweens."
-        severity: critical
-      - id: resource-disposal
-        description: "All GPU resources (textures, geometries, materials, render targets) explicitly disposed on scene exit."
-        severity: critical
-      - id: input-abstraction
-        description: "Physical inputs mapped to logical actions via a config-driven action map. No raw key codes in game logic."
-        severity: important
-      - id: asset-manifest
-        description: "All asset paths and keys defined in a central manifest (assets.ts). No inline path strings scattered across scenes."
-        severity: important
-      - id: magic-numbers
-        description: "No magic numbers in game logic. Physics constants, speeds, and thresholds are named constants in config.ts."
-        severity: important
-      - id: fixed-timestep
-        description: "Game logic uses a fixed timestep. Rendering interpolates. No deltaTime passed directly into physics equations."
-        severity: critical
-
-  - id: game-performance-review
-    tier: recommended
-    dimension: performance
-    title: "Game Performance Review"
-    description: |
-      Evaluate draw-call count, GPU memory, and frame-time budget.
-    checklist:
-      - id: draw-call-budget
-        description: "Draw calls per frame within budget: < 50 for mobile web, < 200 for desktop. Verified via renderer stats overlay."
-        severity: critical
-      - id: atlas-usage
-        description: "Sprites use texture atlases. No individual per-sprite texture binds in hot rendering paths."
-        severity: critical
-      - id: gpu-resource-leaks
-        description: "Scene transition profile shows GPU memory returning to baseline after 3+ transitions (no accumulating leaks)."
-        severity: critical
-      - id: frame-budget-profiled
-        description: "JS CPU time < 6ms per frame on target hardware (profiled with Chrome DevTools, not emulation)."
-        severity: important
-      - id: mobile-tested
-        description: "Tested on real mid-range Android device (not DevTools emulation). Frame rate meets mobile NFR target."
-        severity: important
-      - id: instanced-rendering
-        description: "Repeated geometry (tiles, crowds, bullets) uses InstancedMesh (Three.js) or ParticleContainer (PixiJS)."
-        severity: important
-
-  - id: game-test-review
-    tier: recommended
-    dimension: tests
-    title: "Game Test Review"
-    description: |
-      Evaluate test coverage for deterministic systems and scene lifecycle.
-    checklist:
-      - id: system-unit-tests
-        description: "Game systems (movement, collision, AI state machine) have unit tests that run without a canvas or DOM."
-        severity: critical
-      - id: fixed-timestep-determinism
-        description: "Determinism test: same input sequence produces identical game state across 10 simulated minutes."
-        severity: important
-      - id: scene-lifecycle-tests
-        description: "Integration tests cover scene create → update → destroy lifecycle, verifying no resource leaks."
-        severity: important
-      - id: input-replay-tests
-        description: "Critical game scenarios (player death, level completion) covered by recorded input replay tests."
-        severity: nice-to-have
+tag: GAME
+section: review
+blocks:
+  - id: game-architecture-review
+    tier: recommended
+    dimension: architecture
+    title: "Game Architecture Review"
+    description: |
+      Evaluate scene structure, ECS separation, and dependency flow.
+    checklist:
+      - id: scene-responsibility
+        description: "Each Scene has a single responsibility. No god-scenes mixing physics, AI, UI, and audio logic."
+        severity: critical
+      - id: ecs-separation
+        description: "Entities are IDs, components are plain data, systems have no state. No logic in component structs."
+        severity: important
+      - id: no-scene-coupling
+        description: "Scenes communicate via EventEmitter or registry only. No direct scene-to-scene instance references."
+        severity: critical
+      - id: dependency-injection
+        description: "Services (audio manager, save system, analytics) injected via game registry. No module-level singletons."
+        severity: important
+      - id: worker-offload
+        description: "CPU-heavy tasks (pathfinding, procedural gen, physics sim) run in Web Workers, not the main thread."
+        severity: nice-to-have
+
+  - id: game-code-quality-review
+    tier: recommended
+    dimension: code-quality
+    title: "Game Code Quality Review"
+    description: |
+      Evaluate update loop cleanliness, resource handling, and input abstraction.
+    checklist:
+      - id: no-alloc-in-hot-path
+        description: "Zero object allocations in the update() hot path. Object pools used for bullets, particles, tweens."
+        severity: critical
+      - id: resource-disposal
+        description: "All GPU resources (textures, geometries, materials, render targets) explicitly disposed on scene exit."
+        severity: critical
+      - id: input-abstraction
+        description: "Physical inputs mapped to logical actions via a config-driven action map. No raw key codes in game logic."
+        severity: important
+      - id: asset-manifest
+        description: "All asset paths and keys defined in a central manifest (assets.ts). No inline path strings scattered across scenes."
+        severity: important
+      - id: magic-numbers
+        description: "No magic numbers in game logic. Physics constants, speeds, and thresholds are named constants in config.ts."
+        severity: important
+      - id: fixed-timestep
+        description: "Game logic uses a fixed timestep. Rendering interpolates. No deltaTime passed directly into physics equations."
+        severity: critical
+
+  - id: game-performance-review
+    tier: recommended
+    dimension: performance
+    title: "Game Performance Review"
+    description: |
+      Evaluate draw-call count, GPU memory, and frame-time budget.
+    checklist:
+      - id: draw-call-budget
+        description: "Draw calls per frame within budget: < 50 for mobile web, < 200 for desktop. Verified via renderer stats overlay."
+        severity: critical
+      - id: atlas-usage
+        description: "Sprites use texture atlases. No individual per-sprite texture binds in hot rendering paths."
+        severity: critical
+      - id: gpu-resource-leaks
+        description: "Scene transition profile shows GPU memory returning to baseline after 3+ transitions (no accumulating leaks)."
+        severity: critical
+      - id: frame-budget-profiled
+        description: "JS CPU time < 6ms per frame on target hardware (profiled with Chrome DevTools, not emulation)."
+        severity: important
+      - id: mobile-tested
+        description: "Tested on real mid-range Android device (not DevTools emulation). Frame rate meets mobile NFR target."
+        severity: important
+      - id: instanced-rendering
+        description: "Repeated geometry (tiles, crowds, bullets) uses InstancedMesh (Three.js) or ParticleContainer (PixiJS)."
+        severity: important
+
+  - id: game-test-review
+    tier: recommended
+    dimension: tests
+    title: "Game Test Review"
+    description: |
+      Evaluate test coverage for deterministic systems and scene lifecycle.
+    checklist:
+      - id: system-unit-tests
+        description: "Game systems (movement, collision, AI state machine) have unit tests that run without a canvas or DOM."
+        severity: critical
+      - id: fixed-timestep-determinism
+        description: "Determinism test: same input sequence produces identical game state across 10 simulated minutes."
+        severity: important
+      - id: scene-lifecycle-tests
+        description: "Integration tests cover scene create → update → destroy lifecycle, verifying no resource leaks."
+        severity: important
+      - id: input-replay-tests
+        description: "Critical game scenarios (player death, level completion) covered by recorded input replay tests."
+        severity: nice-to-have

package/templates/game/structure.yaml

@@ -1,67 +1,67 @@
-tag: GAME
-section: structure
-language: typescript
-entries:
-  - path: src/scenes
-    type: directory
-    description: "One file per game scene (Boot, Preload, Menu, Game, UI, GameOver)"
-  - path: src/scenes/BootScene.ts
-    type: file
-    description: "Registry setup, global config injection, first scene"
-  - path: src/scenes/PreloadScene.ts
-    type: file
-    description: "All asset loading with progress bar; transitions to MenuScene"
-  - path: src/scenes/GameScene.ts
-    type: file
-    description: "Core gameplay loop; delegates to systems, not self-contained"
-  - path: src/scenes/UIScene.ts
-    type: file
-    description: "HUD overlay launched in parallel with GameScene"
-  - path: src/systems
-    type: directory
-    description: "Stateless systems operating on entities (physics, AI, collision)"
-  - path: src/systems/MovementSystem.ts
-    type: file
-    description: "Processes velocity and position components each tick"
-  - path: src/systems/CollisionSystem.ts
-    type: file
-    description: "Broad + narrow phase collision; emits collision events"
-  - path: src/entities
-    type: directory
-    description: "Entity factory functions and typed component interfaces"
-  - path: src/entities/Player.ts
-    type: file
-    description: "Player entity factory — assembles components, registers with world"
-  - path: src/components
-    type: directory
-    description: "Plain-data component interfaces (Position, Velocity, Health, Sprite)"
-  - path: src/assets.ts
-    type: file
-    description: "Central asset manifest — all keys, paths, and atlas definitions"
-  - path: src/config.ts
-    type: file
-    description: "Game config constants (canvas size, physics gravity, scene keys)"
-  - path: src/shaders
-    type: directory
-    description: "GLSL shader source files (Three.js / raw WebGL projects)"
-  - path: src/workers
-    type: directory
-    description: "Web Workers for physics, pathfinding, or procedural generation"
-  - path: public/assets
-    type: directory
-    description: "Raw game assets (atlases, audio, tilemaps) served at /assets/"
-  - path: public/assets/atlases
-    type: directory
-    description: "Texture atlas PNG + JSON descriptor files"
-  - path: public/assets/audio
-    type: directory
-    description: "SFX and music in ogg + mp3 pairs for cross-browser support"
-  - path: public/assets/tilemaps
-    type: directory
-    description: "Tiled map JSON exports and associated tilesets"
-  - path: tests/systems
-    type: directory
-    description: "Unit tests for deterministic game systems (no DOM / canvas required)"
-  - path: tests/integration
-    type: directory
-    description: "Scene lifecycle and input simulation integration tests"
+tag: GAME
+section: structure
+language: typescript
+entries:
+  - path: src/scenes
+    type: directory
+    description: "One file per game scene (Boot, Preload, Menu, Game, UI, GameOver)"
+  - path: src/scenes/BootScene.ts
+    type: file
+    description: "Registry setup, global config injection, first scene"
+  - path: src/scenes/PreloadScene.ts
+    type: file
+    description: "All asset loading with progress bar; transitions to MenuScene"
+  - path: src/scenes/GameScene.ts
+    type: file
+    description: "Core gameplay loop; delegates to systems, not self-contained"
+  - path: src/scenes/UIScene.ts
+    type: file
+    description: "HUD overlay launched in parallel with GameScene"
+  - path: src/systems
+    type: directory
+    description: "Stateless systems operating on entities (physics, AI, collision)"
+  - path: src/systems/MovementSystem.ts
+    type: file
+    description: "Processes velocity and position components each tick"
+  - path: src/systems/CollisionSystem.ts
+    type: file
+    description: "Broad + narrow phase collision; emits collision events"
+  - path: src/entities
+    type: directory
+    description: "Entity factory functions and typed component interfaces"
+  - path: src/entities/Player.ts
+    type: file
+    description: "Player entity factory — assembles components, registers with world"
+  - path: src/components
+    type: directory
+    description: "Plain-data component interfaces (Position, Velocity, Health, Sprite)"
+  - path: src/assets.ts
+    type: file
+    description: "Central asset manifest — all keys, paths, and atlas definitions"
+  - path: src/config.ts
+    type: file
+    description: "Game config constants (canvas size, physics gravity, scene keys)"
+  - path: src/shaders
+    type: directory
+    description: "GLSL shader source files (Three.js / raw WebGL projects)"
+  - path: src/workers
+    type: directory
+    description: "Web Workers for physics, pathfinding, or procedural generation"
+  - path: public/assets
+    type: directory
+    description: "Raw game assets (atlases, audio, tilemaps) served at /assets/"
+  - path: public/assets/atlases
+    type: directory
+    description: "Texture atlas PNG + JSON descriptor files"
+  - path: public/assets/audio
+    type: directory
+    description: "SFX and music in ogg + mp3 pairs for cross-browser support"
+  - path: public/assets/tilemaps
+    type: directory
+    description: "Tiled map JSON exports and associated tilesets"
+  - path: tests/systems
+    type: directory
+    description: "Unit tests for deterministic game systems (no DOM / canvas required)"
+  - path: tests/integration
+    type: directory
+    description: "Scene lifecycle and input simulation integration tests"