Knob
Branch protection
You might say: merge gate, protected branch, ruleset, required checks
Rules that constrain updates to important branches and require selected checks, reviews, or other conditions before merge.
- What it does
- Stops a passing-looking run or actor from changing the shared branch without the required evidence.
- Ask
- Which branch is protected, which checks and approvals are required, and who can bypass them?
- Typical
- Required checks, required approvals, code-owner review, signed commits, linear history, merge queue, deployment gates, and bypass lists.
- Trouble
- A check name is ambiguous, rules overlap, approvals go stale, or an administrator can bypass a gate without a recorded reason.
What to look for
- A protected-branch or ruleset settings page
- Required checks and approval counts in a merge box
- A blocked merge message
Connections
- Controls: Pull request
- See also: Bot identity
Sources
- GitHub, About protected branches, About branch protection rules
You can protect important branches by setting branch protection rules, which define whether collaborators can delete or force push to the branch and set requirements for any pushes to the branch, such as passing status checks or a linear commit history.
- GitHub, About protected branches, Require status checks before merging
Required status checks must have a `successful`, `skipped`, or `neutral` status before collaborators can make changes to a protected branch.
- GitHub, About protected branches, About branch protection rules
Only a single branch protection rule can apply at a time, which means it can be difficult to know which rule will apply when multiple versions of a rule target the same branch. This restriction does not apply to rulesets
Use it on your project
teardown-apply: hold "Branch protection" (branch-protection) from the teardown at https://teardownatlas.com/software-factory/ against my project
Paste it into a coding agent that has the teardown skills.
An AI agent wrote this map with the teardown skill. It can contain errors: check the sources before you rely on a part. About and legal