seikaikyo/dash-skills/create-branch

Create Branch

Create a git branch following Sentry naming conventions. Keep this workflow non-interactive unless the user explicitly asks to choose the name manually.

Workflow

1. Resolve the prefix:

• First try gh api user --jq .login
• Then git config github.user
• Then the local part of git config user.email
• Then whoami
• Sanitize to lowercase ASCII letters, digits, and hyphens; if empty, use local

1. Resolve the work description:

• If $ARGUMENTS is present, use it
• Otherwise inspect:

``bash git diff git diff --cached git status --short ``

• If there are local changes, derive a short description from the diff
• If there are no local changes, use a generic description like repo-maintenance, tooling-update, or work-in-progress

1. Classify the branch type:

When unsure: use feat for new things, ref for restructuring, chore for maintenance.

1. Generate <prefix>/<type>/<short-description>.

Keep <short-description> kebab-case, ASCII-only, and ideally 3 to 6 words.

1. Choose the base without prompting:

``bash git branch --show-current git remote | grep -qx origin && echo origin || git remote | head -1 git symbolic-ref refs/remotes/<remote>/HEAD 2>/dev/null | sed 's|refs/remotes/<remote>/||' | tr -d '[:space:]' ``

• If default branch detection fails, fall back to main, then master, then the current branch
• If on a detached HEAD, branch from the current commit
• If already on a non-default branch, branch from the current branch
• Only switch to the default branch when the user explicitly asks

1. Avoid collisions by appending -2, -3, and so on until the name is unused locally and remotely.

1. Create the branch:

``bash git checkout -b <branch-name> `` Report the final branch name, but do not stop for confirmation.

References

• Sentry Branch Naming