Skip to content

Commit 0343142

Browse files
authored
docs(agents): sync-back landings are fast-forward, never squash (#11964)
Records the v3.8.50 → v3.8.51 precedent in the single source of truth: a main → release/vX+1 sync PR lands by fast-forward push so main stays an ancestor of the release branch (squash re-conflicts the next sync-back on every file main touched — 551 conflicts this cycle before the two-step merge), plus the two post-landing checks (ancestry assert; ratchet files carried main's freezes). The full procedure lives in the generate-release Phase 5 skill.
1 parent 3d12564 commit 0343142

1 file changed

Lines changed: 12 additions & 0 deletions

File tree

AGENTS.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -594,6 +594,18 @@ inside your feature branch (a base-red fix is its own freeze-gated `fix/release-
594594
PR); and if you must open a PR anyway, add `⚠️ base-red inherited: #<issue>` to the PR body so
595595
reviewers and CI babysitters do not chase ghosts.
596596

597+
### Sync-back landings are fast-forward, never squash
598+
599+
A `main → release/vX+1` sync-back (Phase 5 of `/generate-release`, or any later "bring main's
600+
post-release commits over" PR) must reach the release branch as the merge commit it already is:
601+
`git merge-base --is-ancestor origin/release/vX+1 <head>` then
602+
`git push origin <head>:refs/heads/release/vX+1` (GitHub marks the PR merged). Squash-merging it
603+
drops `main` from the release branch's ancestry and the next sync-back re-conflicts on every file
604+
main touched (551 conflicts on the v3.8.50 → v3.8.51 sync before the two-step merge). After
605+
landing, `git merge-base --is-ancestor origin/main origin/release/vX+1` must be true — and check
606+
that `config/quality/eslint-suppressions.json` / `quality-baseline.json` carried main's freezes
607+
(they merge as "ours" silently). Details: `.agents/skills/generate-release/phases/phase-5-next-cycle.md`.
608+
597609
---
598610

599611
## Upstream contributions

0 commit comments

Comments
 (0)