Mehrere KI-Agenten in einem Projekt: So kommen sie sich nicht in die Quere

Woher Konflikte kommen

Mit einer Sitzung eines Coding-Agenten ist die Sache einfach: ein Terminalfenster, ein Gespräch und eine Aufgabe. Starten Sie mehrere Sitzungen gleichzeitig im selben Repository, können vier Probleme auftreten:

• Dieselben Dateien. Sitzungen, die im selben Ordner gestartet wurden, arbeiten mit denselben Dateien. Eine kann die Arbeit der anderen überschreiben, und die Tests der einen können wegen unfertiger Änderungen der anderen fehlschlagen.
• Dieselbe Arbeit. Zwei Sitzungen haben ähnliche Anweisungen bekommen und tun beide dasselbe, jede auf ihre Weise.
• Falsche Reihenfolge. Ein Agent beginnt eine Arbeit, die das Ergebnis einer anderen braucht, die noch nicht fertig ist. Er baut zum Beispiel einen Bildschirm, der eine noch nicht vorhandene API nutzt, und rät, wie diese API aussehen wird.
• Kein Überblick. Die Aufgaben stehen nur in Terminalfenstern. Nach einer Stunde lässt sich schwer sagen, welche Sitzung was tut und was bereit zur Prüfung ist.

Gemeinsame Dateien trennt ein eigener Ordner für jede Sitzung. Doppelte Arbeit und falsche Reihenfolge verhindern zwei Regeln: Eine Sitzung liefert einen Plan, und Abhängigkeiten zwischen den Plänen zeigen, was sofort starten kann. Den Überblick gibt ein Ort, an dem diese Pläne festgehalten sind.

Jede Sitzung in ihrem eigenen Ordner

Geben Sie jeder Sitzung, die Code ändert, eine eigene Arbeitskopie. Dafür gibt es in Git den Worktree: ein zusätzliches Arbeitsverzeichnis desselben Repositorys, mit eigenen Dateien und eigenem Branch, aber mit gemeinsamer Historie. Sie legen ihn mit einem Befehl im Ordner des Projekts an:

git worktree add -b backend ../shop-backend

Eine in ../shop-backend gestartete Sitzung arbeitet mit ihrer eigenen Kopie der Dateien, ihre Änderungen landen also nicht in anderen Ordnern. Standardmäßig lässt Git denselben Branch nicht in zwei Ordnern gleichzeitig auschecken, deshalb hat jeder Ordner seinen eigenen. Den Branch jedes Ordners führen Sie danach zusammen wie jeden anderen.

Ein Worktree ist eine frische Kopie: Darin fehlen Dateien, die Git ignoriert, zum Beispiel .env, und installierte Abhängigkeiten. Richten Sie sie in jedem Ordner separat ein.

Ein eigener Ordner trennt die Dateien, sagt aber nicht, welche Sitzung was tun soll. Dafür braucht es Pläne.

Eine Sitzung, ein Plan

Halten Sie die Aufgabe für den Agenten als Plan fest: ein kurzes Dokument, das sagt, was zu tun ist, was nicht geändert werden soll und woran man erkennt, dass die Arbeit fertig ist. Einen solchen Ansatz, bei dem die Beschreibung der Arbeit vor dem Code entsteht, nennt man Spec-driven Development. Was in einen Plan gehört, damit der Agent nicht raten muss, beschreibt der Beitrag Wie Sie einen Plan schreiben, den ein KI-Agent ohne Raten liefert.

Eine Sitzung nimmt einen Plan, liefert ihn und meldet, was sie getan hat. Den nächsten Plan bekommt eine neue Sitzung oder dieselbe, nachdem ihr Gesprächsverlauf geleert wurde. Diese Regel bringt drei Dinge:

• Ein fokussierter Agent. Der Agent hat ein Ziel und eine Beschreibung der fertigen Arbeit vor sich, nicht Anweisungen, die sich über den ganzen Tag angesammelt haben. Bei jeder Anfrage geht das ganze bisherige Gespräch an das Modell, und ein Gespräch, das bei einer Aufgabe bleibt, liefert bessere Antworten und kostet weniger.
• Eine klare Abnahme. Eine fertige Arbeit entspricht einem Plan, also prüfen Sie sie an dem, was der Plan angekündigt hat.
• Keine doppelte Arbeit. Jeder Plan hat eine Sitzung, die ihn liefert, also tun zwei Sitzungen nicht dasselbe.

Ein Plan braucht auch Grenzen: Schreiben Sie, welchen Teil des Codes er betrifft. An den Grenzen sieht man, ob zwei Pläne parallel laufen können oder ob einer auf den anderen warten muss.

Abhängigkeiten legen die Reihenfolge fest

Eine Abhängigkeit ist ein Satz: Plan B wartet auf Plan A. Solange A nicht geliefert ist, sollte B nicht starten. Der Agent muss dann nicht raten, ob die Arbeit, die er braucht, schon fertig ist.

An den Abhängigkeiten sieht man auch, wie viel Arbeit parallel laufen kann:

• Pläne, die auf nichts warten, sind bereit zum Start. Jeden davon kann eine andere Sitzung bekommen.
• Pläne, die warten, starten erst, wenn ihre Vorgänger geliefert sind.
• Ein Plan, auf den viele andere warten, ist ein Engpass. Mit ihm lohnt es sich zu beginnen, weil er am meisten Arbeit freigibt.

Wenn Sie die Arbeit aufteilen, achten Sie darauf, dass möglichst viele Pläne auf nichts warten und die Abhängigkeitsketten kurz bleiben. Je mehr Pläne gleichzeitig bereit sind, desto mehr Sitzungen haben etwas zu tun. Eine lange Kette beschleunigen auch mehrere KI-Agenten nicht, weil jedes Glied auf das vorige wartet.

Es lohnt sich, eine Abhängigkeit auch dann festzuhalten, wenn zwei Pläne die Ergebnisse des jeweils anderen nicht brauchen, aber dieselbe Datei ändern. Sonst können ihre Änderungen beim Zusammenführen der Branches kollidieren.

Schritt für Schritt

1. Teilen Sie die Arbeit in Pläne auf. Jeder hat ein Ziel, Grenzen und eine Beschreibung der fertigen Arbeit.
2. Halten Sie bei jedem Plan fest, worauf er wartet. Prüfen Sie, welche Pläne bereit zum Start sind.
3. Legen Sie für jede Sitzung, die Sie starten wollen, einen eigenen Ordner und einen eigenen Branch an.
4. Geben Sie jeder Sitzung einen startklaren Plan.
5. Wenn eine Sitzung ihren Plan abgeschlossen hat, prüfen Sie die Arbeit und führen Sie den Branch zusammen. Sehen Sie nach, welche Pläne freigegeben wurden, und geben Sie sie freien Sitzungen.

Aufgaben von KI-Agenten in featureloom verwalten

featureloom ist ein Board für Pläne, mit dem Sie Claude Code, Codex oder Cursor über einen Remote-MCP-Server verbinden. Einen so verbundenen KI-Assistenten nennt featureloom Konsole. Die Aufgaben von KI-Agenten verwalten Sie darin so wie in den Schritten oben, nur stehen Pläne und Abhängigkeiten auf dem Board und nicht in Terminalfenstern.

• Pläne und Abhängigkeiten. Ein Plan ist ein Dokument auf einem Kanban-Board. Auf dem Bildschirm des Plans klappen Sie „Abhängigkeiten“ auf, klicken auf „Abhängigkeit hinzufügen“, wählen „Wartet auf…“ und suchen den Plan, auf den er warten soll. Eine Abhängigkeit, durch die zwei Pläne aufeinander warten würden, akzeptiert featureloom nicht. Der Bildschirm „Reihenfolge“ zeigt, welche Pläne eines Epics bereit zum Start sind, und der Plan mit der Markierung „Engpass“ gibt die meisten anderen frei.
• Fertige Prompts. Jede neue Organisation hat die Prompts Planer und Umsetzer. Der Planer sagt dem Agenten, dass ein Plan eine Arbeit ist, die eine Agentensitzung vollständig liefert, und lässt ihn die Reihenfolge als Abhängigkeiten festhalten. Der Umsetzer führt den Agenten durch einen Plan, von der Übernahme bis zur Meldung der Lieferung.
• Der nächste startklare Plan. Nach dem Befehl featureloom umsetzer ohne Plannummer fragt der Agent featureloom nach dem nächsten Plan. Er bekommt aus der Spalte für den Status „Backlog“ den nächsten Plan in der Reihenfolge des Boards, der auf nichts wartet und für den niemand anderes verantwortlich ist. Einen wartenden Plan startet keine Konsole: Der Server lehnt ab und nennt die Nummern der Pläne, auf die dieser Plan noch wartet.
• Zwei Sitzungen, derselbe Plan. Zwei Konsolen, die im selben Moment nach dem nächsten Plan fragen, können denselben Plan bekommen, aber starten wird ihn nur eine. Die andere bekommt eine Absage mit dem Namen der Konsole, die ihn liefert, und kann nach dem nächsten fragen.
• Die Arbeit der Vorgänger. Der Befehl mit einer Plannummer, zum Beispiel featureloom umsetzer INV-15, gibt dem Agenten in einem Aufruf den Prompt, den ganzen Plan und die Dokumente der gelieferten Pläne, auf die dieser Plan direkt wartet.
• Wer was tut. Die Karte eines Plans im Status „in Umsetzung“ zeigt die Person, ihre Konsole und eine kurze Beschreibung, die die Konsole selbst angeben kann. Der Umsetzer weist den Agenten an, sie beim Start anzugeben: den Namen der Sitzung oder Computer, Repository und Branch. Gibt der Agent den Branch an und hat jeder Ordner seinen eigenen, sieht man an der Karte sofort, in welchem Ordner gearbeitet wird.

Die Standardverbindung von Claude Code ist eine Konsole für alle Ordner Ihres Systemkontos, deshalb signieren Agenten aus jedem Ordner Pläne mit demselben Namen. Um sie zu unterscheiden, verbinden Sie für jeden Ordner eine eigene Konsole. Öffnen Sie im Menü „Integrationen“, klicken Sie im Abschnitt „Ihre Konsolen“ auf „Konsole verbinden“ und wählen Sie Claude Code. Klicken Sie im Fenster auf „Erweiterte Optionen anzeigen“ und kopieren Sie den Befehl mit „Verbindungsbefehl für den Ordner kopieren“. Fügen Sie ihn in ein gewöhnliches Terminal Ihres Betriebssystems ein, nicht in das Fenster von Claude Code, und zwar in dem Ordner, in dem Sie diese Konsole starten, zum Beispiel in shop-backend. Im Abschnitt „Ihre Konsolen“ geben Sie der neuen Konsole dann einen eigenen Namen, zum Beispiel backend. Starten Sie eine solche Konsole immer in ihrem Ordner: In einem anderen Ordner gestartet, auch in einem Unterordner, sieht sie die Verbindung nicht.

Details finden Sie in den Anleitungen Ihre Konsolen und Epics und Reihenfolge, und die Arbeit des ganzen Teams beschreibt die Seite Team mit mehreren Agenten.