# Пепельные луга — изометрическая пиксельная RPG

Собственный жанронезависимый движок (`packages/engine`, TypeScript, PixiJS 8
только как рендер-бэкенд) и игра на нём (`apps/game`). Движок и инструментарий
делаются для работы ИИ-агента: детерминированный шаг, агентный мост
(`window.__agent`), runtime-валидация контента, CLI-проверки.

Начни с `CLAUDE.md` в корне (команды, архитектура, грабли) и
`docs/engine/practices.md` (приёмы по ситуациям). Проверка любого изменения:
`node tools/agent.mjs check --pretty`.

## Движок

- [README движка](engine/README.md): архитектура и принципы, карта модулей.
- [Начало работы](engine/getting-started.md): Engine, GameLoop, сцены, первый запуск.
- [Ядро](engine/core.md): GameLoop, GameState, Settings, EventBus, Tween.
- [Рендер](engine/render.md): Renderer, Camera, IsoDepthLayer, Particles, pixel-perfect масштаб.
- [Ввод](engine/input.md): действия, геймпад, VirtualJoystick, инъекция ввода.
- [Карты](engine/maps.md): изометрия, A*, формат rpg-map, Tiled-импорт.
- [UI и диалоги](engine/ui-and-dialogue.md): PixelText, Panel, Button, MenuList, DialogueBox, DialogueRunner.
- [Кат-сцены](engine/cutscene.md): раннер кат-сцен.
- [Ассеты, аудио, сейвы](engine/assets-audio-save.md): AssetLoader, атласы, шины аудио, SaveManager.
- [Пайплайн арта](engine/art-pipeline.md): генератор пиксель-арта, палитра, атласы.
- [Рецепты](engine/recipes.md): короткие «как сделать X».
- [Агентный мост](engine/agent.md): EngineAgent, window.__agent, waitFor, валидация контента, tools/agent.mjs.

## Инструменты агента

- [Практики](engine/practices.md): живой документ приёмов по ситуациям агента; пополняется в каждом коммите.
- `tools/agent.mjs`: CLI check/run/snapshot/screenshot/dev (JSON по умолчанию).
- `tools/agent-lib.mjs`: openGame, AgentClient, Checks — каркас сценариев.
- `tools/checks/*.mjs`: сценарии проверки геймплейных систем через мост.

## Мир и арт

- [Библия мира](world.md): сеттинг, локации, персонажи, сюжет — сверять любой новый контент.
- [Арт-библия](art-style.md): палитра 32 цвета, размеры спрайтов, правила стиля.
- [Срез демо](demo.md): матрица «подсистема → где показана», статус, дорожная карта.