TERRITORY — дизайн проекта
Дата: 2026-11-17 · Статус: черновик на утверждение · Авторы: пользователь + Claude Code (обсуждение), разработка совместно с Codex.
Пометка [решение пользователя] — решено в обсуждении. [предложение Claude] — моё решение по умолчанию, пользователь может поправить. [строителю] — решает исполнитель при планировании.
1. Что это и зачем
TERRITORY — собственная пошаговая 4X-стратегия на квадратной сетке в формате первой Civilization: от первого поселения до полёта к звёздам, города обрабатывают клетки вокруг, дерево исследований, дипломатия, война, чудеса, долгая партия против компьютера. [решение пользователя]
Зачем: сохранить формат и глубину, которые пользователь любит в Civ1, но сделать полностью свою игру — не хуже оригинала, в идеале интереснее — и выпустить её в Steam и App Store с минимальным риском претензий и снятия. [решение пользователя]
Мир: игрок выбирает гильдию (аналог страны/нации). Гильдия задаёт его «мир»: облик городов, юнитов, героев, свои особенности. Темы гильдий: сказочные герои, космос и фантастика, пришельцы на НЛО, мрачный индустриальный «земной» мир. Общий тон — эпический grimdark. [решение пользователя]
2. Цели, не-цели, анти-цели
Цели
- Формат Civ1: квадратная сетка, города с обрабатываемыми клетками, еда/производство/торговля, исследования, правительства/порядок, дипломатия, война, чудеса, эпохи, космическая победа.
- Своё содержимое целиком: названия, графика, тексты, музыка, дерево исследований, юниты, постройки, формулы и числа.
- Быстрое освоение: глубина остаётся, но игра учит себя сама (обучение, подсказки, объяснение причин и прогнозов в интерфейсе). [решение пользователя]
- Порядок: локальный прототип → доводка до идеала → расширение → релиз Steam (Windows/macOS) + App Store (iPhone/iPad). [решение пользователя]
- Кодовая база и задачи организованы так, чтобы при росте проекта сразу было понятно, что есть что и в каком статусе, и было легко дорабатывать (раздел 8). [решение пользователя]
Не-цели (в этой версии)
- Сетевая игра — в будущих версиях. [решение пользователя] Но ядро проектируется так, чтобы её можно было добавить без переписывания (раздел 6).
- Android, Linux — не в первой версии. [предложение Claude]: стек их не исключает.
- Точное воспроизведение правил, баланса, таблиц, экранов или поведения Civilization I.
Анти-цели (провал, даже если «работает»)
- Любое копирование: код civd/reciv/CivOne/OpenCivOne, таблицы технологий/юнитов/построек Civ1, их формулы и константы, тексты, графика, музыка, макеты экранов, названия и узнаваемые элементы чужих франшиз (Civilization, Warhammer/Games Workshop, Disney и т. п.).
- Долгая кривая обучения: гильдии, которые надо изучать как отдельные игры.
- Проект, в котором через полгода никто (ни человек, ни агент) не может быстро понять статус и устройство.
3. Ограничения
- Чистая разработка (clean room). Материалы в
research/(бывшие01_*,02_*,03_*) — только для понимания логики и глубины жанра. В код и данные игры из них ничего не переносится: ни строки кода, ни таблицы, ни числа, ни текста. Числа баланса выводятся заново и проверяются симуляцией. - Grimdark — только как жанр (готика, вечная война, исполинские машины). Сказки — только народные/общественное достояние (Гримм, Андерсен, народные сказки, мифы), не образы конкретных студий.
- Платформы релиза: Steam (Windows, macOS), App Store (iPhone, iPad).
- Только одиночная игра против ИИ.
- Разработка двумя агентами — Claude Code и Codex — плюс пользователь. Всё общее знание живёт в репозитории, не в чатах. У Codex ограниченная недельная квота.
- Язык интерфейса игры — English (из ранее зафиксированных решений проекта). [предложение Claude]: строки интерфейса сразу через систему локализации, чтобы позже добавить русский без переделки макетов.
4. Игровой дизайн: что решено
4.1 Гильдии — общий каркас + особенности (вариант 2) [решение пользователя]
- Общие для всех: правила карты, городов, экономики, большинство юнитов, основа дерева исследований.
- У каждой гильдии: 3–5 уникальных юнитов, свои постройки и чудеса, 1–2 особые механики (примеры для иллюстрации, не утверждены: сказочные герои растут в уровнях; НЛО похищают жителей).
- Причина: полная асимметрия дала бы слишком длинное обучение.
4.2 Эпохи — общая лестница, свой путь у каждой гильдии (вариант А) [решение пользователя]
- Общие эпохи (рабочие названия: Основание → Расцвет → Индустрия → Звёзды).
- Каждая гильдия проходит их по-своему: сказка — через магию к «небесному ковчегу», космос — через технологии к звездолёту, и т. д. Космическая победа доступна всем.
4.3 Состав гильдий [предложение Claude]
Четыре гильдии по темам пользователя: сказочная, космическая/фантастическая, пришельцы-НЛО, земная индустриально-мрачная. В первой играбельной версии — две с максимальным контрастом (сказочная и земная), остальные добавляются позже без изменения ядра.
4.4 Что ещё не придумано (дизайн-задачи, решаются вместе с пользователем по ходу)
Конкретное дерево исследований, списки юнитов/построек/чудес, формулы экономики и боя, условия победы кроме космической, механики гильдий, имена и лор. Каждое такое решение фиксируется в docs/game/ (раздел 8).
5. Подходы и выбор стека
Рассмотрены:
- TypeScript: отдельное ядро правил + веб-отрисовка, упаковка в приложения. Агенты сильнейшие в TS; тесты и симуляции партий за секунды из терминала; результат виден в браузере; интерфейс 4X (много панелей и таблиц) быстрее всего делается в вебе. Минус: на iPhone игра работает в WebView — нужна ранняя проверка производительности.
- Godot 4. Нативный движок, удобная пиксельная графика; но много работы в визуальном редакторе, который агенты не видят, сложнее проверять, медленнее сложный интерфейс.
- Отброшены: Unity (завязка на редактор, бинарно-подобные сцены, история лицензии), свой движок на C++/SDL (в разы медленнее разработка без выигрыша для пошаговой игры).
Выбран вариант 1. [решение пользователя]
Упаковка: Electron для Steam (Windows/macOS; Steamworks через steamworks.js), Capacitor для iOS. [предложение Claude] (Electron вместо Tauri — из-за более отработанной связки со Steam и оверлеем.)
Страховка: ядро правил не зависит от отрисовки; если телефон не потянет WebGL-отрисовку, заменяется только слой отрисовки.
6. Архитектура [предложение Claude]
Монорепозиторий (pnpm workspaces), TypeScript strict.
| Пакет | Отвечает за | Зависит от |
|---|---|---|
packages/core |
Правила игры: состояние, команды, ход, экономика, бой, исследования. Чистый TS, без DOM, без таймеров, без Math.random. |
— |
packages/content |
Данные игры: местность, юниты, постройки, исследования, гильдии, эпохи — как типизированные данные со схемами и проверкой. | core (типы) |
packages/ai |
Компьютерные противники. Получает только то, что разрешено видеть его гильдии; отдаёт команды тем же путём, что и игрок. | core |
packages/sim |
Безголовые симуляции целых партий ИИ против ИИ для баланса и регрессий. | core, content, ai |
apps/client |
Отрисовка (PixiJS для карты, HTML/CSS для панелей), ввод, звук, обучение, локализация. | core, content, ai |
apps/desktop |
Обёртка Electron + Steamworks. | client |
apps/ios |
Обёртка Capacitor. | client |
Ключевые принципы ядра:
- Детерминизм. Один генератор случайных чисел с сохраняемым зерном внутри состояния. Одинаковые зерно + команды = одинаковая партия на любой машине.
- Команды. Любое изменение мира — сериализуемая команда (
MoveUnit,FoundCity,SetProduction,EndTurn…), проверяемая ядром. Интерфейс и ИИ пользуются одним путём. - Состояние — простые данные (сериализуется в JSON): сохранения, воспроизведение ошибок, автотесты, в будущем — сеть.
- Правила читают данные из
content, а не держат числа в коде — баланс правится без изменения логики. - Прогнозы для интерфейса (сколько ходов до роста, исход боя и т. п.) считает ядро, а не интерфейс, — чтобы подсказки никогда не врали.
Тесты: Vitest. Юнит-тесты правил, проверка схем контента, «золотые» партии по зерну (фиксированный результат), симуляции баланса.
7. Этапы [предложение Claude]
| Этап | Результат | Готово, когда |
|---|---|---|
| M0. Основа | Репозиторий, git, правила для агентов, доска задач, пустые пакеты, CI-скрипт проверок, перенос материалов в research/ |
pnpm check зелёный; оба агента прочли AGENTS.md |
| M1. Вертикальный срез | Новая партия → генерация карты → движение юнитов → основание города → обработка клеток → производство → конец хода → простой ИИ → сохранение/загрузка. Одна гильдия, временная графика | Можно сыграть 50 ходов в браузере; золотая партия детерминирована |
| M1.5. Проверки платформ | Тестовая сборка Electron с оверлеем Steam; прогон на реальном iPhone с большой картой | Обе проверки пройдены или найдено решение |
| M2. Ядро 4X | Исследования, бой, рост и порядок, правительства, дипломатия, варвары, эпохи | Партия ИИ против ИИ доходит до последней эпохи в симуляции |
| M3. Гильдии | Две гильдии с особенностями; путь каждой через эпохи | Обе играбельны, баланс в симуляции в допустимых рамках |
| M4. Полная игра | Все условия победы, чудеса, космическая гонка, отчёты, обучение | Полная партия от начала до победы |
| M5. Доводка до идеала | Финальная графика, звук, обучение, удобство, телефонный интерфейс | Решение пользователя |
| M6. Early Access | Steam Early Access с двумя гильдиями; iOS — открытая бета через TestFlight; канал отзывов (11.3) | Опубликовано в Steam EA |
| M7. Циклы обновлений | Короткие обновления по отзывам игроков: баланс, удобство, новые гильдии и контент | Решения пользователя по данным отзывов |
| M8. Релиз 1.0 | Выход из Early Access в Steam + релиз в App Store | Опубликовано |
8. Организация проекта и работы [решение пользователя: требование; реализация — предложение Claude]
Цель: при любом размере проекта за минуту понять, что есть что, что в каком статусе, кто чем занят и где менять.
8.1 Структура
TERRITORY/
AGENTS.md единые правила для всех агентов (Codex читает автоматически)
CLAUDE.md одна строка: ссылка на AGENTS.md
README.md что это, как запустить, где что лежит
docs/
README.md карта документации
STATUS.md карта статусов систем игры (генерируется + краткий обзор)
GLOSSARY.md термины: игровой термин ↔ имя в коде (ru/en)
specs/ дизайн-документы (этот файл)
game/ дизайн игры по системам: map.md, cities.md, research.md, guilds/*.md …
decisions/ журнал решений: 0001-typescript-stack.md … (почему так, а не иначе)
plans/ планы реализации этапов
tasks/ одна задача = один файл (см. 8.3)
packages/ apps/ код (раздел 6)
research/ старые материалы; только чтение; не в git (см. 8.5)
scripts/ board, check и прочие утилиты
8.2 Статусы систем
Каждая игровая система (карта, города, бой, гильдия «Сказка»…) имеет один статус: idea → designed → prototyped → playable → polished. Статус хранится в шапке её файла в docs/game/; docs/STATUS.md собирается скриптом.
8.3 Задачи
- Один файл на задачу:
tasks/T-0042-found-city.mdс шапкой:id, title, status (todo|doing|review|done|blocked), owner (claude|codex|user), milestone, files (какие файлы/пакеты трогает), depends_on. - В теле: зачем, критерии готовности, заметки по ходу, ссылка на коммиты.
pnpm boardпечатает доску: по этапам, статусам и исполнителям. Файлы читаются и grep-ом, и людьми, не требуют внешних сервисов; при переезде на GitHub их можно перенести в Issues.
8.4 Совместная работа Claude и Codex
- Перед началом задачи агент ставит себе
ownerиdoing; файлы из поляfilesчужой агент не трогает, пока задача не закрыта. - Каждый агент работает в своей ветке/рабочей копии (git worktree); в
mainпопадает только то, что прошлоpnpm check. - Перекрёстная проверка: значимые изменения одного агента просматривает другой (с учётом квоты Codex — выборочно, для ядра и баланса обязательно).
- Связь: Codex работает во вкладке терминала рядом с чатом; Claude передаёт ему задачи через
codex queue; всё, что важно, фиксируется в файле задачи, а не только в переписке. - Каждое архитектурное решение — запись в
docs/decisions/. - Код, идентификаторы, комментарии и сообщения коммитов — на английском; документация и задачи — на русском.
8.5 Исследовательские материалы
01_Modern_Concept,02_Specification,03_Game_Sourcesпереезжают вresearch/без изменений.research/в.gitignoreцеликом, кромеresearch/README.md(что там лежит и правило чистой разработки). Причина: у части исходников нет лицензии, таблицы и тексты принадлежат правообладателям Civ1 — им не место в репозитории, который может стать публичным.- Спецификация из
02_Specificationиспользуется как чек-лист «какие системы и состояния нужны игре такой глубины» и как сборник дизайн-вопросов (например: гибнет ли вся стопка юнитов при поражении защитника), на которые мы отвечаем сами вdocs/game/.
9. Визуальное направление
- Из имеющихся концептов сохраняется язык интерфейса: тёмные панели, светлый текст, тонкие квадратные рамки, чёткая квадратная сетка, одна главная кнопка, контекстные действия, названные кнопки вместо однобуквенных команд.
- Мир рисуется заново под grimdark и гильдии; тёплый «приливный атлас» и надпись «Layers of Time» не переносятся.
- До финальной графики (M5) используется временная графика, достаточная для игры и проверки читаемости.
10. Решения по итогам проверки документа [предложение Claude]
- Интерфейс сразу и для мыши, и для касаний. С M1 ввод идёт через общий слой (касание = клик, жесты карты, крупные области нажатия), раскладка проверяется на ширине телефона и десктопа. На M5 — только доводка, не переделка. Минимальные модели iPhone/iPad определяются по итогам M1.5.
- Целевые размеры партии и скорость. Размеры карты: малая / средняя / большая (большая — порядка 4000 клеток); до 7 компьютерных противников; ход ИИ на слабейшем поддерживаемом телефоне — не дольше ~2 с; ИИ работает в Web Worker, чтобы интерфейс не замирал. Эти числа — критерии для M1.5.
- Расширяемое ядро. С M1 правила строятся на системе эффектов и точек расширения (модификаторы, события, особые действия), описываемых в
content. Механики гильдий подключаются через неё, а не правкой ядра; если механике не хватает точки расширения — сначала добавляется точка, с записью вdocs/decisions/. - Несколько соперников одной гильдии. Да. Участник партии = фракция (имя, цвет, лидер) внутри гильдии; гильдия задаёт правила и облик, фракция — личность.
- Порядок дизайн-решений. Агенты предлагают черновой дизайн системы в
docs/game/(статусdesigned), сразу строят по нему, а пользователь утверждает или правит пачками на просмотре играбельной версии. Работа не ждёт утверждения каждой мелочи; числа баланса всегда считаются временными до этапа доводки. - Честность ИИ. ИИ всегда видит только то, что положено его фракции. На высоких уровнях сложности допустимы прозрачные экономические бонусы (а не подглядывание), они перечислены в описании уровня сложности.
- Сроки и бюджет. Без фиксированной даты, этап за этапом. Платные позиции (аккаунты Apple и Steam, подпись Windows-сборки, тестовые устройства) нужны только к M1.5/M7 и будут названы заранее.
11. Ответы пользователя после проверки
11.1 Графика, музыка, звук [решение пользователя]
Финальную графику, музыку и звук делает Codex.
- [предложение Claude] В M1 Codex делает раннюю пробу: несколько клеток местности, юнит, город в выбранном стиле — чтобы до M5 закрепить размер клетки, вид (сверху) и технические требования к спрайтам (атласы, прозрачность, масштабирование без размытия).
- [предложение Claude] Все созданные ИИ материалы помечаются в
assets/ATTRIBUTION.md(что, каким инструментом, дата) — Steam требует раскрытия ИИ-контента на странице игры. - [предложение Claude] Если для музыки/звука у Codex не окажется подходящего инструмента, выбор инструмента — отдельное решение на M5.
- Учитывать недельную квоту Codex при планировании объёма графики.
11.2 Объём и формат выпуска [решение пользователя]
Steam Early Access с двумя гильдиями (сказочная и земная — см. 4.3). Остальные гильдии — обновлениями по ходу Early Access.
- [предложение Claude] В App Store нет Early Access: iOS-версия до 1.0 идёт открытой бетой через TestFlight, в App Store — вместе с выходом 1.0.
11.3 Модель продаж и быстрые циклы [решение пользователя]
Разовая покупка. Развитие — по отзывам игроков, максимально короткими циклами.
- [предложение Claude] Канал отзывов с первой EA-сборки: кнопка «Отзыв» в игре (текст + по желанию сохранение партии), анонимная аналитика только с согласия игрока (длина партий, где бросают, выбор гильдий), обсуждения Steam. Отсюда требования: политика конфиденциальности до M6, отсутствие сбора данных без согласия.
- [предложение Claude] Сборка и выкладка обновления — одной командой скрипта, чтобы цикл «отзыв → правка → обновление» занимал дни, а не недели.
- Содержимое гильдий не разделяется на платные пакеты; если позже понадобятся дополнения, это отдельное решение.
12. Оставлено строителю
- Точные версии библиотек, настройки линтера/форматтера, CI.
- Формат файлов контента (TS-модули или JSON + схемы) — при условии типизации и проверки.
- Размер клетки и масштабирование временной графики.
- Генератор карт для M1 (любой простой, детерминированный).
- Сценарий
pnpm check(тип-проверка, тесты, проверка контента, линтер).