Steering long sessions

Studiennotizen: Effektive Steuerung von KI-Agenten (Claude)

**I. Grundprinzipien für lange Aufgaben**

• Problem: Lange, komplexe Aufgaben (z. B. Refactoring über Dutzende Dateien) sind für KI-Agenten schwierig.
• Habit 1: Arbeit definieren (Scoping)
• Bevor die KI startet, muss der Umfang klar definiert werden.
• Nutze den „Plan Mode“: KI führt Recherche (read-only) → liefert einen Plan.
• Der Plan muss gründlich geprüft und iterativ mit der KI überarbeitet werden.
• Habit 2: KI steuern (Steering)
• Die KI muss aktiv in die richtige Richtung gelenkt werden.

**II. Kontext- und Fehlerverwaltung**

• Kontext-Management:
• Nutze „Compact Summarizes“, um den Kontext zu komprimieren und unnötige Konversation zu entfernen → Freigabe des Kontextfensters.
• Risiko: Wichtige Informationen können verloren gehen.
• Lösung: Füge dem Compact-Befehl explizite Anweisungen hinzu, was beibehalten werden soll.
• Rückgängig machen (Rewind):
• Jede Benutzeranfrage erstellt einen Checkpoint.
• Öffne das Rewind-Menü (doppelter Escape auf leeren Prompt).
• Optionen:
• Wiederherstellen des Codes oder der Konversation.
• Summarize from here: Fasst alles nach dem Checkpoint zusammen.
• Summarize up to here: Fasst alles vor dem Checkpoint zusammen.

**III. Autonomes Arbeiten (Fortgeschritten)**

• Goal (Ziel):
• Definiert eine Abschlussbedingung (z. B. „Tests bestehen“).
• Die KI arbeitet über mehrere Turns, bis ein Evaluator die Bedingung bestätigt.
• Einschränkung: Der Evaluator liest nur die Transkripte, daher muss die Bedingung aus der KI-Ausgabe ableitbar sein.
• Loop (Schleife):
• Führt einen Prompt in festen oder selbst gesteuerten Intervallen aus.
• Nützlich, um externe Zustände zu prüfen (z. B. CI-Runs, Deployments) und darauf zu reagieren.

**IV. Multi-Agenten-Sicherheit**

• Worktrees:
• Verhindert Konflikte, wenn mehrere KI-Sitzungen gleichzeitig auf denselben Code zugreifen.
• Erstellt unabhängige Dateibäume.
• worktreeinclude: Listet ignorierte Dateien (z. B. lokale Konfiguration) auf, die in jeden Worktree kopiert werden sollen.

**V. Zusammenfassung der Best Practices**

• Arbeitsumfang zuerst definieren (Scope).
• Kontext gezielt komprimieren und steuern.
• Rewind-Menü zur Kontrolle nutzen.
• Bei komplexer Arbeit ein Goal setzen.
• Bei paralleler Arbeit Worktrees verwenden.

Takeaways

• Lange, komplexe Aufgaben müssen durch einen klar definierten Plan (Scoping) gestartet werden.
• Kontext muss mittels „Compact Summarizes“ komprimiert werden, wobei explizite Anweisungen den Informationsverlust verhindern.
• Das Rewind-Menü dient als Checkpoint-Mechanismus zur Wiederherstellung von Code oder Konversation.
• Für autonomes Arbeiten sind die Definition eines klaren Ziels (Goal) oder die Nutzung von Schleifen (Loop) erforderlich.
• Bei paralleler Arbeit ist die Verwendung von Worktrees notwendig, um Konflikte zwischen KI-Sitzungen zu vermeiden.