egregore: Skill for Claude Code

Create a working branch from what you're working on.

When to invoke

User says: "/branch", "create a branch", "start a new branch", or any request to begin a working branch for what they're about to do

Description: $ARGUMENTS

What to do

Resolve the core repo's configured base first:

BASE_BRANCH=$(bash -c 'SCRIPT_DIR="$PWD"; CONFIG="$PWD/egregore.json"; . "$PWD/bin/lib/config.sh" && _get_base_branch') ||
  { echo "Could not resolve the configured base branch; stopping before Git changes." >&2; exit 1; }

1. Derive a topic slug from the description (lowercase, hyphens, no special chars, max 40 chars)
2. Determine branch type from description:
   • dev/{author}/{topic-slug} — default for session work
   • feature/{topic-slug} — explicit feature work
   • bugfix/{topic-slug} — bug fixes
3. Call EnterWorktree with name set to the topic slug

The WorktreeCreate hook handles everything: fetches the configured base branch, creates the branch, creates the worktree, sets up symlinks.

Fallback: If EnterWorktree fails, fall back to: git checkout --no-track -b {branch-name} "origin/$BASE_BRANCH"

The task branch must not inherit origin/$BASE_BRANCH as its upstream. Its first push uses git push -u origin "$BRANCH", which creates and tracks the same-name remote task branch.

Deriving the topic slug

Extract the essence of what the user said into a short, meaningful slug:

• "auth flow in frontend" → auth-flow
• "fix the payment endpoint bug" → fix-payment-endpoint
• "refactoring the token store" → refactor-token-store
• "working on oauth implementation" → oauth-implementation

If no description is given, use today's date: YYYY-MM-DD

Branch type detection

• Description mentions "fix", "bug", "broken", "crash" → bugfix/
• Description mentions "feature", "add", "implement", "new" → feature/
• Otherwise → dev/{author}/ (general session work)

Resuming existing branches

Before creating, check if a matching branch already exists:

git branch --list "dev/$AUTHOR/*$SLUG*" "feature/*$SLUG*" "bugfix/*$SLUG*"