CLAUDE.md

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

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

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

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

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>.