The Hive Mind Dev Engine
Honeymoon
A local-first swarm engine that decomposes tasks, dispatches parallel worker bees in isolated worktrees, and merges the results. Designed for weak hardware and local quantized LLMs.
THE_HIVE_V5
👑 The Queen — Planner
🏗 The Builder — Implementer
🩺 The Nurse — Debugger
🔍 The Inspector — TestGen
🐝 The Guard — Security
💃 The Waggle — Release
🍯 The Keeper — Archivist
Swarm, Not Sequence
Most agentic dev tools work sequentially — one agent, one file, one task at a time. Honeymoon decomposes objectives into non-overlapping sub-tasks and dispatches parallel worker bees, each in its own isolated git worktree.
Agents communicate through the environment, not through each other. Stigmergic coordination via a shared pheromone trail — the same pattern ant colonies use to solve complex problems without central control.
Symbol locking prevents collisions. A sentry monitors token burn and kills doom-looping agents. Wave scheduling handles dependencies. The result: parallel execution with deterministic governance.
Swarm Mode
The killer feature. Give Honeymoon an objective and a number of ants. It decomposes, dispatches, coordinates, and merges.
$ honeymoon swarm --repo . --objective "Add rate limiting to all API endpoints" --ants 5
Task → Decomposer → [Sub-task A] → Ant 0 (worktree 0)
[Sub-task B] → Ant 1 (worktree 1)
[Sub-task C] → Ant 2 (worktree 2)
Pheromone Trail (.honeymoon/pheromones.jsonl) → Consensus Merge
Pheromone Trail
Shared awareness via file-locked append-only log. Ants see who is editing what, what failed, what succeeded.
Symbol Locking
If Ant 0 claims router.py, Ant 1 skips it and picks a different sub-task. No merge conflicts.
Sentry
Monitors token burn rate. Kills doom-looping ants. Halts the swarm if budget is blown.
Wave Scheduling
Dependency-ordered execution. Independent sub-tasks run in parallel, dependent ones wait.
The Pipeline
Every task moves through a gated sequence. Every step produces a structured event. Nothing ships without approval.
Plan
The Queen
Breaks tasks into surgical steps. Directs the hive. Never writes code.
Implement
The Builder
Writes code in a tool loop: think, read, search, write, verify. Isolated worktree.
Debug
The Nurse
Fixes broken tests. Scope-locked to the failure. Thrash detection kills infinite loops.
Test
The Inspector
Single-shot regression test generation. Validates the implementation holds.
Secure
The Guard
Scans diffs for vulnerabilities, credential leaks, policy violations. Can block the pipeline.
Release
The Waggle
Determines version bump and changelog via the waggle dance. SemVer-aware.
Archive
The Keeper
Writes Architecture Decision Records. Preserves the hive's memory in royal jelly.
Deliver
PR
Commits, pushes, and opens a structured pull request for your final review.
PPrelude Integration
Honeymoon ingests machine-readable context from Prelude. The hive understands your architecture, stack, and constraints before the Queen plans — so implementation follows your patterns, not generic advice.
Explore PreludeZZephyr Provenance
For high-stakes environments, every event in the pipeline becomes a cryptographically signed record. The append-only audit trail is Zephyr-compatible out of the box — verifiable proof of every agent decision, tool invocation, and file edit.
Explore ZephyrDesign Principles
Local-First
Runs on your machine. Targets weak hardware and local quantized LLMs. No cloud dependency. Costs only API tokens.
Repo-Agnostic
Rust, Python, TypeScript, Go — anything with tests. Honeymoon does not care about your stack.
Stigmergic
Agents communicate through the environment, not direct messages. The pheromone trail is the coordination layer.
Deterministic
Controller logic is explicit, not probabilistic. Every pipeline step is a gate. Every action is an event.
Bounded
Budget caps, retry limits, tool allowlists, doom-loop detection. The sentry kills agents that spiral.
Vendor Agnostic
Route work to any model via LiteLLM. The bees do not know or care which vendor powers them.
Release the swarm.
Honeymoon compounds capability locally, under your governance, at token cost. MIT licensed. Clone it and run.