TAKT beschreibt die Zusammenarbeit von KI-Agenten in YAML

Das Problem, von dem TAKT ausgeht

Die README von TAKT beginnt mit „Stop babysitting AI coding agents." Das beschriebene Problem ist, dass KI-Codierungsagenten bei längerer Arbeit Anweisungen vergessen, verschmutzten Kontext ansammeln, Implementierungs- und Überprüfungsverantwortlichkeiten verschwimmen lassen und Menschen dazu zwingen können, dasselbe Feedback zu wiederholen. Das Hinzufügen weiterer Regeln zu Prompts oder CLAUDE.md kann helfen, kann den Prozess aber nicht durchsetzen. TAKT behandelt KI-Agenten als etwas, das von außen kontrolliert werden muss, anstatt ihnen einfach zu vertrauen.

Der Workflow besitzt den Prozess

Die README stellt TAKT einfachen KI-Codierungsagenten gegenüber. Bei TAKT besitzt der YAML-Workflow den Prozess, anstatt dass der Prompt den Agenten auffordert, einem Prozess zu folgen. Überprüfungs- und Korrekturschleifen sind explizite Übergänge, keine Schritte, die vergessen oder übersprungen werden können. Jeder Schritt erhält nur den Kontext, den er benötigt, anstatt eines langen Kontexts, der weiter wächst. Verantwortlichkeiten werden durch Personas, Berechtigungen und Ausgabeverträge getrennt. In die Warteschlange gestellte Aufgaben werden standardmäßig in isolierten Worktrees ausgeführt, und Protokolle und Berichte bewahren den Weg von der Aufgabe zum PR. Workflows sind wiederverwendbar, überprüfbar und versionierbar.

Workflow-Struktur

Ein Workflow wird durch eine Abfolge von Schritten definiert. Das minimale Beispiel zeigt einen Workflow namens plan-implement-review mit initial_step: plan und max_steps: 10. Jeder Schritt spezifiziert eine Persona (wer), Bearbeitungsberechtigung (was erlaubt ist) und Regeln (was als Nächstes passiert). Im Beispiel hat der Plan-Schritt edit: false, der Implement-Schritt edit: true und required_permission_mode: edit, und der Überprüfungsschritt edit: false. Regeln ordnen Bedingungen nächsten Schritten zu: Planung abgeschlossen geht zu implement, Implementierung abgeschlossen geht zu review, Genehmigt geht zu COMPLETE, und Korrektur erforderlich geht zu implement. COMPLETE beendet den Workflow erfolgreich, ABORT beendet mit Fehler. Wiederverwendbare Schrittdefinitionen können in .takt/steps/ gespeichert und vor der Validierung mit uses erweitert werden. Workflow-Dateien leben in workflows/. Wenn derselbe Workflowname an mehreren Orten existiert, ist die Auflösungsreihenfolge .takt/workflows/, dann ~/.takt/workflows/, dann integrierte.

Integrierte Workflows

Die README enthält eine Tabelle integrierter Workflows. Der Standard-Workflow wird als Standard-Entwicklungsworkflow mit Test-First, mehrperspektivischer paralleler Peer-Review (Architektur, KI-Antimuster, Codierung, Semantik, Vertragslebenszyklus, Robustheit), Adjudikation und einer konvergenten Korrekturschleife beschrieben. Die Frontend- und Backend-Workflows sind für Frontend- und Backend-Entwicklung. Der Dual-Workflow kombiniert Frontend und Backend. takt-default ist der Workflow, der zur Entwicklung von TAKT selbst verwendet wird. Die frontend-maintenance- und backend-maintenance-Workflows werden als strenge mehrphasige Überprüfung mit Schleifenmonitoren beschrieben, backend-maintenance mit Dual-Supervisor-Unterzeichnung. Die *-mini-Serie (default-mini, frontend-mini, backend-mini, dual-mini) werden als leichte Varianten beschrieben, die write_tests weglassen.

Befehle

Die README listet wichtige Befehle auf. takt ohne Argumente startet ein Gespräch, um Anforderungen zu verfeinern und Aufgaben auszuführen oder in die Warteschlange zu stellen. takt exec startet den Sofort-Ausführungsmodus mit Assistant-, Worker-, Review- und Replanning-Agenten und Schleifenerkennung. takt add verfeinert eine Aufgabe durch KI-Gespräch und stellt sie in die Warteschlange, auch von GitHub Issues. takt run führt alle ausstehenden Aufgaben aus. takt watch überwacht die Aufgabenwarteschlange und führt ausstehende Aufgaben automatisch aus. takt list verwaltet Aufgabenbranches (Zusammenführen, Wiederholen, Erneut einreihen, Erzwingen von Fehlern, Anweisen, Löschen). takt #N verwendet ein GitHub Issue als Anfangseingabe. takt eject kopiert integrierte Workflows/Facetten zur Anpassung. takt workflow init erstellt ein neues Workflow-Gerüst. takt workflow doctor validiert Workflow-Definitionen. takt repertoire add installiert ein Repertoire-Paket von GitHub. TAKT bietet auch zwei Client-Integrations-Einstiegspunkte: takt-acp führt TAKT als Agent Client Protocol-Agent über stdio JSON-RPC aus, und takt-mcp führt es als stdio MCP-Server aus.

Konfiguration · nrslib takt

Das minimale Konfigurationsbeispiel befindet sich in ~/.takt/config.yaml und setzt provider, model und language. Die README listet Anbieter auf: claude, claude-sdk, claude-terminal, codex, opencode, cursor, copilot, kiro und mock. Drei Anbieter (claude-sdk, codex, opencode) laufen über TypeScript SDK und benötigen nur Node.js. Die anderen Anbieter erfordern externe CLIs wie Claude Code, GitHub Copilot CLI, Cursor Agent und Kiro CLI. API-Schlüssel können über Umgebungsvariablen wie TAKT_ANTHROPIC_API_KEY, TAKT_OPENAI_API_KEY und TAKT_OPENCODE_API_KEY bereitgestellt werden. Die README beschreibt auch die auto_routing-Konfiguration, mit der ein Workflow pro Schritt Anbieter/Modell mit Kandidatenpools und Regeln wählen kann.

Ausführung und Nachverfolgung

In die Warteschlange gestellte Aufgaben werden in isolierten Worktrees ausgeführt. Ausführungsmetadaten, Sitzungen, Ablaufverfolgungen, Berichte und andere Ausführungsartefakte bleiben normale Dateien unter .takt/runs/<run>/. Ein Workflow, der Finding Contract verwendet, erstellt verzögert .takt/runs/<run>/finding-contract.sqlite. Auto-Routing-Entscheidungen werden lokal als NDJSON in .takt/events/ geschrieben, und die README stellt fest, dass TAKT Routing-Entscheidungen nicht hochlädt. Die lokale Aufzeichnung ist standardmäßig aktiviert, kann mit telemetry.routing_decisions konfiguriert und mit takt telemetry status|enable|disable überprüft oder geändert werden.

Installation, Lizenz und Verifizierung

Die README nennt den Installationsbefehl npm install -g takt und auch Nix Flakes: nix run github:nrslib/takt und nix profile install github:nrslib/takt. Das Nix-Paket installiert nur die TAKT-CLI; externe CLI-Anbieter, git und gh/glab müssen separat installiert werden. TAKT erfordert Node.js >=24.15.0. Das Repository ist MIT-lizenziert; der Lizenztext gewährt das Recht, Kopien der Software zu verwenden, zu kopieren, zu modifizieren, zu fusionieren, zu veröffentlichen, zu verteilen, zu unterlizenzieren und zu verkaufen, und stellt fest, dass die Software „wie besehen" ohne jegliche Gewährleistung, einschließlich Marktgängigkeit, Eignung für einen bestimmten Zweck und Nichtverletzung, bereitgestellt wird. Es sagt nichts über Support oder Sicherheitslage aus. Die Repository-Beschreibung lautet „TAKT Agent Koordination Topology - Define how AI agents coordinate, where humans intervene, and what gets recorded , in YAML".

Redaktionelles Fazit

TAKT drückt Agentenkoordination als YAML-Zustandsmaschine aus und verlagert die Prozesssteuerung von Prompts in versionierbare Workflow-Dateien. Es wird mit TAKT selbst entwickelt. Das Repository ist MIT-lizenziert und dokumentiert Tutorial, CLI-Referenz, Konfiguration, Beobachtbarkeit, Designphilosophie, Workflow-Leitfaden, integrierten Katalog, Facetten-Prompting, Token-Einsparung, Repertoire-Pakete, Aufgabenverwaltung, CI/CD-Integration, externe Integrationen und Änderungsprotokoll.

Offizielle Quellen

1. Official README
2. Project repository