docs: clarify when-to-push (default: immediately, exceptions: refactor batches / >50 LOC / WIP)

This commit is contained in:
goboss
2026-04-30 14:58:34 +00:00
parent 6ccdebbc48
commit a2782715b8
2 changed files with 31 additions and 1 deletions

View File

@@ -8,7 +8,7 @@ Multi-site adult tube infrastructure — **frontend-only** scope (templates / CS
- **goboss checkout:** `/home/w4/goboss/tubev/` - **goboss checkout:** `/home/w4/goboss/tubev/`
- **Bot worktrees:** `/home/w4/<bot>/tubev/` (gocc1-4) - **Bot worktrees:** `/home/w4/<bot>/tubev/` (gocc1-4)
- **Branch:** `main` - **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) ## Сайти (live, prod source)

View File

@@ -32,6 +32,36 @@ Repo для документації / правил / coordination team. Окр
**Why:** prevent accidental conflicts / force-push / unreviewed pushes до прода. goboss is single point of push authority. **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 <files>
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 ## Workflow patterns
### A. Pure docs change (goboss as author) ### A. Pure docs change (goboss as author)