# CLAUDE.md

**Всегда общайся с пользователем на русском.**

Этот репозиторий — две версии игрового движка (фокус работы: **движок и
инструментарий для ИИ-агента**; игра — лишь демо-полигон):

- **`v1/`** — действующий черновик движка (`@rpg/engine`, PixiJS-бэкенд,
  изометрическая демо-RPG «Пепельные луга»). Чинится и допиливается без
  больших рефакторингов. **Полный маниал: `v1/CLAUDE.md`** — команды,
  архитектура, грабли. Работая в `v1/`, сверяйся с ним.
- **`v2/`** — воксельный движок (three.js как низкоуровневый бэкенд).
  Направление и решения: `docs/plan.md`, разделы «Уроки черновика →
  видение движка v2» и «Направление v2». **Маниал: `v2/CLAUDE.md`.**

## Команды (работают от корня репо)

```bash
npm run check:fast    # v1: typecheck + guard + тесты (делегирует --prefix v1)
npm run agent:check   # v1: полный прогон агентных проверок через мост
npm test              # v1: юнит-тесты
npm run dev           # v1: dev-сервер демо
```

Команды v2 — см. `v2/CLAUDE.md`.

## Доки

- `docs/plan.md` — живой план (актуальные задачи, видение v2).
- `docs/llms.txt`, `docs/engine/`, `docs/demo.md` — доки v1.
- `docs/world.md`, `docs/art-style.md` — библия мира и арта демки v1.

## Рабочие привычки

- Для задач из 3+ шагов веди список задач и иди по нему автономно.
- Комментарии и докстринги — по-русски; хелперы до ~70 строк.
- Изменения API движка — с обновлением док в том же коммите.
- Коммиты: в конце сообщения `Co-Authored-By: Claude Code <noreply@anthropic.com>`.