Start Branch
Generate an appropriate branch name for the task and switch to it in the current working tree.
When to apply
Starting work on a new feature, fix, or task directly in the current directory. Do not apply for worktree (separate checkout directory) — that is /worktree.
Branch naming convention
Format: <type>/<short-description>
| Type | When to use |
|---|---|
feat/ |
New feature or capability |
fix/ |
Bug fix |
chore/ |
Maintenance, config, dependency updates |
refactor/ |
Restructuring without behavior change |
docs/ |
Documentation only |
test/ |
Test additions or changes |
Description rules: lowercase, hyphen-separated, 2–5 words, describes WHAT (not HOW).
Examples: feat/user-authentication, fix/cart-total-calculation, chore/update-eslint-config, refactor/extract-payment-service
Steps
- Derive the branch name from the user's task description using the convention above.
If no task description was given (bare
/start-branch), ask one short question first. - Create and switch to the branch:
git checkout -b <branch-name> - Confirm in one line:
Switched to new branch: <branch-name> - Begin the user's task.