create-branch

You are $DEV_ROLE, creating a new branch for the $PROJECT_NAME project with a Jira ticket ID.

IMPORTANT: Always ask for the Jira ticket ID before creating the branch.

When the user runs /create-branch, perform the following steps:

---

STEP 1: ASK FOR INFORMATION

Ask the user 2 questions:

1. "Jira ticket ID? (e.g. PROJ-123)"
   • The project has these Jira projects: read from $JIRA_PROJECT_KEYS in config.env (Acme uses PROJ).
   • Validate input: it must match the regex ^(PROJECT_KEY)-\d+$ where PROJECT_KEY belongs to $JIRA_PROJECT_KEYS. If not, ask again.
2. "Short description for the branch? (e.g. add auth guard)"

---

STEP 2: CREATE BRANCH

See _shared/repo-conventions.md — the authoritative source, transcribed from acme-mono/README.md.

Format:

PROJ-<ticket>-<short-description>

• PROJ- fixed prefix, uppercase
• <ticket> — issue number, 1 to 3 digits
• <short-description> — kebab-case slug: letters, digits, ., _, -

This repo does NOT use a feature/ or fix/ type prefix, and no slash.

Examples:

• PROJ-3-user-profile-screen
• PROJ-42-usage-analytics
• PROJ-128-session-caching

Rejected:

• ❌ feature/PROJ-123-add-auth-guard — type prefix is not used in this repo
• ❌ proj-3-user-profile-screen — PROJ must be uppercase
• ❌ PROJ-1234-something — more than 3 digits

---

STEP 3: EXECUTE

Base branch is main. There is no dev branch in acme-mono.

[ -f ".claude/config.env" ] && source .claude/config.env
BASE="${PROJECT_BASE_BRANCH:-main}"

# Fetch latest
git fetch origin

# Checkout the base branch and pull latest before branching
git checkout "$BASE"
git pull origin "$BASE"

# Create the branch
git checkout -b {branch-name}

# Push the branch to remote
git push -u origin {branch-name}

---

STEP 4: JIRA COMMENT (automatic)

After creating the branch, comment on the Jira issue:

[ -f ".claude/config.env" ] && source .claude/config.env
source ~/.zshrc 2>/dev/null || true
if [ -z "$JIRA_TOKEN" ] || [ -z "$JIRA_EMAIL" ]; then
  echo "[JIRA] WARN: \$JIRA_TOKEN or \$JIRA_EMAIL not set (.claude/config.env or ~/.zshrc) — skipping comment"
else
  BASE_URL="$JIRA_BASE_URL"
  curl -sS -X POST \
    -H "Authorization: Basic $(echo -n "${JIRA_EMAIL}:${JIRA_TOKEN}" | base64)" \
    -H "Content-Type: application/json" \
    -d "{\"body\": \"Branch created: {branch-name}\"}" \
    "${BASE_URL}/rest/api/3/issue/{TICKET_ID}/comment" > /dev/null && \
    echo "[JIRA] Posted to {TICKET_ID}"
fi