Compare commits

..

No commits in common. "8eb58dbdbc98befba60522b5f5a80f802ca5d9a4" and "0eb4f6389572f47bbcca8c5614cf70f0521b3d67" have entirely different histories.

3 changed files with 3 additions and 24 deletions

View file

@ -71,14 +71,8 @@ correct" rather than erroring.
is a divergence to reconcile deliberately, not to overwrite.
2. **`dev` is the default branch.**
`forge_repo_settings(apply_flow_defaults=true)` — sets the default branch and
permits the merge styles the chain uses, plus rebase-updates (without which
the merge queue's core primitive 403s).
The chain uses exactly two: **squash** for `feat/*``dev`, and
**fast-forward-only** for both promotions. Merge commits and rebase merges
are disabled deliberately — see the merge-style table in the root
`CLAUDE.md`. If `apply_flow_defaults` re-enables them, that is the tool
disagreeing with the policy, not permission to use them.
permits every merge style the chain uses, including `fast-forward-only`, plus
rebase-updates (without which the merge queue's core primitive 403s).
3. **Protection.** `forge_branch_protection(branch="dev", apply=true)`, then
`main`, then `release`.

View file

@ -19,7 +19,7 @@ name: PR build (required check)
on:
pull_request:
branches: [dev, main, release]
branches: [dev, main]
concurrency:
group: pr-build-${{ github.event.pull_request.number }}

View file

@ -22,21 +22,6 @@ every change, so a stale one is a correctness bug, not a documentation bug.
`dev`, `main` and `release` are protected: **everything is a PR**, for humans and
agents alike. Promotion is one PR per hop, `dev``main``release`.
**Merge style is part of the contract**, and Forgejo enforces it repo-wide —
it cannot scope styles per branch, so these are the only two enabled:
| Hop | Style |
|---|---|
| `feat/*``dev` | **squash** |
| `dev``main`, `main``release` | **fast-forward only** |
Merge commits and rebase merges are disabled. A promotion therefore never
creates a commit, which keeps `release ⊆ main ⊆ dev` true permanently: the
three branches hold identical history, never merely identical trees. Squashing
into `main` instead would strand `merge-base(dev, main)` and make every later
promotion re-apply work already there. Rebase-*updates* stay enabled — the
merge queue 403s without them.
`.claude/BRANCHING.md` is the orchestrator's runbook for that flow — the
serialised merge queue, promotions, hotfix down-merges — and
`.claude/ownership.md` is the module map saying which tasks may run