phaser4-gamedev

Analyze an existing Phaser project for architecture quality, performance risks, and improvement opportunities

Build the Phaser game for production

Create a comprehensive Game Design Document (GDD) for a Phaser 4 game. The optional argument specifies the game genre to tailor the document.

Create a new Phaser 4 game project. The optional argument specifies the game template archetype.

Start the Phaser dev server

Use this agent when the user asks to "design a game", "plan game architecture", "structure my Phaser game", "plan scene flow", "design game state management", "what scenes do I need", "organize my game project", or needs help deciding how to organize a Phaser 4 project before coding. <example> Context: User wants to plan a new game from scratch user: "I want to build a platformer game with Phaser 4. Help me plan the architecture." assistant: "I'll use the phaser-architect agent to design the game architecture." <commentary> User asking for game planning/architecture before coding — trigger phaser-architect. </commentary> </example> <example> Context: User asking what scenes they need user: "What scenes do I need for a match-3 puzzle game?" assistant: "I'll use the phaser-architect agent to design the scene flow and game structure." <commentary> Scene planning for a specific game type — trigger phaser-architect. </commentary> </example> <example> Context: User has a messy existing project user: "My Phaser game is getting messy. How should I organize the scenes and state?" assistant: "I'll use the phaser-architect agent to analyze the project and propose better structure." <commentary> Architectural refactoring of existing Phaser project — trigger phaser-architect. </commentary> </example>

Use this agent when the user asks about "sprite sheets", "texture atlases", "loading assets", "tile maps", "audio formats", "asset optimization", "preloading", "loading bar", "game assets slow", "too many images", "how to load fonts", "bitmap fonts", "find free game assets", "game asset tools", "where to get sprites", "create game art", "generate sound effects", "asset creation tools", "free asset packs", "asset pipeline", "placeholder to production", or needs help organizing, loading, or optimizing any game assets in Phaser 4. <example> Context: User needs asset organization advice user: "How should I organize and load my game sprites?" assistant: "I'll use the phaser-asset-advisor agent to design the asset pipeline." <commentary> Asset organization question — trigger phaser-asset-advisor. </commentary> </example> <example> Context: Performance from too many individual images user: "My game loads too slowly. I have 200 individual sprite PNG files." assistant: "I'll use the phaser-asset-advisor agent to optimize the loading strategy." <commentary> Asset performance optimization — trigger phaser-asset-advisor. </commentary> </example> <example> Context: Setting up a preloader user: "How do I make a loading bar that shows progress while assets load?" assistant: "I'll use the phaser-asset-advisor agent to implement the PreloaderScene with progress tracking." <commentary> Preloader scene implementation — trigger phaser-asset-advisor. </commentary> </example>

Use this agent when the user asks to "code a game feature", "implement a scene", "add a player", "create game logic", "write Phaser code", "add enemies", "implement movement", "add scoring", "create animations", "implement shooting", "add collectibles", "create a game object", or needs any Phaser 4 game code written or modified. <example> Context: User wants to implement player movement user: "Add a player character that can jump and move left/right with arrow keys" assistant: "I'll use the phaser-coder agent to implement the player with arcade physics and keyboard input." <commentary> Core game feature implementation — trigger phaser-coder. </commentary> </example> <example> Context: User wants animations on a sprite user: "Create walking, idle, and jump animations for my player sprite" assistant: "I'll use the phaser-coder agent to set up the sprite animation system." <commentary> Animation creation is game code — trigger phaser-coder. </commentary> </example> <example> Context: User wants a complete gameplay scene user: "Write the GameScene for a top-down shooter with enemies that chase the player" assistant: "I'll use the phaser-coder agent to build the GameScene with enemy AI and player mechanics." <commentary> Full scene implementation — trigger phaser-coder. </commentary> </example> <example> Context: User wants to implement scoring user: "Add a coin collection system with score tracking that persists across scenes" assistant: "I'll use the phaser-coder agent to implement coin collection and score management." <commentary> Game mechanics with cross-scene state — trigger phaser-coder. </commentary> </example>

Use this agent when the user reports a "Phaser bug", "game not working", "black screen", "sprite not showing", "physics not working", "collision not detected", "animation not playing", "game crashes", "error in console", "performance problems", "slow game", or any Phaser 4 runtime issue, unexpected behavior, or error message. <example> Context: Classic black screen issue user: "My game shows a black screen when I start it" assistant: "I'll use the phaser-debugger agent to diagnose the black screen." <commentary> Black screen is one of the most common Phaser issues — trigger phaser-debugger. </commentary> </example> <example> Context: Physics failure user: "My player falls through the floor even though I have platforms" assistant: "I'll use the phaser-debugger agent to investigate the collision setup." <commentary> Physics/collision bug — trigger phaser-debugger. </commentary> </example> <example> Context: v3 migration error user: "I upgraded to Phaser 4 and now I get 'Phaser.Geom.Point is not a constructor'" assistant: "I'll use the phaser-debugger agent to fix the v3 API usage." <commentary> Known Phaser 4 breaking change — trigger phaser-debugger. </commentary> </example> <example> Context: Runtime error user: "I'm getting 'Cannot read properties of undefined (reading body)' when my sprite collides" assistant: "I'll use the phaser-debugger agent to trace the undefined body error." <commentary> Runtime error in Phaser game — trigger phaser-debugger. </commentary> </example>

This skill should be used when the user asks to "analyze my game", "review my Phaser project", "audit project health", "find bottlenecks", "refactor my game", "improve my code", "optimize my project", "what's wrong with my game", "code review Phaser", or "assess architecture".

This skill should be used when the user asks to "create animation", "animate sprite", "add tweens", "sprite animation not playing", "character animations", "easing", "tween timeline", "idle animation", "walk animation", "fade in", "fade out", or "scale animation".

This skill should be used when the user asks to design a Phaser 4 game, plan game architecture, structure scenes, organize game state, define scene flow, choose module boundaries, or review/refactor an existing Phaser project architecture before implementation.

This skill should be used when the user asks about Phaser 4 asset loading, sprite sheets, texture atlases, image optimization, preloader scenes, loading bars, tile map assets, audio formats, bitmap fonts, free game assets, generated placeholder assets, asset organization, or asset pipeline performance.

This skill should be used when the user asks to "add sound", "play music", "audio not working", "add background music", "sound effects", "mute button", "audio sprite", "game audio", "play sound effect", or "music won't play".

2 hooks across 2 events