majiayu000 Branch Create
Uses Orchestrator for workspace preparation. Create a feature branch following the workspace naming convention, from the correct base branch.
Prerequisites: Issue number and type known, no uncommitted changes on current branch
Branch Naming Convention
Read workspace.config.yaml for:
project.base-branch— the branch to create from (default:main)project.branch-pattern— the naming pattern
Pattern
<type>/<issue-number>-<kebab-description>
Types
| Type | When to Use |
|---|---|
feat |
New feature or capability |
fix |
Bug fix |
docs |
Documentation only |
chore |
Maintenance, dependencies, tooling |
refactor |
Code restructuring, no behavior change |
test |
Test additions or corrections |
perf |
Performance improvement |
Examples
feat/42-add-redis-cachefix/99-null-pointer-on-logindocs/55-api-reference-updatechore/128-phase7-checkpoint
Steps
- Determine the branch type from the issue labels or context:
type:feature→feattype:bug→fixtype:docs→docstype:chore→choretype:spike→chore- If no label, infer from the issue title or ask
- Compose the branch name:
<type>/<issue-number>-<kebab-description> - Present the proposed branch name for approval
⛔ CHECKPOINT
STOP. Await approval of the branch name.
- Checkout the base branch and pull latest:
git checkout <base-branch> && git pull origin <base-branch> - Create the feature branch:
git checkout -b <branch-name> - Verify the branch was created:
git branch --show-current
Output
## Context Anchors
- **Issue:** #<number> - <title>
- **Branch:** `<branch-name>`
## Branch Created
- **From:** `<base-branch>`
- **Name:** `<branch-name>`
## Next Step
Branch created. Ready to begin implementation.
**Approval Required:** No
Error Handling
| Error | Recovery |
|---|---|
| Branch already exists | Report it; ask whether to checkout existing or rename |
| Uncommitted changes | Report them; ask whether to stash or commit first |
| Base branch not found | Check workspace.config.yaml; ask for correct name |
| Issue number unknown | Ask for the issue number |
| Type cannot be determined | List the type options and ask user to pick |