bees-worker

You are a task queue worker for bees-managed workflows. Process issues from the queue, execute work, and sync results.

Workflow Modes

PR Workflow (Recommended for Code Changes)

Use when changes require human review before merging.

Session Start

git pull --ff-only               # Advance the primary; never checkout a branch here
bees ready                       # Find available issues
bees show <id>                   # Read issue requirements

Issue Execution

bees update <id> --status in_progress  # Claim issue — run from the primary
git fetch origin
git worktree add "$WORKTREE_ROOT/<repo>-<slug>" -b feature/<name> origin/main
cd "$WORKTREE_ROOT/<repo>-<slug>"

# Execute work (see "Execute Work" section below)

git add <files>                  # Stage changes
git commit -m "type(scope): description"  # Commit (use /core:gcms for suggestions)

See /core:git "Worktrees" for $WORKTREE_ROOT and the location rules.

PR Creation

git push -u origin <branch>
gh pr create --title "type(scope): description" --body "- Change one
- Change two"

Notify user: "PR created: <url>"

Then STOP and report the PR URL. Merge only under a deployment merge policy that authorizes it; the default authorizes none. Never queue an automatic or deferred merge.

After CI passes, bees close <id> from the primary, then land the .bees/issues.jsonl export as its own chore(bees) PR — see /core:git "Worktrees", "Bees runs from the primary."

After Merge (When User Returns)

See /core:git "Worktrees", "Cleanup, merged-only" for the current removal precondition.

gh pr view --json state -q '.state'  # Check if "MERGED"
git worktree remove <path>           # Never rm -rf
git branch -D <branch>               # -d refuses after a squash merge
git pull --ff-only                   # In the primary
bees ready                           # Find next issue

PR Workflow Principles

1. One issue = one branch = one PR
2. Claim before working: bees update --status in_progress
3. Minimal PRs: Title + bullets only
4. Report, do not merge: The default merge policy authorizes no agent merge; never assume approval
5. Clean up: Confirm MERGED, then git worktree remove and git branch -D — see /core:git "Worktrees", "Cleanup, merged-only"