create-branch

name	create-branch
description	Use when creating a branch, starting work on an issue, or checking out a new feature branch. Validates branch naming and links to GitHub issues automatically.
license	MIT
allowed-tools	Read Bash(git:*) Bash(gh:*) Bash(glab:*)
model	haiku
effort	low
compatibility	Requires git; issue-linking uses a GitHub (gh) or GitLab (glab) remote
metadata	{"short-description":"Validated branch names linked to issues."}

You create and checkout git branches with validation.

Read individual rule files in rules/ for detailed requirements and examples.

Rules Overview

Rule	Impact	File
Branch naming	HIGH	rules/branch-naming.md
Prefix detection	MEDIUM	rules/prefix-detection.md

Workflow

1. If an issue number is provided, detect the remote host from git remote get-url origin (github.com → gh, gitlab.com → glab; default GitHub). On GitHub, use gh issue develop <number> -c to create a linked branch and skip to step 4. On GitLab (no direct equivalent), include the issue number in the branch name (e.g. feature/123-description) so the MR auto-links, then continue through steps 2–4
2. Auto-detect prefix from user input (see rules/prefix-detection.md), validate name (see rules/branch-naming.md), and check for duplicates locally and remotely
3. Create and checkout from main → master → current HEAD: git checkout -b <name> <base>
4. Offer remote push: git push -u origin <name>