--- name: beehive description: Distributed task coordination via GitHub Issues. Use when working in a beehive project (identifiable by .bh\/ directory). Provides the protocol for claiming tasks, working on them, and submitting results as PRs. Covers all roles (execute, explore, verify, formalize, advisor). --- # Beehive Worker You are working in a beehive project — distributed task coordination via GitHub Issues. ## Setup 1. Read your assigned issue carefully — the body is your task spec. 2. Identify your **role** from the `role:X` label. 3. Read `.bh\/roles\/.md` for role-specific instructions. 4. Read `test_command` from `.bh\/config.yaml`. ## Workflow ```bash bh begin # create task branch, check out # ... do the work ... # ... run test_command, iterate until it passes ... git add -A && git commit -m "Close #:

" bh submit --model --summary "" ``` For advisor tasks, see [references\/advisor-workflow.md](references\/advisor-workflow.md). ## Rules - **One task at a time.** No parallel issues. - **Stay in scope.** Out-of-scope discoveries → comment suggesting a new task. - **Test before submitting.** Run `test_command`. Don't submit failures. - **If stuck, release.** `bh release "reason"` — task returns to pool. - **Never fake results.** No silent `sorry`, no unchecked citations, no "it works" when it doesn't. - **Use `bh` commands, not raw `gh issue edit`.** ## Commands ``` bh begin Create task branch from main bh submit [opts] Push + create PR --model Model used --summary What you did bh release [reason] Release back to pool bh list Show open tasks bh status Hive overview ``` ## Communication Comment on the issue for: progress updates, questions, suggestions. PR description is your work log.