TERRITORY — правила для агентов (Claude Code и Codex)

Единый источник правил проекта для всех агентов. CLAUDE.md только ссылается сюда — правила не дублируются.

Что за проект

Собственная пошаговая 4X-стратегия на квадратной сетке в формате первой Civilization, но с полностью своим содержимым: гильдии вместо стран (сказочная, космическая, пришельцы-НЛО, мрачная «земная»), общая лестница эпох от основания до звёзд, одиночная игра против ИИ. Цель — Steam Early Access (2 гильдии), затем релиз Steam + App Store.

Главный документ: docs/specs/2026-11-17-territory-design.md. Карта документации: docs/README.md.

Где что лежит

Путь Что там
packages/core Правила игры: состояние, команды, ход. Чистый TS, без DOM, без Math.random
packages/content Данные игры: местность, юниты, постройки, исследования, гильдии
packages/ai Компьютерные противники
packages/sim Безголовые симуляции партий (баланс, регрессии)
apps/client Отрисовка (PixiJS + HTML/CSS), ввод, звук, обучение
docs/specs/ Дизайн-документы проекта
docs/game/ Дизайн игры по системам; статус — в шапке файла
docs/decisions/ Журнал архитектурных решений
docs/plans/ Планы реализации этапов
docs/STATUS.md Карта статусов систем (генерируется)
docs/GLOSSARY.md Термины: игровой термин ↔ имя в коде
tasks/ Задачи: один файл = одна задача, имя T-0001-slug.md
scripts/ Утилиты проекта: board, status
assets/ Графика и звук игры; assets/ATTRIBUTION.md — учёт созданного ИИ
research/ Старые исследования. Только чтение, не в git

Команды

Чистая разработка (обязательно)

Материалы в research/ только для понимания логики и глубины жанра. В код, данные, тексты и ассеты TERRITORY ничего не переносится: ни код, ни таблицы, ни числа, ни тексты, ни изображения. Числа баланса выводятся заново.

Также запрещены узнаваемые элементы чужих франшиз: Civilization, Warhammer/Games Workshop (grimdark — только как жанр), сказки — только народные/общественное достояние, не образы студий (Disney и т. п.).

Работа с задачами (протокол для двух агентов)

Основная папка проекта всегда стоит на ветке main — это общая точка правды. Работа над задачей идёт только в отдельной рабочей копии в .worktrees/ (папка не в git).

  1. Взять задачу. В основной папке на main: git pull/проверить свежесть, pnpm board. Выбрать задачу todo, у которой owner пуст или равен вам (заранее указанный owner — это резерв: чужую зарезервированную задачу не брать без согласия пользователя). В шапке поставить owner (себя) и status: doing, pnpm board --check, закоммитить только этот файл прямо в main: chore(tasks): claim T-0001. Если при коммите оказалось, что задачу уже взяли — выбрать другую.
  2. Рабочая копия. git worktree add .worktrees/<агент>-T-0001 -b <агент>/T-0001-<slug> (slug — латиницей, например claude/T-0001-m1-plan), затем pnpm install в ней.
  3. Чужие файлы. Не трогать файлы из поля files чужой задачи, пока она не закрыта (статус doing, review или blocked). Нужен общий файл — договориться через пользователя или файл задачи.
  4. Сдать. Заполнить «Заметки» и «Коммиты» в файле задачи, status: review, pnpm check зелёный.
  5. Проверка. Изменения в packages/core, числах баланса (packages/content) и packages/ai проверяет второй агент или пользователь; остальное автор может влить сам после зелёного pnpm check. Квота Codex ограничена — просить проверку осознанно.
  6. Влить. Автор: git rebase main в своей ветке, pnpm check, затем в основной папке git merge --ff-only <ветка> (история линейная), в файле задачи status: done отдельным коммитом в main, удалить рабочую копию (git worktree remove).
  7. docs/STATUS.md генерируется. При конфликте в нём взять любую сторону и выполнить pnpm status.

Параллельная работа Codex и Claude

Правила кода

Репозиторий и авторство коммитов

Веб-версия и Cloudflare

Язык и оформление

Решения и дизайн