Initialize Project Sacrifice backlog and source baseline

2026-08-18 00:46:42 +03:00
parent d28ea8c3fd
commit 29d4a2d8d8
34 changed files with 4630 additions and 151 deletions
@@ -0,0 +1,65 @@
+# Beads: отслеживание выполнения плана
+
+Beads инициализирован локально в `~/tmp/goon-game` поверх embedded Dolt. Remote не настроен: база задач существует только на этой машине.
+
+Источники требований:
+
+- [`DEVELOPMENT_PLAN.md`](DEVELOPMENT_PLAN.md) — утверждённый GDD + TDD + production roadmap;
+- [`CURRENT_ROADMAP.md`](CURRENT_ROADMAP.md) — ближайшая последовательность работ для существующего vertical slice.
+
+## Структура backlog
+
+- master epic: `goon-game-plan`;
+- 16 доменных эпиков `goon-game-e01` … `goon-game-e16` из раздела 62 основного плана;
+- milestones Prototype, Vertical Slice, Production, Alpha, Beta и Release Candidate;
+- предметные задачи с acceptance criteria, приоритетами и зависимостями;
+- уже подтверждённые кодом и QA элементы закрыты с причиной.
+
+На момент инициализации создано 68 beads: 13 закрыты, 4 находятся в работе и 51 открыт. Эти числа нельзя трактовать как точный процент готовности, потому что в базе смешаны эпики, features и задачи разного размера.
+
+Текущий gate — `goon-game-milestone-vslice`. Первая приоритетная незаблокированная задача — `goon-game-bot-framework`.
+
+## Ежедневные команды
+
+Выполнять из `~/tmp/goon-game`:
+
+```sh
+bd status
+bd ready --exclude-type epic
+bd list --all --tree
+```
+
+Посмотреть задачу и её зависимости:
+
+```sh
+bd show goon-game-bot-framework
+bd dep tree goon-game-milestone-vslice
+```
+
+Начать работу:
+
+```sh
+bd update goon-game-bot-framework --claim
+```
+
+Закрыть после выполнения acceptance criteria:
+
+```sh
+bd close goon-game-bot-framework --reason "Acceptance criteria выполнены; проверки зелёные"
+```
+
+После изменения графа:
+
+```sh
+bd dep cycles
+bd export --output .beads/issues.jsonl
+```
+
+## Правила ведения
+
+1. Не закрывать задачу по факту написания кода — сначала выполнить её acceptance criteria и проверки.
+2. Новую найденную работу добавлять дочерней к одному из 16 эпиков и связывать blocking dependency, если она влияет на milestone.
+3. Реальные softlocks и непроходимые уровни заводить как `bug` с P0/P1, а не прятать внутри общего balance task.
+4. Vertical Slice закрывать только после `10/10 passed`, внешнего playtest и остальных зависимостей в его дереве.
+5. Не редактировать `.beads/issues.jsonl` вручную: source of truth — embedded Dolt в `.beads/embeddeddolt`.
+6. Перед передачей базы другой машине отдельно настроить Dolt remote либо передать весь Git/Beads-каталог; сейчас удалённой синхронизации нет.