gamestudio

KO | EN

gitlite — search

#vue #artificial-intelligence #python #c #generative-ai #claude-code #react #golang #linux #mcp

(★ 19)

No description available.

File Explorer

ZIP Download

- _common.md
- architect.md
- developer.md
- qa-tester.md
- ui-developer.md
- .gitkeep
.gitignore
agents.md
health-check.sh
LICENSE
ORCA.md
PORTING.md
README.md
START_PROMPT.md
STUDIO.md
ui-diff-check.sh
usage-snapshot.sh
work-check.sh

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Процесс разработки игры командой ИИ-агентов.

Это не фреймворк и не библиотека. Это **производственный процесс**: правила, роли и приборы, по
которым один координатор-человек и несколько параллельных ИИ-воркеров делают игру, а не документы о
том, как делать игру.

Всё здесь добыто ошибками и подтверждено замером. Каждое правило стоит рядом со своей ценой — числом,
датой и коротким описанием отказа, который его породил. Уберите числа — останутся лозунги, и правила
перестанут работать через неделю.

## Откуда взялись числа

Процесс обкатан на игре, которая в текстах называется **Пилот** (веб, TypeScript). Конкретные пути,
имена файлов и модели в примерах принадлежат ей и приведены как ДОКАЗАТЕЛЬСТВО, а не как образец: на
другом движке они меняются, правило — нет.

Порядок наведения был такой:

| было | стало |
|---|---|
| 934 строки правил, читаются каждым воркером каждый круг | 400 строк, читаются один раз |
| 454 запуска воркеров на 50 закрытых задач — **девять стартов на задачу** | 22 карточки за **12 запусков** |
| четыре проверяющие стадии на каждую правку | проверка по риску: ревью там, где живёт класс отказов |
| 2111 тронутых файлов в `docs/` против 1685 в `src/` | документов не заводим, спека умирает вместе с карточкой |

## Три правила, ради которых всё остальное

1. **Большими пачками и крупными мазками.** Одна зона и 15–20 весов на воркера, а не карточка на
   воркера. Стоимость старта не зависит от размера пачки — значит пачка должна быть большой.
2. **Проверка по риску, а не по обряду.** Ревью обязательно там, где правка трогает общего владельца
   факта: состояние, время показа, границу указателя, очередь событий, сейв. На раскладку, цвет и
   текст — не нужно.
3. **Мы делаем игру, а не приборы и не правила о правилах.** Процессная работа самовоспроизводится;
   находка без наблюдаемого игроком эффекта ждёт в очереди, а не порождает подсистему.

## Что внутри

| файл | кто читает | о чём |
|---|---|---|
| `STUDIO.md` | все | правила работы: пачки, проверка, слияние, очередь, скорость и деньги |
| `START_PROMPT.md` | Producer | стартовый промпт координатора: круг, признаки жизни воркера, постановка задачи |
| `agents.md` | Producer | провайдеры, модели, кто какую роль держит и три отказа запуска |
| `ORCA.md` | Producer | грабли оркестратора — каждая уже стоила времени |
| `PORTING.md` | тот, кто переносит | что заполнить в новом проекте и что добывается заново |
| `roles/_common.md` | все роли | общая часть каждой спеки: коммит, проверка, счёт приборов, один владелец факта |
| `roles/*.md` | воркер | Developer, UI Developer, QA / Tester, Architect — что владеет, что запрещено, чем доказывает |

Приборы — четыре shell-скрипта, каждый отвечает на один вопрос, на который координатор иначе отвечает
догадкой:

| скрипт | вопрос |
|---|---|
| `health-check.sh` | чья это нагрузка и сколько ей лет; есть ли работа без исполнителя |
| `work-check.sh` | сколько строк воркер добавил и КУДА — по классам файлов |
| `ui-diff-check.sh` | что из сдачи UI-роли обязано быть прочитано глазами до мержа |
| `usage-snapshot.sh` | наклон расхода лимитов по всему текущему окну, а не остаток на момент |

## Как перенести в свой проект

Папка копируется целиком и движка не знает. Всё, что зависит от стека, лежит **вне** её — в двух
файлах проекта:

- `.studio/project.conf` — команда установки, команда ворот, команда съёмки кадров, зоны исходников,
  логический размер экрана;
- `.studio/zones.conf` — что считать логикой и что зоной интерфейса (для `ui-diff-check.sh`);
- `GAME.md` в корне проекта — сама игра: что делаем, для кого, чего не делаем.

Подробности и список того, что придётся замерить заново на своей машине, — в `PORTING.md`.

## Оркестратор

Процесс написан под запуск воркеров через Orca (`orca orchestration task-create` / `worker-start`) и
провайдеров `claude`, `codex`, `kimi`. Правила о пачках, проверке и владельце факта от оркестратора не
зависят; от него зависит только `ORCA.md` и команды запуска в `agents.md`.

## Лицензия

MIT — см. `LICENSE`. Берите и переносите; за числа отвечает только тот проект, на котором они сняты.

gamestudio

Owner Repos

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

gamestudio

Owner Repos

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

Download README