docs: clarify when-to-push (default: immediately, exceptions: refactor batches / >50 LOC / WIP)
This commit is contained in:
@@ -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)
|
||||||
|
|
||||||
|
|||||||
@@ -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)
|
||||||
|
|||||||
Reference in New Issue
Block a user