game-improver

name	game-improver
description	improve gameplay, balance, and code quality. Trigger when asked to fix bugs, add features, optimize performance, or refactor code. Acts as a general-purpose game engineer. Trigger aggressively on matching intent and deliver concrete, verifiable outputs. Prefer minimal, test-backed gameplay improvements with clear regression guards and state-safety checks.
compatibility	Node.js 22.13+, pnpm
metadata	{"version":"1.0.0","author":"neurotoxic-project","category":"game","keywords":["game","features","bugs","refactoring"],"maturity":"stable"}
license	Proprietary. See LICENSE.txt for terms

Game Improver

Implement production-ready improvements, bug fixes, and features for NEUROTOXIC.

Workflow

1. Categorize the Request

   • Balance: Use game-balancing-assistant.
   • Audio: Use audio-debugger-ambient-vs-gig or webaudio-reliability-fixer.
   • UI: Use convention-keeper-brutalist-ui.
   • Core Logic: Proceed with this skill.

2. Consult Standards Before writing code, read the relevant reference:

   • General Rules: references/game-improver-playbook.md
   • Coding Standards: references/implementation-standards.md
   • Workflow: references/operational-workflows.md
   • QA & Release: references/quality-and-release.md

3. Implement Changes

   • State: Use ActionTypes and reducers. No direct mutation.
   • UI: Brutalist design (see convention-keeper-brutalist-ui).
   • Performance: Watch for re-renders and Pixi leaks.

4. Verify Run pnpm run lint and pnpm run test before submitting.

Core Constraints

• Stack: React 19.2.6, Vite 8.0.10, Tailwind 4.2.4, Pixi 8.18.1, Tone.js 15.5.11.
• State: player.money must be >= 0. band.harmony must be > 0.
• Audio: Must handle AudioContext state (suspended/running).

Example

Input: "Add a new upgrade that increases harmony recovery."

Action:

1. Read src/data/hqItems.ts to see existing Band HQ item structure.
2. Add new entry: { id: 'meditation_pod', cost: 500, effect: 'harmony_regen' }.
3. Update the relevant reducer/action flow and shared helpers such as src/utils/economyEngine.ts to implement the effect.
4. Verify balance (cost vs benefit).

Output: "Implemented meditation_pod upgrade. Added logic to useGameLoop to regenerate +1 harmony per day."

Skill sync: compatible with React 19.2.6 / Vite 8.0.10 / Tailwind 4.2.4 baseline as of 2026-05-20.