Create Branch

Create a git branch with the correct type prefix and a descriptive name following Sentry conventions.

When to Use

• You need to create a new git branch that follows the repository's naming convention.
• You are starting a new piece of work from the default branch and need help classifying it as feat, fix, docs, or another branch type.
• You want the branch name proposed from either the task description or the current local diff.

Repository/user naming rules take precedence over these Sentry defaults. Preserve current dirty/staged/untracked work, resolve the intended base to a full commit and avoid auto-stashing unrelated changes. Validate the resulting name with git check-ref-format --branch and pass it as a quoted argument, never shell-interpolated user text. A stale remote-tracking ref is not proof the remote branch is absent; inspect the intended remote if needed.

Step 1: Get the Username Prefix

Run gh api user --jq .login to get the GitHub username.

If the command fails (e.g. not authenticated), ask the user for their preferred prefix.

Step 2: Determine the Branch Description