TERRITORY — дизайн проекта

Дата: 2026-11-17 · Статус: черновик на утверждение · Авторы: пользователь + Claude Code (обсуждение), разработка совместно с Codex.

Пометка [решение пользователя] — решено в обсуждении. [предложение Claude] — моё решение по умолчанию, пользователь может поправить. [строителю] — решает исполнитель при планировании.


1. Что это и зачем

TERRITORY — собственная пошаговая 4X-стратегия на квадратной сетке в формате первой Civilization: от первого поселения до полёта к звёздам, города обрабатывают клетки вокруг, дерево исследований, дипломатия, война, чудеса, долгая партия против компьютера. [решение пользователя]

Зачем: сохранить формат и глубину, которые пользователь любит в Civ1, но сделать полностью свою игру — не хуже оригинала, в идеале интереснее — и выпустить её в Steam и App Store с минимальным риском претензий и снятия. [решение пользователя]

Мир: игрок выбирает гильдию (аналог страны/нации). Гильдия задаёт его «мир»: облик городов, юнитов, героев, свои особенности. Темы гильдий: сказочные герои, космос и фантастика, пришельцы на НЛО, мрачный индустриальный «земной» мир. Общий тон — эпический grimdark. [решение пользователя]

2. Цели, не-цели, анти-цели

Цели

Не-цели (в этой версии)

Анти-цели (провал, даже если «работает»)

3. Ограничения

4. Игровой дизайн: что решено

4.1 Гильдии — общий каркас + особенности (вариант 2) [решение пользователя]

4.2 Эпохи — общая лестница, свой путь у каждой гильдии (вариант А) [решение пользователя]

4.3 Состав гильдий [предложение Claude]

Четыре гильдии по темам пользователя: сказочная, космическая/фантастическая, пришельцы-НЛО, земная индустриально-мрачная. В первой играбельной версии — две с максимальным контрастом (сказочная и земная), остальные добавляются позже без изменения ядра.

4.4 Что ещё не придумано (дизайн-задачи, решаются вместе с пользователем по ходу)

Конкретное дерево исследований, списки юнитов/построек/чудес, формулы экономики и боя, условия победы кроме космической, механики гильдий, имена и лор. Каждое такое решение фиксируется в docs/game/ (раздел 8).

5. Подходы и выбор стека

Рассмотрены:

  1. TypeScript: отдельное ядро правил + веб-отрисовка, упаковка в приложения. Агенты сильнейшие в TS; тесты и симуляции партий за секунды из терминала; результат виден в браузере; интерфейс 4X (много панелей и таблиц) быстрее всего делается в вебе. Минус: на iPhone игра работает в WebView — нужна ранняя проверка производительности.
  2. Godot 4. Нативный движок, удобная пиксельная графика; но много работы в визуальном редакторе, который агенты не видят, сложнее проверять, медленнее сложный интерфейс.
  3. Отброшены: 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

Ключевые принципы ядра:

Тесты: 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 Задачи

8.4 Совместная работа Claude и Codex

8.5 Исследовательские материалы

9. Визуальное направление

10. Решения по итогам проверки документа [предложение Claude]

11. Ответы пользователя после проверки

11.1 Графика, музыка, звук [решение пользователя]

Финальную графику, музыку и звук делает Codex.

11.2 Объём и формат выпуска [решение пользователя]

Steam Early Access с двумя гильдиями (сказочная и земная — см. 4.3). Остальные гильдии — обновлениями по ходу Early Access.

11.3 Модель продаж и быстрые циклы [решение пользователя]

Разовая покупка. Развитие — по отзывам игроков, максимально короткими циклами.

12. Оставлено строителю