Привязать все задачи к этапам разработки

docs/STAGE_REGISTRY.md

@@ -0,0 +1,74 @@
+# 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: runner создан,
+  однако критерий трёх полных прогонов быстрее пяти минут ещё не доказан.
+- `goon-game-level-balance` имеет `stage-2`, но primary Stage 5: инженерные
+  исправления сделаны, а внешний comprehension/playtest gate остаётся открытым.
+- `goon-game-human-playtest` относится к Stage 5 и не может быть закрыт ботами.
+- `goon-game-content-worlds` имеет primary Stage 6 и начинается после принятия
+  `goon-game-milestone-vslice` Stage 5.
+
+## Проверка
+
+После любого изменения Beads выполнить:
+
+```sh
+./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 | 15 |
+| 6 | 18 | 18 |
+| 7 | 9 | 9 |
+| 8 | 1 | 1 |
+| 9 | 1 | 1 |
+| 10 | 4 | 4 |
+
+Всего: 78; непривязанных: 0; задач с некорректным primary stage: 0.