From 5aa879623ee49ece7bd90fb6f4b6dd9407fb594f Mon Sep 17 00:00:00 2001
From: "E.Gavrilov" <gavrilovdev@yandex-team.ru>
Date: Tue, 18 Aug 2026 00:50:44 +0300
Subject: [PATCH] =?UTF-8?q?=D0=9D=D0=B0=D1=81=D1=82=D1=80=D0=BE=D0=B8?=
 =?UTF-8?q?=D1=82=D1=8C=20=D0=BE=D0=B1=D1=8F=D0=B7=D0=B0=D1=82=D0=B5=D0=BB?=
 =?UTF-8?q?=D1=8C=D0=BD=D1=8B=D0=B9=20push=20=D0=B2=20origin?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 AGENTS.md              | 10 +++++++---
 CLAUDE.md              |  4 +++-
 docs/BEADS_WORKFLOW.md | 22 ++++++++++++++++++++--
 3 files changed, 30 insertions(+), 6 deletions(-)

diff --git a/AGENTS.md b/AGENTS.md
index 6c737c5..f3014c4 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -14,16 +14,20 @@ bd ready --exclude-type epic
 
 Claim the selected bead before changing code and close it only after its acceptance criteria and relevant checks pass. Create follow-up beads for newly discovered work and connect real blockers with `bd dep add`.
 
-The current Beads database is local-only embedded Dolt. No Git or Dolt remote is configured, so do not claim that changes were pushed. At the end of a session:
+The Git remote is `origin` at `ssh://git@git.pryanik.synology.me:2222/huncode/goon-game.git`; `master` tracks `origin/master`. The Beads database uses embedded Dolt. A Dolt remote entry exists locally, but publishing the separate Dolt history requires explicit owner authorization; normal `git push` publishes the versioned `.beads/issues.jsonl` snapshot, not the embedded database.
+
+At the end of a session:
 
 1. run the relevant quality gates;
 2. update or close the active bead;
 3. run `bd dep cycles` after dependency changes;
 4. export a readable snapshot with `bd export --output .beads/issues.jsonl`;
-5. commit local source and tracking changes when appropriate;
-6. report explicitly that synchronization remains local until a remote is configured.
+5. commit source and tracking changes;
+6. run `git pull --rebase` and `git push`;
+7. verify `git status --short --branch` shows the branch tracking `origin/master` without local changes.
 
 Do not edit `.beads/issues.jsonl` manually. The source of truth is `.beads/embeddeddolt`.
+Do not run `bd dolt push` unless the owner explicitly authorizes publishing that separate tracking history.
 
 ## Build and tests
 
diff --git a/CLAUDE.md b/CLAUDE.md
index 1100c8d..a870f16 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -1,5 +1,7 @@
 # Project instructions for Claude Code
 
-Follow [`AGENTS.md`](AGENTS.md). Work is tracked in local Beads (`bd`), with no remote currently configured.
+Follow [`AGENTS.md`](AGENTS.md). Work is tracked in embedded-Dolt Beads (`bd`); source and the exported `.beads/issues.jsonl` snapshot are published through Git `origin/master`.
 
 Run `bd prime`, `bd status`, and `bd ready --exclude-type epic` before selecting work. Claim a bead before implementation and update its status only after its acceptance criteria and relevant tests are satisfied.
+
+Finish sessions with an updated Beads export, a local commit, `git pull --rebase`, `git push`, and verification of the tracking branch. Do not publish the separate Dolt history without explicit owner authorization.
diff --git a/docs/BEADS_WORKFLOW.md b/docs/BEADS_WORKFLOW.md
index 0167f04..606f395 100644
--- a/docs/BEADS_WORKFLOW.md
+++ b/docs/BEADS_WORKFLOW.md
@@ -1,6 +1,13 @@
 # Beads: отслеживание выполнения плана
 
-Beads инициализирован локально в `~/tmp/goon-game` поверх embedded Dolt. Remote не настроен: база задач существует только на этой машине.
+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-история не публикуется без явного разрешения владельца.
 
 Источники требований:
 
@@ -55,6 +62,16 @@ 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 и проверки.
@@ -62,4 +79,5 @@ bd export --output .beads/issues.jsonl
 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-каталог; сейчас удалённой синхронизации нет.
+6. Git remote обязателен для исходников и JSONL snapshot; после каждого изменения backlog экспортировать JSONL, коммитить и делать push.
+7. `bd dolt push` публикует отдельную внутреннюю историю и выполняется только после явного разрешения владельца.