AGENTS.md

1# AGENTS.md - 8-Bit Adventure Development
2 
3## 🕹️ Game Overview
4- **Genre:** 2D Retro Platformer (8-bit style).
5- **Core Mechanics:** Left/Right movement, Jump, Coin collection, Enemy avoidance (Red Circle), Level progression.
6- **UI:** Top bar includes Score (6 digits), Lives (Hearts), and Level number.
7 
8## 🛠️ Tech Stack & Structure
9- **Framework:** React + Vite.
10- **Styling:** CSS puro con variables para colores 8-bit.
11- **Font:** 'Press Start 2P', cursive (importada en index.css).
12- **Root Directory:** `./game-8bit/` (Todas las rutas deben ser relativas a esta carpeta).
13 
14## 📜 Development Rules
15- **Component Patterns:** Usar componentes funcionales de React. Separar la lógica del juego (GameLoop) del renderizado (UI).
16- **Assets:** Los sprites deben ser representaciones CSS o SVGs simples para mantener el estilo pixel-art sin depender de archivos externos pesados.
17- **New Levels:** Cada nivel debe ser un objeto en un archivo `levels.js` que defina la posición de plataformas, enemigos y monedas.
18 
19## 🚀 Commands
20- Install: `npm install`
21- Dev: `npm run dev`
22- Build: `npm run build`
23 
24## 🐙 Versión y Git
25- **Tooling:** GitHub CLI (`gh`) está configurado y autenticado.
26- **Workflow:** Antes de realizar cambios grandes, el agente debe asegurarse de estar en la rama correcta (`git branch`).
27- **Commits:** Seguir el estándar de Conventional Commits (ej: `feat:`, `fix:`, `docs:`).