goon-game/docs/STAGE_REGISTRY.md

Stage registry Project Sacrifice

Этот документ задаёт единую нумерацию выполнения полного production plan. Доменные EPIC продолжают отвечать на вопрос «какая система меняется», а stage — «в какой последовательности и каким gate работа принимается».

Контракт привязки

Каждая обычная Bead, feature, bug, milestone и EPIC обязана иметь:

• минимум один label stage-N;
• ровно один label primary-stage-N;
• metadata primary_stage=N, совпадающую с primary label.

Дополнительные stage-N допустимы для сквозной работы. Primary stage определяет, какой gate отвечает за закрытие незавершённой задачи. Поэтому исторически начатая работа может относиться к раннему stage, но иметь более поздний primary stage, если её оставшийся acceptance gate выполняется позже.

Нумерация

Stage	Название	Основной результат	Тип
0	Prototype foundation	Устанавливаемый greybox prototype и базовые systems	AFK, завершён
1	Playability automation	Боты уровней 1–10 и единый regression runner	AFK
2	Level correctness and balance	Устранённые softlocks, чистый restart, solution graphs	AFK
3	Mobile UX and accessibility	Controls, onboarding/results, RU/EN, accessibility	AFK
4	Content architecture and tools	Versioned JSON, validator/exporter, bot traces	AFK
5	Vertical Slice completion	Art/audio vertical slice, lifecycle/save/perf и внешний playtest	HITL gate
6	Production content	4 мира, 55–70 уровней, полный набор mechanics/challenges	Mixed
7	Stabilization and release engineering	Device/performance matrix, analytics/crash, signed APK/AAB	AFK/HITL
8	Closed Alpha	Проверка продукта внешней alpha-группой	HITL
9	Beta	Feature freeze, широкая QA-матрица и исправления	HITL
10	Release Candidate	Финальный release gate без blocker/critical defects	HITL

Сквозные gates

• goon-game-regression-10 имеет stage-1, но primary Stage 5: закрыт после трёх детерминированных полных replay-проходов 10/10 с under-five-minute guards.
• goon-game-level-balance и goon-game-human-playtest закрыты после прямого подтверждения владельцем завершения внешнего тестирования; raw session forms не приложены и не реконструируются.
• goon-game-content-worlds имеет primary Stage 6 и разблокирован принятым goon-game-milestone-vslice Stage 5.

Проверка

После любого изменения Beads выполнить:

./scripts/check-stage-assignments.sh
bd dep cycles
bd export --output .beads/issues.jsonl

Stage audit должен завершаться с unassigned=0 и invalidPrimary=0.

Snapshot на 19 августа 2026 года:

Primary stage	Всего Beads	Незакрыто
0	12	0
1	4	0
2	5	0
3	5	0
4	4	0
5	15	0
6	18	18
7	9	9
8	1	1
9	1	1
10	4	4

Всего: 78; непривязанных: 0; задач с некорректным primary stage: 0.