branch

name	branch
description	Create a git feature branch named for the current session's work. Slugifies the git username and derives a short kebab-case feature slug from the changes or task under discussion. Use when the user asks to start, create, or cut a branch.
allowed-tools	Bash(git branch:*), Bash(git config:*), Bash(git status:*), Bash(git switch:*), Bash(git symbolic-ref:*), Bash(gh stack:*)

Branch

Create a feature branch named <git-username>/<feature-slug>, off the current base branch, using the session context to name it.

Context

If the fields below show commands rather than output, run each one first.

• Branch: !git branch --show-current 2>/dev/null || echo "(not a git repo)"
• Default branch: !git symbolic-ref --short refs/remotes/origin/HEAD 2>/dev/null || echo "(unknown)"
• Git username: !git config user.name 2>/dev/null || echo "(unset)"
• Status: !git status --short 2>/dev/null

Process

1. Check for stacked delivery. Read the active plan or task document, then run gh stack view --json. If the document declares Stack or the command finds an active stack, invoke stacked-prs and stop. It owns dependent branch creation and checkout.

2. Check the current branch.

   • Not a git repo → stop and say so.
   • Already on a feature branch (not main/master or the repo's default branch) → stop and report it. Ordinary feature branches start from the repository base; stacked-prs handles intentional dependent branches.
   • On the base branch → continue.

3. Derive the username segment. Slugify git config user.name so spaces and other non-alphanumeric characters become hyphens (e.g. "First Last" → first-last):

   git_username=$(git config user.name \
     | tr '[:upper:]' '[:lower:]' \
     | sed -E 's/[^a-z0-9]+/-/g; s/^-+|-+$//g')
   

   If user.name is unset, ask the user for the segment.

4. Derive the feature slug from session context. A short, kebab-case description of the work (e.g. fix-login-redirect). Draw it, in order of preference, from:

   • Uncommitted changes in the working tree (see Status above).
   • The task the user is actively working on in this session.
   • What the user states directly.

   Keep it concise — a few words, lowercase, hyphen-separated, no type prefix. If the intent is unclear or you'd be guessing, propose a slug and confirm before creating the branch.

5. Create the branch:

   git switch -c "${git_username}/<feature-slug>"
   

6. Report the new branch name.