Branch rules user stories

Context

These user stories will be used to gut check design concepts and increase confidence in meeting customer needs. This exercise will help design and the team clarify and gain depth into the most pressing user issues around branch rules.

Design

User stories workshop

To extract knowledge from the team, Product / Development was invited to a workshop to brainstorm user stories for Branch rules, and vote upon the most important user stories to gauge team alignment.

  • Notes - Branch rules user stories workshop
  • 📹 Branch rules user stories workshop
  • 🎨 FigJam: User stories workshop

Customer user stories

GitLab customers have shared their use cases, pain points, and frustrations with branch management. They have been collected in:

  • 🎨 FigJam: Customer user stories [WIP]

Source feedback

User stories have been extracted from the following issues:

  • Framework for source code rules
  • 📣 Soliciting User/Customer Feedback on Branch Rules 📣 
  • Protected Branch name precedence over wildcard
  • Most restrictive protected branch rule should take precedence  
  • Protected branches: match the most specific pat... (#39115 - closed) 
  • Override permissions for protected branches wit... (#28048 - closed) 
  • Wildcard branch protection rules should not app... (#26724 - closed) 
  • Add full RE2 regex support to Protected Branches and Protected Tags :point_left::point_left::point_left:
  • Merge Request Approvals / Branch Protection 
  • Branch-specific Push Rules
  • Merge Request Squash Settings per protected branch (non-wildcard only)
  • Squash merge MRs without merge commit
  • UX Scorecard Recommendations: Create FY25-Q3 Source Code - Branch Rules
  • [MVC] Branch Rules Editing
  • Investigate branch based organization for source code rules ?
  • Internal see #554195 (comment 2611563923)
  • Support custom roles on protected branches
  • Repository protected tags configuration is not applied in favor of wildcards of two or more matches, resulting in being unable to push tags or tag into gitlab.com
  • Group-level settings for merge request approval RULES in child projects
Edited Oct 29, 2025 by Alyssa Trinh
Assignee Loading
Time tracking Loading