Eine komplette Anleitung zu Hermes Kanban: das Koordinationsmodell, das Teilen von Kontext zwischen Agenten und der Aufbau eines 4-Agenten-Softwareteams (PM, Backend, Frontend, Tester) in etwa 20 Minuten.
KI-Agenten sollten wie ein Team arbeiten.
Du beschreibst das Ziel. Sie teilen die Arbeit auf. Jeder übernimmt dort, wo der andere aufgehört hat.
So die Theorie. Was tatsächlich passiert, ist das Gegenteil. Agenten beginnen mit einer leeren Tafel. Ein Agent weiß nicht, was die anderen gebaut haben, welche Dateien geändert wurden oder wie die API aussieht. Jede Übergabe ist ein Kaltstart, und die Arbeit verschlechtert sich in dem Moment, in dem sie von einem Agenten zum nächsten wechselt.
Hermes Kanban behebt das. Jede Aufgabe überlebt Abstürze und Neustarts. Jeder Briefing enthält genau das, was der nächste Agent braucht. Jeder Fehler wird gespeichert, sodass der Wiederholungsversuch weiß, was kaputt ging.
So sieht deine Missionszentrale aus:
Kanban-Dashboard
Das Beste daran ist, dass das gesamte Team von deinem Telefon aus läuft. Du erstellst und steuerst Aufgaben über Telegram, und die Agenten nehmen sie auf, während du nicht am Schreibtisch bist.
Schau dir das an:
In diesem Artikel bauen wir das gesamte Setup von Grund auf: das Koordinationsmodell, die Briefings und ein 4-köpfiges Softwareteam, das auf deiner eigenen Hardware in etwa 20 Minuten läuft.
Um dies zu demonstrieren, habe ich einen funktionierenden Google Docs-Klon erstellt, inklusive KI-Funktionen, produktionsbereites Backend, gebaut von genau diesem Agententeam.
Google Docs-Klon-Demo
Also, ohne weitere Umschweife, lass uns loslegen.
Warum ein Agent nicht ausreicht
Angenommen, du möchtest eine Passwort-Zurücksetzen-Funktion hinzufügen. Die Arbeit verteilt sich auf drei Bereiche:
- Ein Backend-Entwickler, der die REST-API baut
- Ein Frontend-Entwickler, der diese API liest und die UI darauf aufbaut
- Ein Tester, der das Ganze Ende-zu-Ende verifiziert
1 vs. 3 Agenten
Du kannst alle drei durch einen einzelnen Agenten laufen lassen, aber der Kontextfenster füllt sich und der Agent verliert den Überblick, was er vor drei Schritten gemacht hat. Du verbringst mehr Zeit mit der Verwaltung, als es dir einspart.
Die Arbeit auf Agenten zu verteilen, die jeweils einen Bereich besitzen, schafft ein anderes Problem: Wie weiß der Frontend-Entwickler, was der Backend-Entwickler gebaut hat? Dieses Problem des gemeinsamen Kontexts löst Hermes Kanban.
Das mentale Modell: ein Aufgabenboard, aber hinter den Spalten sitzen Agenten
Eine Aufgabe hat einen Titel, eine Beschreibung, einen Besitzer und einen Status. Jemand nimmt sie auf, bewegt sie über das Board und schließt sie. Das Board ist die einzige Quelle der Wahrheit.
Hermes Kanban behält dieses Modell bei und stellt hinter jede Spalte Agenten statt Menschen.
Hermes Kanban-Board
Jede Aufgabe ist eine Zeile, die Abstürze und Neustarts überlebt. Wenn ein Agent fertig ist, schreibt er eine Zusammenfassung: geänderte Dateien, was er gebaut hat, was der nächste Agent wissen muss. Der nächste Agent liest diese Zusammenfassung, bevor er beginnt.
Diese Zusammenfassung ist die ganze Erkenntnis. Sie macht aus einer Gruppe von Agenten ein Team statt Fremde.
Das Vokabular
Wir haben 6 verschiedene Spalten auf dem Kanban-Board:
- Triage: Grobe Ideen landen hier, gut für „Ich möchte Auth-Rate-Limiting“, bevor du ein vollständiges Lastenheft hast.
- Todo: Aufgabe erstellt, wartet aber auf eine Abhängigkeit. Sie wird nicht verschoben, bis ihr Elternteil fertig ist.
- Ready: Abhängigkeiten erfüllt, wartet darauf, dass ein Agent sie aufnimmt.
- In Progress: Ein Agent läuft aktiv.
- Blocked: Der Agent ist auf ein Hindernis gestoßen und hat es für einen Menschen markiert. Nichts läuft, bis du es entblockst.
- Done: Abgeschlossen, mit vollständiger Ausführungshistorie, Zusammenfassung und Metadaten erhalten.
Der Orchestrator: Ein Agent, der die anderen verwaltet
Stell dir den Orchestrator-Agenten als den Projektmanager vor, der ein übergeordnetes Ziel liest, prüft, welche Agenten existieren, das Ziel in verknüpfte Aufgaben aufteilt und sich zurückzieht. Er schreibt niemals Code oder führt Tests aus. Er koordiniert.
Der Orchestrator-Agent
Die eine Regel, die zählt: Prüfe, welche Profile existieren, bevor du Aufgaben erstellst. Das System überspringt stillschweigend jede Aufgabe, deren Bearbeiter keinem echten Profil entspricht, also ist Schritt Null immer kanban_list.
Hier ist eine typische Runde des Projektmanagers, die eine Anfrage „Baue einen Passwort-Zurücksetzen-Ablauf“ in eine verknüpfte Pipeline zerlegt:
1kanban_show()23be = kanban_create(title="Passwort-Zurücksetzen-Backend", assignee="backend-developer",4 body="Passwort-vergessen/zurücksetzen-Ablauf + Sitzungsinvalidierung")56fe = kanban_create(title="Passwort-Zurücksetzen-UI", assignee="frontend-developer",7 parents=[be], body="Next.js-Reset-Ablauf unter Verwendung der Backend-API")89qa = kanban_create(title="E2E-Passwort-Zurücksetzen-Test", assignee="tester",10 parents=[fe], body="Alle Abnahmekriterien validieren")1112kanban_complete(summary="Erstellte Abhängigkeitspipeline: Backend → Frontend → QA")
Danach kümmert sich das Board um die Beförderung und die Briefings um den Kontext. Wenn alle drei fertig sind, wacht der Projektmanager auf, liest die Zusammenfassungen und beurteilt, ob die Arbeit erledigt ist. Wenn der Tester „Urteil“: „FEHLGESCHLAGEN“ zurückgibt, erstellt er Korrekturaufgaben und die Schleife wird fortgesetzt.
Aber in der Realität musst du dich um nichts kümmern. Du musst nur eine Aufgabe von Telegram aus delegieren, und der Orchestrator übernimmt von dort.
Drei Muster, die du ständig verwenden wirst
1. Die Pipeline:
Jede Aufgabe hängt von der vorherigen ab. Nur die erste startet im Status „Ready“. Alles andere wartet, bis es an der Reihe ist.
1BACKEND=$(hermes kanban create "Auth-API implementieren" \2 --assignee backend-developer \3 --body "POST /register, POST /login, POST /refresh, POST /logout." \4 --json | jq -r .id)56FRONTEND=$(hermes kanban create "Auth-UI erstellen" \7 --assignee frontend-developer \8 --parent $BACKEND \9 --body "Backend-Übergabe für API-Form lesen. Login-, Registrierungs- und Profilseiten." \10 --json | jq -r .id)1112hermes kanban create "Auth-Ablauf Ende-zu-Ende testen" \13 --assignee tester \14 --parent $FRONTEND \15 --body "Happy Path, falsches Passwort, abgelaufenes Token, Sitzungspersistenz abdecken."
Das führst du nicht von Hand aus. Du beschreibst das Projekt dem Projektmanager auf Telegram, und er erstellt diese Aufgaben für dich. Unter der Haube sieht es wie oben aus.
Wenn der Backend-Agent kanban_complete() aufruft, wechselt die Frontend-Aufgabe in den Status „Ready“, mit der Arbeit des Backends angehängt.
2. Mensch im Loop:
Nicht jeder Blocker ist ein Fehler. Manchmal findet ein Agent ein echtes Problem und hält an, um nachzufragen.
1kanban_block(reason="Überprüfung erforderlich: Passwortstärke-Prüfung fehlt, "2 "Reset-Token sind nicht einmalig verwendbar (können innerhalb von 30 Min. wiederholt werden)")
Du siehst den Block auf dem Dashboard. Du überprüfst das Problem, behebst es und entblockst die Aufgabe:
1hermes kanban unblock $IMPL
Das führst du auch nicht im Terminal aus, sondern kommentierst einfach im Kanban-Board oder sendest eine Nachricht auf Telegram, und das System entblockt es.
Das System startet den Agenten im nächsten Zyklus neu. Der zweite Durchlauf ruft kanban_show() auf und sieht genau, warum der erste Versuch blockiert war. Es weiß genau, was zu beheben ist; es beginnt nicht von Null.
3. Triage-Spezifizierer.
Wenn du eine grobe Idee statt eines vollständigen Lastenhefts hast, wirf sie auf das Board und lass das System sie ausarbeiten, bevor ein Agent sie aufnimmt.
1# Eine grobe Idee ablegen2hermes kanban create "Auth benötigt Rate-Limiting" --triage --assignee backend-developer34# Ausarbeiten, bevor der Dispatcher sie aufnimmt5hermes kanban specify $TASK_ID
Der Befehl specify schreibt den Drei-Wort-Titel in eine vollständige Aufgabe mit Ziel, Ansatz und Abnahmekriterien um. Der Agent, der sie aufnimmt, erhält eine echte Aufgabenbeschreibung.
Einrichtung: Vier Profile in etwa 20 Minuten
Vier Agenten, ein gemeinsames Board, der Projektmanager über Telegram erreichbar.
Schritt 1: Profile erstellen.
1hermes profile create project-manager --clone2hermes profile create backend-developer --clone3hermes profile create frontend-developer --clone4hermes profile create tester --clone
--clone kopiert die Konfiguration deines Standardprofils als Ausgangspunkt.
Schritt 2: Jedem Agenten eine Persönlichkeit geben
1. Project Manager unter ~/.hermes/profiles/project-manager/SOUL.md:
1# Seele23Du bist der Projektmanager für ein Softwareentwicklungsteam. Deine Aufgabe4ist es, die App-Idee eines Benutzers aufzugreifen, sie in klare Aufgaben zu5unterteilen, sie den richtigen Teammitgliedern zuzuweisen und den Fortschritt6auf dem Kanban-Board zu verfolgen. Du schreibst selbst keinen Code. Du7verwaltest die Arbeit.
2. Backend Developer unter ~/.hermes/profiles/backend-developer/SOUL.md:
1# Seele23Du bist der Backend-Entwickler in einem Softwareteam. Du erstellst und4verwaltest das gesamte Backend mit InsForge – Datenbank, Authentifizierung,5Speicher, Edge Functions und Bereitstellung.
3. Frontend Developer unter ~/.hermes/profiles/frontend-developer/SOUL.md:
1# Seele23Du bist der Frontend-Entwickler in einem Softwareteam. Du erstellst die UI –4Komponenten, Seiten und Benutzerabläufe – und verbindest sie mit dem Backend5unter Verwendung der APIs und SDK-Methoden, die der Backend-Entwickler6eingerichtet hat.
4. Tester unter ~/.hermes/profiles/tester/SOUL.md:
1# Seele23Du bist der Tester in einem Softwareteam. Du testest fertige Funktionen4Ende-zu-Ende, überprüfst die Erfüllung der Abnahmekriterien und meldest5Fehler klar an das Kanban-Board zurück, damit sie behoben werden können.
Schritt 3: Agenten-Fähigkeiten hinzufügen
Fähigkeiten sind Schritt-für-Schritt-Anleitungen, spezifische Anweisungen für bestimmte Arten von Arbeit. Stell sie dir als Jobtraining für deine Agenten vor. Lass sie uns einzeln auflisten:
InsForge (Open-Source, Apache 2.0) fungiert als Backend-Context-Engineering-Schicht für Agenten, die Skills und CLI verwenden. Unser Backend-Entwickler-Agentenprofil nutzt diese Fähigkeit, um einen sofort einsatzbereiten Backend-Dienst für Projekte zu haben.
Füge zuerst den InsForge-Skills-Tap hinzu:
1hermes skills tap add InsForge/insforge-skills
Installiere dann die Backend-Fähigkeiten:
1hermes -p backend-developer skills install InsForge/insforge-skills/insforge --force
Auf die gleiche Weise installieren wir weitere als insforge-cli (Infrastrukturbefehle), insforge-debug (Fehlerdiagnose) und insforge-integrations (Drittanbieter-Authentifizierungsanbieter).
So verwendet der Backend-Entwickler-Agent die Fähigkeit, um unser Projekt-Backend auf InsForge zu erstellen.
Zuerst erstellt der Backend-Entwickler-Agent ein Projekt namens „Google Docs Clone“ in InsForge.
Das Dashboard zeigt Projektstatistiken wie die Anzahl der Benutzer, Tabellen in der Datenbank, Speicher und eine Liste von Edge Functions mit bereitgestelltem JavaScript/TypeScript-Code, der sich auf Authentifizierung, Dokumentenverwaltung usw. bezieht.
Wenn du also einen KI-Backend-Ingenieur baust, schau dir InsForge an →
(Vergiss nicht, einen Stern zu geben 🌟)
Weitere Fähigkeiten aus dem Skills Hub
Hermes unterhält außerdem einen Skills Hub mit 687 Fähigkeiten in 18 Kategorien: 87 integrierte, 79 optionale, 16 von Anthropic (frontend-design, pdf, pptx, docx, mcp-builder und mehr) und 505 von LobeHub.
Installiere für den Frontend-Entwickler frontend-design. Für den Tester installiere webapp-testing. Beide sind im Hub enthalten.
Schritt 4: Board initialisieren und Gateway starten.
hermes kanban init erstellt ~/.hermes/kanban.db, die SQLite-Datenbank, die jede Aufgabe, jeden Kontext und jede Ausführungshistorie speichert.
Richte dann das Chat-Gateway unter dem Projektmanagerprofil ein. Hol dir ein Bot-Token von @BotFather auf Telegram und deine Benutzer-ID von @userinfobot, dann:
1hermes kanban init2hermes -p project-manager gateway setup3hermes -p project-manager gateway start
Die Verbindung läuft 24/7, hält das System am Leben und macht den Projektmanager auf Telegram erreichbar.
Schritt 5: Sende dein erstes Projekt.
Schreib dem Projektmanager, was du gebaut haben möchtest. Es zerlegt das Ziel in Aufgaben, erstellt sie mit Abhängigkeitslinks, und das System führt sie der Reihe nach aus.
Das Dashboard
Führe hermes dashboard aus und öffne http://127.0.0.1:9119. Du erhältst eine Spalte pro Status und Live-Updates über einen WebSocket, ohne dass ein Aktualisieren erforderlich ist.
0:20
Hermes Kanban-Dashboard
Zwei Steuerelemente sind wissenswert. Lanes by profile unterteilt die Spalte „Running“ nach Bearbeiter, sodass du auf einen Blick sehen kannst, welcher Agent was besitzt. Nudge dispatcher führt sofort einen Durchlauf aus, anstatt 60 Sekunden zu warten, was direkt nach dem Entblocken einer Aufgabe hilfreich ist.
Klicke auf eine Karte, um ihre Schublade zu öffnen, um die vollständige Ausführungshistorie, das Ergebnis und die Metadaten jedes Versuchs sowie bearbeitbare Felder für Titel, Bearbeiter, Priorität und Abhängigkeiten anzuzeigen.
Worauf du achten solltest
Drei Fehlermodi, die du vor einer ernsthaften Arbeitslast kennen solltest.
1. Datenbanküberlastung.
Mit 2 bis 4 parallelen Agenten wirst du das nie erreichen. Mit 10+ Agenten, die mit hoher Frequenz schreiben, wird es langsamer. Begrenze es mit hermes kanban dispatch --max 4.
2. Löschung des Scratch-Workspace.
Dateien, die in einem Scratch-Workspace gespeichert werden, sind verschwunden, sobald die Aufgabe als erledigt markiert ist, da Scratch absichtlich gelöscht wird. Verwende worktree für Codierungsaufgaben oder füge den Pfad des Projektordners in die Aufgabenbeschreibung ein, damit der Agent weiß, wo er speichern soll.
3. Sättigung des lokalen Modells.
Bei einem lokalen Modell (Ollama, lokale GPU) kann das System mehrere Agenten gleichzeitig starten und die GPU überlasten, was die Generierung verlangsamt und den automatischen Stopp auslöst. Für lokale Setups: hermes kanban dispatch --max 2. Bei API-gestützten Modellen wie Claude oder GPT-4o ist dies selten ein Problem.
Das Gesamtbild
Jedes Teil hat eine Aufgabe:
- SOUL.md ist die feste Identität des Agenten: wer er ist und wie er denkt.
- Skills sind die Schritt-für-Schritt-Anleitungen für bestimmte Arten von Arbeit.
- Memory ist, was der Agent über deine Umgebung über Sitzungen hinweg weiß.
- Kanban ist die Koordinationsebene: gemeinsamer Zustand, Kontextübertragung und ein Mensch im Loop zu jedem Zeitpunkt.
Vier Profile, vier SOUL.md-Dateien, ein Gateway-Start. Beschreibe dem Projektmanager auf Telegram, was du gebaut haben möchtest, und sieh zu, wie sich das Board füllt.
Wenn du besser aus Videos lernst, erscheint in ein paar Tagen eine vollständige Hermes-Kanban-Anleitung auf YouTube und X.
Danke fürs Lesen.
