← Projekte

Apiary

Ein Auftragsrouter für KI-Agenten. Er stellt Arbeitsaufträge zu, startet die Agenten, holt ihre Berichte ab und lässt die Ergebnisse von einer eigenen Instanz abnehmen.

Status: täglich im Einsatz

Die Kachel Bee-Arbeit in SyncDeploy: oben die Queen, untätig und ohne offenen Bericht, darunter sechs Bienen. deploy-bee ist aufgeklappt und arbeitet am Auftrag 2026-09-29-whisper-inventar, seit einer Minute, mit Tokenverbrauch und den letzten drei Commits.
Die Kachel „Bee-Arbeit“ in SyncDeploy. deploy-bee arbeitet gerade an einem Auftrag.

Was es ist

In meinem Setup arbeiten mehrere KI-Agenten nebeneinander. Jeder hat ein eigenes Repository und ein eigenes Fachgebiet, zum Beispiel Rust, Java oder das Deployment. Ich nenne sie Bienen. Eine Instanz von minibee ist die Queen: sie schreibt die Aufträge und nimmt die Ergebnisse ab.

Apiary ist das Programm dazwischen. Es sorgt dafür, dass ein Auftrag ankommt, bearbeitet und geprüft wird, ohne dass ich im Gespräch darauf warten muss.

Wie es funktioniert

Ein Ordner pro Auftrag

Jeder Auftrag ist ein Ordner. Darin liegt der Auftrag selbst, und jedes spätere Dokument kommt als neue, nummerierte Datei dazu: Nachtrag, Eskalation, Bericht, Abnahme. Die Nummer läuft über den ganzen Ordner. So ist die Dateiliste die Geschichte des Auftrags, in der Reihenfolge, in der sie passiert ist.

Der Auftrag wird nach der Prüfung nicht mehr geändert. Der Ordner wird nie verschoben. Eine Biene bekommt den Pfad, nie eine Kopie.

Zustände in der Datenbank

Den Zustand eines Auftrags hält PostgreSQL, nicht der Ort seines Ordners. Ein Auftrag geht durch feste Zustände: eingegangen, zugestellt, in Arbeit, berichtet, in Abnahme, abgenommen. Fällt die Abnahme durch, geht er als Nacharbeit zurück an die Biene. Nach zwei Runden wird er geparkt und landet bei mir.

Der Keeper

Ein zweites Programm läuft als Dienst, der Keeper. Er startet eine Biene, sobald ein Auftrag für sie da ist, höchstens zwei gleichzeitig. Liegt ein Bericht vor, startet er die Queen in einem eigenen Klon des Repositorys.

Die Queen führt die Tests aus und prüft jeden Abnahmepunkt am laufenden Programm. Sie baut gezielt Fehler ein und schaut, ob die Tests sie finden. Ein Test, der dabei grün bleibt, steht als Befund im Protokoll. Hält die Abnahme, pusht die Queen das Ergebnis.

Technik

Rust und PostgreSQL. Die Agenten sprechen Apiary über MCP an, das Model Context Protocol. Ein Aufruf gibt eine Quittung mit Nummer zurück. Ob ein Auftrag angekommen ist, fragt man ab, statt aus einem leeren Postfach darauf zu schließen.

Stand

Apiary ist täglich im Einsatz. Die Kachel „Bee-Arbeit“ in SyncDeploy zeigt, welche Biene gerade arbeitet.