Ebitengine 2D Game Development Guide (ebitengineer)

Comprehensive, genre-agnostic engineering guidelines for building modular, high-performance, cross-platform 2D games (top-down, tactics, shmup, puzzle, isometric, and platformer) in Go using Ebitengine v2.

Trigger Conditions

Activate this skill whenever:

• Designing or implementing 2D game architecture, scene flow, camera systems, or rendering pipelines in Go.
• Working with Ebitengine interfaces (ebiten.Game), state machines, input management, audio, Kage shaders, or ebiten/v2/text/v2 typography.
• Optimizing cycle timing, WASM audio synchronization, build-tagged save persistence, Cloud Run hosting, or writing unit tests for Go game components.

Core Architecture & Fail-Fast Engineering Rules

1. Modular Architecture (internal/)

Organize the codebase into modular subsystems under internal/. Never build monolithic single-file games.

• For the complete directory tree and package responsibilities, see references/project_structure.md.