Vertiefung & Anhang

Zusammenarbeit mit KI-Agenten

Inhalt

TandemLoop ist von Grund auf dafür gebaut, dass externe KI-Agenten als gleichberechtigte Partner am selben Datensatz arbeiten. Die App selbst enthält keine KI — du bindest ein agentisches KI-Werkzeug deiner Wahl an (siehe Ein KI-Werkzeug anbinden). Der Datenordner enthält kein Black-Box-Format, sondern plain-text Markdown, das jedes Werkzeug lesen kann. Dennoch gilt ein klarer Arbeitsvertrag: Du entscheidest, was mit deiner Struktur passiert.

Das Tandem-Prinzip

Die Metapher des Tandems beschreibt die Zusammenarbeit treffend: Du sitzt vorne und gibst die Richtung vor; der Agent sitzt hinten und liefert Kraft. Keine Seite handelt eigenmächtig. Für die App bedeutet das:

  • Du definierst Vision, Prioritäten, Beziehungen und Entscheidungen.
  • Das KI-Werkzeug hält den Überblick, bereitet vor, erinnert, erkennt Muster und schlägt Aktionen vor.

Das KI-Werkzeug ist dein Partner im Tandem — ein eigenständiges Programm, kein Bestandteil von TandemLoop. Es legt Neues in deinem System an, pflegt Aufgaben, die ihm zugewiesen wurden (assigned_to: ai), und schlägt — wenn du Proposals aktivierst — Änderungen als Proposals vor.

Wie Agenten mit dem Datenordner arbeiten

KI-Agenten lesen den Datenordner wie jedes andere Werkzeug — sie navigieren durch die Ordnerstruktur, lesen YAML-Frontmatter und Markdown-Body. Was sie schreiben dürfen, hängt davon ab, ob du Proposals aktiviert hast:

Proposals aus (Standard) Proposals an
Neues anlegen: Aufgaben, Projekte, Meilensteine, Bereiche, Ordner, Views, Tags direkt, dort, wo es hingehört; ist kein Ort eindeutig, landet eine Aufgabe in der Inbox neue Aufgaben in der Inbox direkt, alles andere als Proposal
Zugewiesene Aufgaben (assigned_to: ai) pflegen: Titel, Body, Status (auch die Rückgabe an dich), Datumsfelder und Erinnerung, Wartet auf, Tags, Delegation, Wiederholung, Werte eigener Attribute direkt direkt
Bestehendes ändern und verschieben: Inbox einsortieren, Felder ergänzen, Projekte umstrukturieren, Views anpassen direkt; an jeder deiner Aufgaben, die er ändert, hinterlässt er einen Eintrag im Verlauf als Proposal, das du in TandemLoop prüfst und genehmigst
Löschen, deine Aufgaben erledigen oder verwerfen, Specs ändern nur auf deinen ausdrücklichen Auftrag; ohne Auftrag beschreibt der Agent den Schritt im Gespräch bzw. stellt dir eine Rückfrage und wartet auf deine Zustimmung als Proposal

Bestehende Tags benennst du selbst in der App um oder löschst sie. Unabhängig von der Einstellung darf ein Agent eigene Attribute und Themes anlegen und auf deine Bitte an jeder offenen Aufgabe eine Erinnerung setzen. Verboten ist in beiden Fällen das direkte Bearbeiten von _archive/, _system/, _conflicts/, der App-Einstellungen in _config/ und des verwalteten Blocks in AGENTS.md.

Bei jedem Durchlauf vermerkt der Agent die Uhrzeit in _config/agent.yaml (last_run). Daraus zeigt TandemLoop unter Zurück vom Agenten › Beim Agenten, wann er zuletzt gearbeitet hat — siehe Autonom & dauerhaft zusammenarbeiten.

Proposals ein- oder ausschalten

Proposals sind optional und standardmäßig ausgeschaltet. Du aktivierst sie jederzeit in den Einstellungen:

Einstellungen › KI-Agenten › Proposals von KI-Agenten aktivieren

Die Einstellung gilt für den ganzen Datenordner. Ist sie aus, blendet TandemLoop alle Proposal-Bereiche aus; bereits vorhandene Proposal-Dateien bleiben unverändert liegen und erscheinen wieder, sobald du Proposals erneut einschaltest.

Proposals — Änderungen, die du genehmigst

Bei aktivierten Proposals gilt: Ein Proposal ist eine Markdown-Datei im Ordner _proposals/. Sie beschreibt eine oder mehrere Aktionen (z. B. „Verschiebe Aufgabe X in Projekt Y”) inklusive Begründung. Du kannst ein Proposal als Ganzes oder Aktion für Aktion genehmigen, ablehnen oder zur Überarbeitung zurückgeben.

Seitenleiste › Proposals (unten) › Proposal öffnen › Genehmigen oder Ablehnen

Mehr zum Proposal-Workflow findest du in Teil 4 des Handbuchs.

Eigene Attribute — auch von Agenten angelegt

Eigene Attribute sind Teil des Datenmodells, das Agenten kennen: AGENTS.md und _system/docs/data-model.md listen alle aktuell definierten Attribute mit Schlüssel, Typ, Gültigkeit, Optionen und Beschreibung auf. Die App aktualisiert diese Liste automatisch, sobald du ein Attribut anlegst, änderst oder löschst — oder ein Agent eine neue Definitionsdatei schreibt.

Ein Agent kann so zum Beispiel auf deine Bitte hin ein Attribut „Kunde” für Aufgaben anlegen und es anschließend befüllen — ohne Proposals direkt, mit Proposals an seinen zugewiesenen und neu angelegten Einträgen direkt, an allen anderen über ein Proposal (Parameter attributes).

Gute Beschreibungen helfen: Die Beschreibung eines Attributs lesen auch die Agenten. Je klarer sie erklärt, wofür das Feld da ist und wie es befüllt wird, desto treffsicherer tragen Agenten Werte ein.

AGENTS.md — die Anleitung für Agenten

Im Wurzelverzeichnis deines Datenordners liegt die Datei AGENTS.md. Sie erklärt jedem KI-Agenten die Spielregeln: erlaubte Aktionen, Schreibregeln, die Verzeichnisstruktur und — bei aktivierten Proposals — das Proposal-Format. Die App hält diese Datei aktuell und schreibt sie beim Ein- oder Ausschalten der Proposals passend neu. Du kannst sie lesen, aber den systemverwalteten Block zwischen den Markierungen TANDEMLOOP:START und TANDEMLOOP:END solltest du nicht von Hand ändern.

Agenten von außen einsetzen: Wenn du Claude Code, ein anderes KI-Werkzeug oder ein Skript auf deinen Datenordner loslässt, weise es zuerst auf AGENTS.md hin. Gut instruierte Agenten halten sich an die dort beschriebenen Regeln — ohne Proposals legen sie Neues an und ändern Bestehendes direkt, löschen aber nur auf deinen Auftrag; mit Proposals legen sie Proposals ab. So behältst du die volle Kontrolle.