Telegram-Coding-Assistenten: So steuern Sie den Agenten richtig

Sie haben Teil 2 abgeschlossen und verfügen nun über einen Telegram-Bot, der auf Ihre Nachrichten reagiert und einen Coding-Assistenten in einem tmux-Panel steuert. Doch bevor Sie loslegen, sollten Sie den Betriebsvertrag verstehen: eine klare Anleitung, welche Befehle der Bot versteht, welche Fallstricke lauern und was Sie unter keinen Umständen eingeben dürfen. Dieser Vertrag ist keine Anleitung zum Nachbauen, sondern eine Checkliste, die Ihnen hilft, den Assistenten sicher und effizient zu nutzen.

Stellen Sie sich den Prozess wie eine Kurznachricht vor, die durch einen Relais-Agenten an einen Coding-Agenten in einem tmux-Panel weitergeleitet wird. Der Relais-Agent fungiert dabei als Briefträger: Die meisten Ihrer Befehle werden direkt an das Panel weitergegeben, während nur wenige Schlüsselwörter vom Relais selbst verarbeitet werden. Dieses Prinzip ist entscheidend, um Missverständnisse zu vermeiden.

Die Befehle, die der Relais-Agent direkt verarbeitet

Diese Schlüsselwörter sind lokale Steuerbefehle, die der Relais-Agent unabhängig vom Coding-Agenten ausführt. Die genaue Formulierung dieser Befehle können Sie in der Datei AGENTS.md anpassen, die Sie in Teil 2 erstellt haben. Hier sind die wichtigsten Standardbefehle:

• status oder was macht der Agent? – Der Relais-Agent erfasst den aktuellen Zustand des Panels, entfernt Terminal-Formatierungen und gibt eine Zusammenfassung der Aktivitäten des Coding-Assistenten aus.
• send – Der Relais-Agent sendet eine leere Zeile in das Panel, um eine neue Eingabeaufforderung zu erzwingen.
• compact oder neue Session – Der Relais-Agent sendet den Befehl zur Komprimierung der Konversation oder zum Start einer neuen Session an den Coding-Agenten.
• interrupt oder stop – Der Relais-Agent unterbricht die aktuelle Aktion des Coding-Assistenten (nach Bestätigung).
• restart – Der Relais-Agent beendet den Coding-Assistenten sauber und startet ihn neu, wobei die aktuelle Session erhalten bleibt.

Der Befehl status ist besonders wichtig, solange Sie noch keine automatischen Statusmeldungen in Teil 4 implementiert haben. Bis dahin müssen Sie manuell nachfragen, um den Fortschritt des Assistenten zu überprüfen. Achten Sie jedoch darauf, dass status nur den aktuellen Zustand des Panels anzeigt – nicht die tatsächlichen Ergebnisse. Wenn der Assistent beispielsweise behauptet, Tests seien erfolgreich verlaufen, sollten Sie dies nicht blind vertrauen, sondern selbst überprüfen (siehe Teil 5).

Wann welcher Befehl? Nutzen Sie interrupt, wenn der Assistent falsche Schritte unternimmt oder eine unsichere Aktion ausführen könnte – Sie stoppen damit nur die aktuelle Aktion. Verwenden Sie restart nur, wenn das Panel oder die Session blockiert ist; der Assistent behält dabei seinen Kontext. Der Befehl compact eignet sich, um lange Konversationen zu straffen, während neue Session für völlig neue Aufgaben sinnvoll ist.

Alles andere wird an den Coding-Agenten weitergeleitet

Jeder Befehl, der nicht zu den oben genannten Steuerworten gehört, wird wortwörtlich in das tmux-Panel übertragen und vom Coding-Agenten verarbeitet. Ein Satz wie „Füge einen Retry-Mechanismus zur Upload-Client-Klasse hinzu und führe die Tests aus“ ist keine Anweisung für den Relais-Agenten, sondern ein Auftrag für den Coding-Assistenten. Diese Weiterleitung ist der Standardfall und macht den Großteil Ihrer Interaktionen aus.

Formulieren Sie Ihre ersten Nachrichten wie einen gut strukturierten Ticket-Eintrag: Nennen Sie das Repository und den Branch, beschreiben Sie die gewünschte Änderung, die Testanforderungen und etwaige Einschränkungen. Präzise Prompts führen zu besseren Ergebnissen als ausschweifende Erklärungen.

Falls Sie eines der Steuerwörter wörtlich an den Coding-Agenten senden möchten – etwa den Text status – nutzen Sie den Befehl send status. Dadurch wird der Text direkt in das Panel übertragen, ohne dass der Relais-Agent ihn als Steuerbefehl interpretiert.

Die größte Stolperstelle: Antworten auf Agentenfragen

Dieses Missverständnis führt am ersten Tag am häufigsten zu Fehlern – merken Sie es sich gut:

Wenn der Coding-Agent im Panel eine Frage stellt (z. B. Option A / Option B oder Fortfahren?) und auf eine Antwort wartet, ist Ihre Eingabe kein Steuerbefehl für den Relais-Agenten, sondern eine direkte Antwort an den Coding-Agenten. Der Relais-Agent leitet Ihre Antwort unverändert an den Coding-Agenten weiter.

Typische Eingaben wie:

• A, B, ja, nein, mach es, Option B

werden nicht vom Relais-Agenten verarbeitet, sondern direkt an den Coding-Agenten gesendet. Das ist auch gewollt: Sie antworten damit auf die Frage des Assistenten, nicht auf den Relais-Agenten.

Die Gefahr besteht darin, dass eine einfache Eingabe wie A fälschlicherweise als Steuerbefehl für den Relais-Agenten interpretiert werden könnte. Ohne diese Regel würde der Relais-Agent versuchen, „Option A“ als eigenen Befehl auszuführen – was zu unerwartetem Verhalten führt.

Möchten Sie ausnahmsweise den Relais-Agenten steuern, statt auf den Coding-Agenten zu antworten, müssen Sie dies explizit formulieren: „Du wählst Option A“ oder „Gib das nicht an den Agenten weiter, sondern zeige mir X“.

In Teil 4 wird diese Logik durch einen deterministischen Router automatisiert, sodass keine Unsicherheit mehr besteht. Bis dahin gilt: Denken Sie daran, wem Sie gerade antworten.

Verstehen Sie, mit welchem Agenten Sie kommunizieren

Nicht alle Agenten haben dieselben Rechte oder Aufgaben. Besonders wichtig ist der Unterschied zwischen einem Relais-Agenten und einem Ops-Agenten:

• Ein Relais-Agent ist fest mit einem tmux-Panel verknüpft. Er kann nur den darin befindlichen Coding-Agenten steuern, den aktuellen Zustand abfragen oder einen Neustart auslösen. Wichtig: Der Relais-Agent ist keine Sicherheitsbarriere. Der Coding-Agent im Panel kann weiterhin alle Aktionen ausführen, für die er lokale Berechtigungen besitzt. Der Relais-Agent beschränkt nur seine eigenen Befugnisse.

• Ein Ops-Agent hingegen ist nicht an ein Panel gebunden. Er kann Befehle systemweit ausführen, einschließlich sensibler Aufgaben wie das Aktualisieren von Anmeldedaten. Diese Agenten sind deutlich mächtiger und erfordern daher mehr Vorsicht.

In der aktuellen Konfiguration arbeiten Sie mit genau einem Relais-Agenten und einem Panel. Dennoch sollten Sie sich angewöhnen, stets zu prüfen: In welchem Thema bin ich gerade aktiv? Denn das bestimmt, welche Befugnisse der Agent hat – eine Gewohnheit, die Sie sich aneignen sollten, bevor Sie weitere Themen wie Ops-Agenten hinzufügen.

Was Sie niemals eingeben sollten

Sie kommunizieren über Telegram mit einer Shell-Umgebung. Der Relais-Agent bietet zwar erste Schutzmechanismen (die Sie in AGENTS.md definiert haben), doch Sie sind die erste und wichtigste Sicherheitsinstanz. Beachten Sie daher folgende Regeln unbedingt:

• Keine Änderungen an Produktiv- oder Staging-Systemen. Vermeiden Sie Befehle, die Daten löschen, bearbeiten, skalieren oder neu starten. Beschränken Sie sich auf Inspektionen und Debugging.

• Keine Commits oder Merges in geteilte Branches. Feature- oder Bugfix-Branches sind in Ordnung, doch für Branches wie main, dev oder GitOps-Branches gilt: Nur Menschen dürfen dort mergen. Ein Merge in einen GitOps-Branch ist ein Deployment.

• Gemeinschaftlich genutzte Infrastruktur erfordert menschliche Freigabe. Gateways, API-Gateways und Systeme, die von anderen Teams genutzt werden, dürfen nicht ohne explizite Zustimmung verändert werden.

• Keine Geheimnisse in die Konversation einfügen. Selbst wenn der Relais-Agent keine Befehle ausführt, die Geheimnisse preisgeben, sollten Sie sensible Daten niemals in die Chat-Nachricht einfügen.

Diese Regeln mögen streng wirken, doch sie sind der Grundstein für einen sicheren und zuverlässigen Betrieb. Denken Sie daran: Der Relais-Agent ist ein Werkzeug – und wie jedes Werkzeug ist seine Sicherheit nur so stark wie die Person, die es bedient. Halten Sie sich an den Vertrag, und Sie werden Ihren Coding-Assistenten effizient und sicher steuern können.