pickup

/ticket-flow:pickup — Phase 1 of Ticket-Flow

Args: <kanban-id> (required) · <branch-suffix> (optional, default = slug from title) · --here (optional — adopt the current worktree + branch instead of creating one; ignores <branch-suffix>)

Examples:

• /ticket-flow:pickup 92 → branch change/92-sidebar-drawer
• /ticket-flow:pickup 94 multipoint → branch feature/94-multipoint
• /ticket-flow:pickup 94 --here → inside an orca/worktrunk card on branch chris/multipoint: no new worktree, that branch becomes the ticket's branch

What it does

1. Validates that the item is in Backlog and DoR is met
2. Creates a worktree (EnterWorktree — no manual fallback, see step 4) — or, with --here, adopts the worktree you are already in (external tool owns it; /finish will leave it in place)
3. Sets a branch: lock in the bd notes
4. Moves item Backlog → In Progress
5. Looks for or scaffolds a plan doc under docs/superpowers/plans/

Steps

0. Where am I? — auto-adopt an external worktree

Before anything else, find out whether this session already sits in a worktree that some other tool prepared (orca card, Conductor workspace, wt switch --create, bead-workflow-skills /work-on, a manual git worktree add). Creating a nested tf worktree there would be wrong in every case, so pickup adopts it — --here is implied, no flag needed:

eval "$("${CLAUDE_PLUGIN_ROOT}/skills/pickup/detect-worktree.sh")"   # IN_GIT LINKED WORKTREE MAIN_REPO BRANCH DEFAULT TF_OWNED MANAGER
if [[ "$LINKED" == "1" ]]; then
  if [[ "$TF_OWNED" == "1" ]]; then
    echo "STOP: you are inside a tf worktree ($WORKTREE) — it is bound to another ticket; run pickup from the main checkout ($MAIN_REPO)"; exit 1
  fi
  # external worktree: adopt it unless its branch is already locked to another ticket
  OTHER="$(bd list --json 2>/dev/null | jq -r --arg b "$BRANCH" '.[] | select((.notes // "") | test("(^|\\n)branch: " + $b + "$")) | .id' | head -1)"
  [[ -n "$OTHER" && "$OTHER" != "$BD_ID" ]] && { echo "STOP: branch $BRANCH is already locked to $OTHER"; exit 1; }
  HERE=1; echo "↳ adopting ${MANAGER:-external} worktree $WORKTREE (branch $BRANCH) — no new worktree will be created"
fi