# beehive

> 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).

- Author: Jarred
- Repository: jarredbarber/beehive
- Version: 20260210022737
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-10
- Source: https://github.com/jarredbarber/beehive
- Web: https://mule.run/skillshub/@@jarredbarber/beehive~beehive:20260210022737

---

---
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/<role>.md` for role-specific instructions.
4. Read `test_command` from `.bh/config.yaml`.

## Workflow

```bash
bh begin <issue>           # create task branch, check out
# ... do the work ...
# ... run test_command, iterate until it passes ...
git add -A && git commit -m "Close #<issue>: <summary>"
bh submit <issue> --model <name> --summary "<what you did>"
```

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 <id> "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 <id>              Create task branch from main
bh submit <id> [opts]      Push + create PR
  --model <name>           Model used
  --summary <text>         What you did
bh release <id> [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.