Glossary
Waggle uses bee words on purpose. Each one stands for something plain, and this page says what. The big picture is on the hive. Terms for things that are not built yet are marked roadmap.
People and agents
Section titled “People and agents”Keeper. A human working on the repo. Each keeper owns a plan and the agents that carry it out.
Head Keeper. The keeper who owns the project’s direction. The first login in gate.approvers. Only their approval passes a change to the hive’s steering files.
Master Keeper. The project owner, today the Head Keeper, in their role as holder of the veto over Quorum results. Roadmap, with Quorum.
Queen. A coordinating agent a keeper talks to. She does not write feature code. She agrees the task with the keeper, opens the issue, writes the claim and starts the workers.
Forager. A worker that brings material back: it reproduces bugs, writes failing tests and maps which directories a task needs.
Builder. A worker that implements a task inside its claim.
Guard. A reviewer. It reads a change, ideally on a different model than the builder’s, and ends with a pass or a must-fix.
Scout. A planner. It writes task briefs, the roadmap and the specs.
Walt. Our mascot, a round apricot bee. He is not a role.
Places and records
Section titled “Places and records”Hive. The shared repository and the rules every agent works under. The .waggle/hive/ folder holds its steering files, such as the roadmap and the decisions log.
Claim. A record, kept in git refs, that a task is being worked on. It names which directories the task may change and which branches its pull request may come from.
Lease. The directories a claim lets a task change.
Gate. A required GitHub check, verify-leases-and-tiers, that fails a pull request whose commits leave their task’s lease.
Tier. How much review a path needs. Tiers 0 and 1 are small work, Tier 2 is steering files and logic, and Tier 3 is control paths no claim can lease.
Decisions log. An append-only file, .waggle/hive/DECISIONS.md, that records project decisions with their reasons.
Dispatch. waggle dispatch: claims a task, runs a worker in its own worktree and checks its changes against the claim.
Honey. A contributor’s standing in the project, built from real merged work. It has two halves, Nectar and Quorum. Roadmap.
Nectar. Reputation from merged commits that survive 30 days on main without a revert, credited through the claim. Roadmap.
Quorum. Quadratic voting on roadmap and issue priority, where each person’s weight is the square root of their Nectar. The Master Keeper can veto the result. Roadmap.
See the hive for what is built and what is coming.