mcpField
H
honey-hive

honey-hive

github.com/green-ptAgent workflows34439 installsUpdated 1w ago
Repository

About honey-hive

honey-hive is a skill for delegating context-heavy code searches and reviews to subagents, aimed at orchestrators handling parallel work. Read-only agents return compact structured results, leaving decisions and edits to the orchestrator.

Key features

  1. 01Delegate code-location tasks
  2. 02Delegate diff and file reviews
  3. 03Run independent tasks in parallel
  4. 04Return compact JSON results
  5. 05Read findings by ID and verify counts

Use cases

  1. 01Find symbols and callers across files
  2. 02Review multiple diffs or file sets in parallel
  3. 03Get conclusions without loading full file bodies

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/green-pt/honey-for-devs --skill honey-hive

After installing, type/honey-hivein Claude Code to confirm it loaded.

Details

From the project README

Honey Hive

Delegate the token-heavy reading; keep the thinking. A subagent's return is injected back into your context — Honey's hive returns it as a compressed Lever-3 handoff, so the most expensive tokens in an agentic session shrink ~25–55% with no loss the orchestrator can use.

When to delegate (any one holds)

  • Search-heavy — "where is X / who calls Y / find all Z" across many files → hive-scout.
  • Review-heavy — review a diff or file set for bugs and bloat → hive-reviewer.
  • Context-preserving — the read would dump many files into your context but you need only the conclusions.
  • Parallel — independent locate/review jobs that can run at once.

When NOT to (work inline)

  • One known file, a trivial edit, or content you already have in context.
  • Dispatch + return overhead would exceed just reading it yourself (a file or two).
  • You need the full file body, not a map.

The crew is read-only by design — they locate and review; you decide and edit.

The crew

AgentDoesReturns
hive-scoutlocate symbols / callers / configs / patternscompact id-keyed JSON map
hive-reviewerreview diff/files for bugs + over-engineering + verbositycolumnar id-keyed JSON findings

Reading a hive return (Lever 3, in reverse)

Every return is compact/columnar JSON, records addressed by a stable id, with an n count. Read it as data:

  • Address by id, never "the 3rd finding" — ordinal lookup misparses, frontier models included.
  • Aggregate in code — to count or filter, do it programmatically; don't eyeball rows.
  • Check n against the rows you received — a dense misparse is silent.
  • Safety carve-out — auth / money / migration / delete findings come back explicit, not slugged. Treat them verbatim.

ESON is opt-in: ask for it only on a high-volume, cached review pipe you own end-to-end.

Comments

Markdown supported