create-branch

# Create Branch

Create a feature branch following the `<nickname>/<descriptive-branch-name>`
convention used in this repository.

## Steps

### 1. Detect the user's nickname

Resolve the nickname using the first approach that succeeds:

1. **Memory** — check if a stored memory already contains the user's nickname.
2. **`make nickname`** — outputs the local part of `git config user.email` (before `@`).
3. **Ask** — if neither works, ask the user.

Once resolved, save the nickname to memory for future conversations.

### 2. Derive a descriptive branch name

Combine the ticket ID (if available) and a short slug describing the change:

- Use lowercase kebab-case: `fix-auth-timeout`, `add-mcp-tool-list`
- Keep it under 50 characters
- If a YouTrack ticket is known (e.g., `DBA-123`), prefer including it:
  `<nickname>/DBA-123-fix-auth-timeout`

### 3. Ensure a clean starting point

- Fetch latest: `git fetch origin`
- If the working tree has uncommitted changes, warn the user and ask whether
  to stash or proceed.
- Branch from `main` (or the base branch the user specifies):
  `git checkout -b <nickname>/<branch-name> origin/main`

### 4. Confirm

Report the created branch name to the user.

## Guardrails

- Never create branches directly on `main` — always branch _from_ main.
- Never silently discard uncommitted changes.
- If the user is already on a feature branch, ask before switching.