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

@@ -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 <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
### A. Pure docs change (goboss as author)