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 |
Команды
pnpm install— зависимости (Node 22, pnpm 10).pnpm check— всё сразу: типы, линтер, тесты, шапки задач, актуальностьdocs/STATUS.md. Должна быть зелёной перед любым коммитом вmain.pnpm board— доска задач.pnpm status— пересобратьdocs/STATUS.md.pnpm test— только тесты.pnpm format— Prettier.
Чистая разработка (обязательно)
Материалы в research/ только для понимания логики и глубины жанра. В код, данные, тексты и ассеты TERRITORY ничего не переносится: ни код, ни таблицы, ни числа, ни тексты, ни изображения. Числа баланса выводятся заново.
Также запрещены узнаваемые элементы чужих франшиз: Civilization, Warhammer/Games Workshop (grimdark — только как жанр), сказки — только народные/общественное достояние, не образы студий (Disney и т. п.).
Работа с задачами (протокол для двух агентов)
Основная папка проекта всегда стоит на ветке main — это общая точка правды. Работа над задачей идёт только в отдельной рабочей копии в .worktrees/ (папка не в git).
- Взять задачу. В основной папке на
main:git pull/проверить свежесть,pnpm board. Выбрать задачуtodo, у которойownerпуст или равен вам (заранее указанныйowner— это резерв: чужую зарезервированную задачу не брать без согласия пользователя). В шапке поставитьowner(себя) иstatus: doing,pnpm board --check, закоммитить только этот файл прямо вmain:chore(tasks): claim T-0001. Если при коммите оказалось, что задачу уже взяли — выбрать другую. - Рабочая копия.
git worktree add .worktrees/<агент>-T-0001 -b <агент>/T-0001-<slug>(slug — латиницей, напримерclaude/T-0001-m1-plan), затемpnpm installв ней. - Чужие файлы. Не трогать файлы из поля
filesчужой задачи, пока она не закрыта (статусdoing,reviewилиblocked). Нужен общий файл — договориться через пользователя или файл задачи. - Сдать. Заполнить «Заметки» и «Коммиты» в файле задачи,
status: review,pnpm checkзелёный. - Проверка. Изменения в
packages/core, числах баланса (packages/content) иpackages/aiпроверяет второй агент или пользователь; остальное автор может влить сам после зелёногоpnpm check. Квота Codex ограничена — просить проверку осознанно. - Влить. Автор:
git rebase mainв своей ветке,pnpm check, затем в основной папкеgit merge --ff-only <ветка>(история линейная), в файле задачиstatus: doneотдельным коммитом вmain, удалить рабочую копию (git worktree remove). docs/STATUS.mdгенерируется. При конфликте в нём взять любую сторону и выполнитьpnpm status.
Параллельная работа Codex и Claude
- Перед правкой посмотреть текущее состояние (
git status,git log main,pnpm board). Ограничивать правки файлами и участками, нужными для задачи. - В основной папке на
mainкоммитятся только захват задачи,doneи слияния; вся остальная работа — в своей рабочей копии. - Операции в основной папке короткие и по одной: перед каждой —
git status; если там идёт операция второго агента (есть.git/index.lock, незавершённое слияние или незакоммиченные изменения) — дождаться её окончания, не вмешиваться. Для захвата задачи достаточноpnpm board --check; перед слиянием обязателен полныйpnpm check. - Если при
rebaseили слиянии два решения затрагивают один участок и их нельзя совместить однозначно — не выбирать за другого: сообщить пользователю о пересечении с указанием файла и продолжить независимую часть задачи. - Всё, что должен знать второй агент, — в репозитории (файл задачи,
docs/), а не только в переписке. Claude передаёт сообщения Codex черезcodex queue; итог переписки записывается в файл задачи. - В отчёте пользователю указывать изменённые файлы и выполненные проверки.
Правила кода
- TypeScript strict. Тесты — Vitest, рядом с кодом (
*.test.ts). Новое поведение — сначала падающий тест. - Ядро (
packages/*): без DOM; без таймеров и системного времени (setTimeout,Date.now); случайность только через сид-генератор ядра; любое изменение мира — сериализуемая команда; состояние — простые данные (JSON). - ИИ видит только то, что положено видеть его фракции.
- Числа баланса — в
packages/content, не в коде правил. - Прогнозы для интерфейса (ходы до роста, исход боя) считает ядро.
Репозиторий и авторство коммитов
- Удалённый репозиторий:
https://github.com/KrevedkA/territory-2(origin). - Коммиты — только от аккаунта владельца KrevedkA: автор задан в локальном git-конфиге репозитория (
user.name,user.email). Не менять его, не коммитить от другого имени или адреса. - Не добавлять в сообщения коммитов строки соавторства (
Co-Authored-Byи подобные) и упоминания агентов. - Отправка в
origin(git push) — только с разрешения пользователя.
Веб-версия и Cloudflare
- Веб-версия игры публикуется на https://territory.osom.games через Cloudflare Workers со статическими файлами (
apps/client/wrangler.jsonc, собственный домен). Выкладка:pnpm deploy:webс переменными из.env.local. - Доступ к Cloudflare — только через
npx wrangler loginпользователя или переменныеCLOUDFLARE_API_TOKENиCLOUDFLARE_ACCOUNT_IDиз файла.env.local(не в git). - Секреты никогда не попадают в репозиторий, сообщения коммитов, задачи, документы, логи и переписку; не выводить их на экран.
- Публикация на домен — только с разрешения пользователя; перед публикацией
pnpm checkзелёный.
Язык и оформление
- Код, идентификаторы, комментарии, сообщения коммитов — английский. Документация и задачи — русский. Интерфейс игры — английский через систему локализации.
- Коммиты:
type(scope): summary(feat,fix,chore,docs,test,refactor).
Решения и дизайн
- Архитектурное решение — новая запись в
docs/decisions/по шаблону_template.md. - Игровой дизайн — в
docs/game/<система>.mdпо шаблону_template.md(любой.mdвdocs/game/обязан иметь шапку, иначеpnpm checkупадёт); после изменения статуса —pnpm status. - Каждый созданный ИИ файл графики, музыки или звука записывается в
assets/ATTRIBUTION.md(что, каким инструментом, дата) — Steam требует раскрытия. - Агенты предлагают черновой дизайн (
designed) и строят по нему; пользователь утверждает пачками. Решения пользователя записываются в раздел «Решения пользователя» документа системы.