# Beads: отслеживание выполнения плана

Beads инициализирован в `~/tmp/goon-game` поверх embedded Dolt. Git remote настроен:

```text
origin = ssh://git@git.pryanik.synology.me:2222/huncode/goon-game.git
master tracks origin/master
```

Обычный Git push публикует исходники и экспорт `.beads/issues.jsonl`. Embedded Dolt остаётся source of truth. Локальная запись Dolt remote создана, но отдельная Dolt-история не публикуется без явного разрешения владельца.

Источники требований:

- [`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 элементы закрыты с причиной.

На 18 августа 2026 года в snapshot находятся 72 beads: 22 закрыты, 6 находятся в работе и 44 открыты. Эти числа нельзя трактовать как точный процент готовности, потому что в базе смешаны эпики, features и задачи разного размера.

Текущий gate — `goon-game-milestone-vslice`. Инженерный кандидат этапа 2 собран; незакрытые gates включают `goon-game-human-playtest` и performance/repetition criteria `goon-game-regression-10`. Задачи этапа 3 можно начинать параллельно, не объявляя внешний playtest завершённым.

## Ежедневные команды

Выполнять из `~/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
```

Завершение сессии:

```sh
git add .
git commit -m "<описание изменения>"
git pull --rebase
git push
git status --short --branch
```

## Правила ведения

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. Git remote обязателен для исходников и JSONL snapshot; после каждого изменения backlog экспортировать JSONL, коммитить и делать push.
7. `bd dolt push` публикует отдельную внутреннюю историю и выполняется только после явного разрешения владельца.