View as Markdown

Merge Protection Examples & Patterns

Practical rule recipes for common compliance, quality, and coordination needs.

Each recipe below is one item of the merge_protections list in your configuration file. See Custom Rules for the full rule structure.

Title quality gate

Section titled Title quality gate
name: Title Minimum Length
if:
  - base = main
success_conditions:
  - "#title > 15"

Require linked issue for features

Section titled Require linked issue for features
name: Issue Linked
if:
  - label = feature
success_conditions:
  - "title ~= #[0-9]+"

Disallow WIP in title

Section titled Disallow WIP in title
name: No WIP Titles
if:
  - title ~= (?i)wip
success_conditions:
  - label = allow-wip

Enforce changelog entry when touching package

Section titled Enforce changelog entry when touching package
name: Changelog Update
if:
  - files ~= ^package/
success_conditions:
  - files ~= CHANGELOG.md

Require security review for sensitive paths

Section titled Require security review for sensitive paths
name: Sensitive Code Review
if:
  - files ~= ^(secrets/|encryption/|auth/)
success_conditions:
  - label = security-reviewed

Author blocklist

Section titled Author blocklist
name: Block Temp Bot
if:
  - author = temp-bulk-bot
success_conditions:
  - label = automation-approved

Feel free to combine & adapt. Keep rules minimal and targeted.

Was this page helpful?