diff --git a/CLAUDE.md b/CLAUDE.md index a873f40..f93940c 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -8,7 +8,7 @@ Multi-site adult tube infrastructure — **frontend-only** scope (templates / CS - **goboss checkout:** `/home/w4/goboss/tubev/` - **Bot worktrees:** `/home/w4//tubev/` (gocc1-4) - **Branch:** `main` -- **Push policy:** **goboss пушить**. Боти комітять локально → write report → goboss робить review + push. Деталі: **[docs/GIT_WORKFLOW.md](docs/GIT_WORKFLOW.md)** +- **Push policy:** **goboss пушить immediately after commit** (default). Боти комітять локально → write report → goboss робить review + push. Винятки (multi-step refactor у процесі / diff >50 LOC / WIP) — у **[docs/GIT_WORKFLOW.md § When to push](docs/GIT_WORKFLOW.md#when-to-push-default--exceptions)** ## Сайти (live, prod source) diff --git a/docs/GIT_WORKFLOW.md b/docs/GIT_WORKFLOW.md index 4cd155b..d4a2141 100644 --- a/docs/GIT_WORKFLOW.md +++ b/docs/GIT_WORKFLOW.md @@ -32,6 +32,36 @@ Repo для документації / правил / coordination team. Окр **Why:** prevent accidental conflicts / force-push / unreviewed pushes до прода. goboss is single point of push authority. +## When to push (default + exceptions) + +**Default: push immediately after commit.** Цей repo — docs/coordination, low-risk. Кожен commit = один atomic logical step (P4 atomic-commits global rule). Не накопичуй commits локально. + +```bash +# Стандартний цикл: +git pull --rebase +# edit +git add +git commit -m "..." +git push origin main # ← одразу +``` + +**Чому push immediately:** +- Bots підтягують через `~/bin/trigger-bots` — швидке рознесення стану +- Conflict window мінімальний (rebase-pull простіший на свіжому стані) +- Audit trail чіткий (кожен commit видимий в origin одразу) +- Не треба пам'ятати "що ще не пушнуто" + +**Винятки — НЕ пушити одразу:** + +| Situation | Action | +|-----------|--------| +| Multi-step refactor у процесі (3+ commits пов'язані, ще не finalized) | Commit локально, push коли batch complete + code-reviewer agent на повний diff | +| Diff >50 LOC АБО architectural change | Commit локально, **обов'язково** `Agent(superpowers:code-reviewer)` на diff перед push (per `feedback_pre_push_subagent`) | +| Experimental / WIP — developer явно сказав "не пушити поки не скажу" | Commit локально, чекай developer-go | +| Після bot's commit (cherry-pick into goboss worktree) | Push після cherry-pick + reviewer-agent якщо потрібно (workflow B) | + +**Не tradeoff'и:** atomic commits + push immediately. Не штучно ділити одну зміну на 5 commits "щоб частіше push'ити". І не штучно групувати незв'язані зміни в один commit "щоб push один раз". + ## Workflow patterns ### A. Pure docs change (goboss as author)