# AGENTS.md

Repo de práctica: clon de Pac-Man (Vanilla JS + Canvas) usado para aprender
Spec Driven Development. No hay build, no hay tests, no hay linter.

## Stack
- HTML + CSS + Vanilla JS, sin dependencias ni package.json.
- Todo se ejecuta desde `src/index.html`. Se puede abrir directamente
  en el navegador (`file://`) — no usa módulos ES ni fetch.

## Cómo correrlo
- Abrir `src/index.html` en un navegador, o servir la carpeta `src/` con
  cualquier servidor estático (`python3 -m http.server` desde `src/`).
- Controles: flechas del teclado. Botón Start en el overlay.

## Estructura de `src/`
- `index.html` — canvas `#game`, overlay `#overlay`, y carga los scripts
  en este orden estricto (es importante):
  1. `js/maze.js`   — expone `window.MAZE`, `TUNNEL_ROW`, `PACMAN_START`, `GHOST_STARTS`
  2. `js/game.js`   — expone `window.createGame`, `window.update`, `window.DIRS`
  3. `js/render.js` — expone `window.draw`
  4. `js/main.js`   — bucle, teclado, overlays (lee los globales de los anteriores)
- Los scripts se comunican por `window.*` (no por imports). No convertir
  a módulos ES sin refactorizar las 4 capas.
- `MAZE` (en `maze.js`) es la matriz prístina del laberinto (28×31).
  `createGame()` la clava con `.map(row => row.slice())` por partida.
  No mutar `MAZE` directamente.

## Convenciones de código
- Los archivos existentes usan comillas simples y espacios dentro de los
  paréntesis (`function ( x )`, `'left'`). Mantener ese estilo al editar.
- Los archivos JS sí llevan comentarios explicativos por sección
  (a diferencia de la regla global por defecto). No quitarlos al editar
  a menos que el usuario lo pida.
- El render dibuja a `TILE = 20` px sobre el canvas de 560×620.
  Cambiar `TILE` rompe el layout (CSS `#game-wrap` está dimensionado
  a 560×620).

## Flujo de trabajo: Spec Driven Development
- Este proyecto existe para practicar SDD. Antes de añadir funcionalidad
  usar el skill `.agents/skills/spec` (`/spec`) y guardar el resultado
  en `specs/`. Para implementar a partir de un spec ya escrito, usar
  `.agents/skills/spec-impl` (`/spec-impl`).
- `specs/` aún no existe; crearlo al primer spec.
- El template vive en `.agents/skills/spec/template.md`.

## Lo que NO hacer
- No añadir `package.json`, bundler, framework, ni dependencias.
- No convertir los `<script>` a módulos ES sin refactorizar — el orden
  de carga y los globales en `window` son parte del diseño actual.
- No introducir tests automatizados, linter ni CI sin que el usuario
  lo pida: el repo está deliberadamente vacío de tooling.
- No correr `npm install` ni similares — no hay nada que instalar.