Walt, the Waggle mascot: a round apricot bee with two dark stripes, soft wings and a small smile.

When contributors run agents, the agents collide.

Overlapping edits, the same work done twice, pull requests that conflict, and nobody who can say who is on what. Waggle is a hive for many people and their agent teams on one repository. Each keeper (a human in charge) talks with a queen (an agent that plans the work). She writes each task a lane, called a claim, and the guard fails a merge that leaves it.

The guard works today. The rest of the hive is on the roadmap, and each part says which it is.

How it works, with an example

A forager (the coding agent doing the work) opens a pull request. The guard, our merge check, reads the lease (the directories the task may change) and tests every commit against it. One commit outside the lease blocks the merge.

Example: a forager's PR through the Waggle Gate Example. The ticket Add Apple Pay to checkout has a lease written by the queen before work starts: src/checkout/ and src/payments/. The forager opens a PR with four commits. The guard, Waggle Gate, checks each commit against the lease. 3f9a1c changes src/checkout/ApplePayButton.tsx, 8b27e4 changes src/payments/applePay.ts and 5ce6a9 changes src/checkout/checkout.test.ts; all three are inside the lease and pass. d41f07 changes infra/prod/database.tf, outside the lease, so it is must-fix and the PR is blocked. The PR merges only when every commit passes. Example 1. The lease, written first Add Apple Pay to checkout src/checkout/ src/payments/ May change only these paths. The queen writes it. Never the forager. It exists before the work starts. 2. The forager opens a PR PR #1042, 4 commits From the coding agent, or a person with a branch. 3. The guard (Waggle Gate) checks every commit reads the lease from the claim, kept in a git ref 3f9a1c src/checkout/ApplePayButton.tsx inside the lease pass 8b27e4 src/payments/applePay.ts inside the lease pass d41f07 infra/prod/database.tf outside the lease infra/ is not in this claim must-fix 5ce6a9 src/checkout/checkout.test.ts inside the lease pass Blocked: d41f07 left the lease. Fix the commit or widen the lease. It merges when every commit passes. 4. One must-fix blocks the PR
Example: a forager's PR through the Waggle Gate Example. The ticket Add Apple Pay to checkout has a lease written by the queen before work starts: src/checkout/ and src/payments/. The forager opens a PR with four commits. The guard, Waggle Gate, checks each commit against the lease. 3f9a1c changes src/checkout/ApplePayButton.tsx, 8b27e4 changes src/payments/applePay.ts and 5ce6a9 changes src/checkout/checkout.test.ts; all three are inside the lease and pass. d41f07 changes infra/prod/database.tf, outside the lease, so it is must-fix and the PR is blocked. The PR merges only when every commit passes. Example 1. The lease, written first Add Apple Pay to checkout src/checkout/ src/payments/ The queen writes it. Never the forager. 2. The forager opens a PR PR #1042, 4 commits 3f9a1c src/checkout/ApplePayButton.tsx 8b27e4 src/payments/applePay.ts d41f07 infra/prod/database.tf 5ce6a9 src/checkout/checkout.test.ts 3. The guard (Waggle Gate) checks every commit against the lease, read from its claim 3f9a1c inside the lease pass 8b27e4 inside the lease pass d41f07 outside the leaseinfra/ is not in this claim must-fix 5ce6a9 inside the lease pass Blocked: d41f07 left the lease. It merges when every commit passes.

Meet the hive

Waggle talks in bees on purpose. Every role is a plain job underneath, so here is each one in a line. Most of the work comes from the agent team: keepers talk with their queens, and the queens open the GitHub issues and write the claims. A person can also write an issue.

Keeper

A human in charge. You own a plan and the agents that carry it out, and you stay the one who decides.

Queen

An agent you talk with. She plans the work, opens the issue and writes the claim. She does not write feature code.

Forager

The coding agent doing the work. It goes out, changes the files and brings a pull request back. It never writes its own claim.

Guard

The gate that checks the lease. It reads every commit and says pass or must-fix. Built

Builder

A worker that implements a task inside its claim. waggle dispatch runs one today. Built

Scout

A planner that searches ahead and writes the task brief. The instructions ship, but Waggle does not run scouts for you yet. Coming soon

The whole hive, built and coming · Glossary of every bee word

What goes wrong without a hive

Overlapping edits

Two foragers change the same files. One overwrites the other, or the pull requests will not merge.

The same work, twice

Nothing records that a task is already taken, so a second agent starts it and the effort is wasted.

Nobody can see who is on what

Branches pile up. A keeper has to reconstruct the plan from the diff.

The first piece you can use today: the gate

A claim

A record of one task: the directories it may change and the branches its pull request may come from. You talk with your queen and she writes the claim. The forager doing the work never writes its own. A queen opening issues straight from your conversation is Coming soon; a person can also write an issue.Claims and leases

A lease

Those directories. That is the lane the forager is supposed to stay inside, like a bee on its own comb.

The gate, run by the guard

A GitHub merge check, verify-leases-and-tiers. It fails a pull request whose commits change a path outside the lease, or whose claim does not name that pull request's branch. It checks every commit, not only the final diff.The gate spec

A keeper stays in control

A keeper is the person who works with the queen. Paths you list as protected still need an approver's approval. Control files such as workflows fail no matter what the claim says. Waggle does not run your foragers; it guards the hive they work in.Protected paths

Walt the bee.

Who it's for

Teams, and open-source projects, where more than one keeper runs an agent team on the same repository. Today the gate holds the line for all of them. Next come guidance for many keepers on one repo, thenhoney: a contributor's standing, earned from merged work that lasts, with Nectar (reputation) and Quorum (voting on priorities). Honey is Roadmap. If that sounds like your hive, the quick start is the place to begin.

What it does not do

It does not schedule or run foragers, and it is not a sandbox. It binds only on PRs that must pass the check, an admin bypass merges without it, and the required check can be forged by a workflow or token with the right permissions. The limits are written down, with the tests that show them, inthe gate spec.

Waggle is pre-1.0 and supports GitHub only. The spec describes what the code does today, and the recipes have not been run end to end with each tool.