Agent-Einrichtung

Verbinde deine KI-Coding-Agents mit dem bd CLI, damit sie Beads erstellen, aktualisieren und schließen können. Beadbox zeigt ihre Arbeit in Echtzeit.

Voraussetzungen

Bevor du Agents einrichtest, brauchst du:

  • Das bd CLI installiert und im PATH (Erste Schritte)
  • Mindestens einen initialisierten Workspace (bd init in deinem Projektverzeichnis)
  • Beadbox läuft und ist mit diesem Workspace verbunden

Agent-Identität

Jeder Agent braucht eine CLAUDE.md-Datei (oder einen gleichwertigen System-Prompt), die definiert:

  • Wofür der Agent zuständig ist (Implementierung, QA, Betrieb)
  • Wofür der Agent nicht zuständig ist (verhindert, dass Agents in andere Rollen abdriften)
  • Wie kommuniziert wird (auf Beads kommentieren, an den Koordinator berichten)

Hier ist eine minimale Identität für einen Engineering-Agent:

## Identity
Engineer for MyProject. You implement features, fix bugs,
and write tests. You own implementation quality.

## Boundary with QA
QA validates your work independently. You provide QA with
executable verification steps. If your DONE comment doesn't
let QA verify without reading source code, it's incomplete.

Der Abschnitt zu den Grenzen verhindert, dass der Agent die Arbeit des QA übernimmt. Ohne explizite Grenzen validieren sich Agents selbst und überspringen die unabhängige Überprüfung.

Wichtige Befehle

Das sind die bd-Befehle, die deine Agents am häufigsten verwenden:

Einen Bead erstellen

bd create --title="Fix login bug" --type=bug --priority=2

Einen Bead anzeigen

bd show BEAD-ID

Status aktualisieren und Arbeit übernehmen

bd update BEAD-ID --claim --actor agent-name
bd update BEAD-ID --status in_progress

Einen Plan oder Abschlussbericht posten

bd comments add BEAD-ID --author agent-name "PLAN: ..."
bd comments add BEAD-ID --author agent-name "DONE: ..."

Beads auflisten

bd list --status=open --assignee=agent-name

Einen abgeschlossenen Bead schließen

bd close BEAD-ID

Alle Befehle akzeptieren ein --db-Flag, um eine bestimmte Workspace-Datenbank anzusprechen. Das ist nützlich, wenn Agents an mehreren Projekten arbeiten.

Der Befehl bd prime

Der schnellste Weg, einem neuen Agent das bd CLI beizubringen:

bd prime

Das erzeugt einen Kontextblock, der für KI-Coding-Assistenten konzipiert ist. Er deckt den gesamten Befehlssatz, Ausgabeformate und gängige Workflows ab. Füge ihn in den System-Prompt oder das Kontextfenster deines Agents ein.

Führe bd prime aus deinem Workspace-Verzeichnis heraus aus, um workspace-spezifischen Kontext einzubeziehen.

Agent-Workflow

Ein typischer Agent-Workflow für einen einzelnen Bead:

  1. Den Bead übernehmen
  2. Einen Plan kommentieren, bevor du codest
  3. Die Änderung implementieren
  4. Tests ausführen
  5. Abschluss mit Verifizierungsschritten kommentieren
  6. Pushen und Status auf ready_for_qa setzen
# Full workflow example
bd update proj-a1b2 --claim --actor eng1
bd comments add proj-a1b2 --author eng1 "PLAN: 1. Fix auth check 2. Add test"

# ... implement and test ...

bd comments add proj-a1b2 --author eng1 "DONE: Fixed auth. Commit: abc123"
git push
bd update proj-a1b2 --status ready_for_qa

Der DONE-Kommentar muss Verifizierungsschritte enthalten, mit denen ein anderer Agent (oder ein Mensch) die Arbeit bestätigen kann, ohne den Quellcode lesen zu müssen.

Echtzeit-Feedback

Wenn ein Agent einen bd-Befehl ausführt, erkennt Beadbox die Datenbankänderung und aktualisiert die Oberfläche innerhalb von zwei Sekunden. Kein manuelles Neuladen nötig.

Du kannst deinen Agents in Echtzeit bei der Arbeit zusehen: Beads wechseln von open zu in_progress, Pläne erscheinen als Kommentare, und Blocker werden sofort sichtbar.

Bei Multi-Agent-Setups zeigt das Aktivitäts-Dashboard, welcher Agent woran arbeitet, wo sich Arbeit in der Pipeline staut und was gerade in der gesamten Flotte passiert ist.