Repository navigation
fork-sync [Strategy] judgement when the bot stops [📡#443] #656
Description
🤖 claude/anthropic claude-fable-5-1 (medium)
Warning
🚫 Never close this issue. It is a standing strategy lane.
✅ Ticked close conditions mean progress, not done.
Part of #443.
When auto-rebase (#444) stops, an agent or a person runs the fork-sync skill. Same driver; the judgement lives here.
Flow
- read the report: worktree, paths, commands
- resolve each seam by doctrine
- decide the fork commit: keep, reshape, or retire
- land as
fixup! <subject>or one new commit - continue, CI battery, lease push
- rerun; it asks nothing
Rules
| Rule | Contract |
|---|---|
| Stop | environment or conflict; anything else is a driver bug |
| Doctrine | only upstream moved: upstream stands; a marked hook returns verbatim |
| Unblock | finish locally, lease-push; no rerun-from-scratch, no shared cache |
| Lease refusal | never permission to overwrite a concurrent landing |
| Human-read conflict | reshape debt; files under carry-cost (#665) |
Close conditions
- Skill: covers every reported stop kind
- Rerun: asks nothing after a hand fix
- Streak: five runs, one issue per stop
- Cache: rerere ref,
fork-bot-refs.tsgone
Relates to #651.
Activity
donjor-agent commentedon Sep 7, 2026
Body rewritten after the 2026-09-07 ceremony and tracker audits.
Removed: the five-point proposal (mechanical stops fill themselves, lane repairs as commits, local check before push, refuse known bad shapes, one verb per walk) and its four acceptance boxes. They are replaced by five child issues, one PR each, in order: #660, #661, #662, #663, #664.
Not adopted from the audit: a local-preflight stage, a "wake on exit" driver fix, a halt gate on destructive upstream changes, a decision-persistence substrate. Reasons are in the children's origins.
The old body stays in the edit history.
184 remaining items
feat(fork): keep the pull-request template's domain list equal to FOR…
fix(fork): make the unblock walk stop instead of crash, and name what…
fix(fork): make the required statuses green on clean trunk
fix(fork): stop two unblock walks halting on their own bookkeeping
fix(fork): keep a filled decision cell across an unblock refresh
fix(fork): scope the retire-candidate probe to product source
fix(fork): refuse a fork commit that rewrites an upstream test assertion
feat(fork): keep the pull-request template's domain list equal to FOR…
fix(fork): make the unblock walk stop instead of crash, and name what…
donjor-agent commentedon Oct 14, 2026
Triage 2026-10-14. Folded into #443; stop handling lives in the fork-sync skill.