
Hive.worker Delegation
Concrete patterns for breaking colony work into parallel worker jobs via run_playbook, ...
Install
npx skills add aden-hive/hive --skill hive.worker-delegation -g -a claude-code -y- Repository
- aden-hive/hive11.1k
- Category
- Writing
- Updated
- 9d ago
- License
- Apache-2.0
- Context cost
- Mediumabout 3,000 tokens
- Runs scripts
- No, instructions only
What it does
Concrete patterns for breaking colony work into parallel worker jobs via run_playbook, when fan-out helps, how to model the goal as a tracker table, write the worker skill, author the playbook, pilot, and let convergence retry/resume the gap.
Operational Protocol: Worker Delegation
Applies when you're in COLONY mode and considering whether (and how) to fan out work to parallel workers via run_playbook. Read this before fan-out, not during.
Mental model: the tracker is the spine, the playbook is the controller
You don't coordinate workers by reading their reports and deciding what's next each turn. You model the goal as a tracker table where every unit of work is a row, and you write a playbook, a deterministic Python script, that drives that table to completion:
The playbook queries the rows that aren't done yet, dispatches one worker per undone row, and re-queries until none are left. Workers advance their own rows. Re-running the playbook resumes, done rows simply aren't in the work-list anymore.
This is a reconciliation loop. The tracker is the state; the playbook is the controller that converges it. Three artifacts, three jobs:
- Tracker table, the durable work-list and its state. The row's status column is the progress.
- Skill (
write_skill), the worker's operating procedure: schema, tool sequence, output format, quality bar. The risky part. - Playbook (
run_playbook), the deterministic orchestration: which rows are undone, who runs them, rate limits, retry/convergence policy. The cheap part.
The worker's task string carries only the per-row slice; everything reusable lives in the skill, everything deterministic lives in the playbook.
The decision: should you fan out at all?
Fan-out helps when:
- The work has N independent units (rows, person on linkedin, files, accounts, segments) and each unit takes meaningful tool time (browser, API, file read, LLM call).
- The units are disjoint, no two workers need to write the same row at the same time.
- You can describe one unit's work in <100 words once shared playbook is in the skill.
