Archon: Entwicklungsprozesse als deterministische YAML-Workflows

Archon als Harness-Builder für KI-Coding

Archon aus dem Repository coleam00/Archon nennt sich den ersten quelloffenen Harness-Builder für KI-Coding und im selben Atemzug eine Workflow-Engine für Coding-Agenten. Der Kern: Entwicklungsprozesse, Planung, Implementierung, Validierung, Code-Review und Pull-Request-Erstellung, werden als YAML-Workflows definiert und lassen sich zuverlässig über alle Projekte hinweg ausführen. Das Projekt vergleicht sich mit Dockerfiles für Infrastruktur und GitHub Actions für CI/CD, oder mit n8n, nur eben für die Softwareentwicklung.

Die Zahlen im Repository zeigen, wie viel Aufmerksamkeit diese Idee findet: 23293 Sterne, 3466 Forks und 281 offene Issues, geschrieben in TypeScript, Lizenz MIT, Standardzweig dev. Die Projektseite liegt unter archon.diy. Eine Besonderheit der Geschichte: Die erste Version von Archon war ein Python-Projekt mit Aufgabenverwaltung und RAG und ist auf dem Zweig archive/v1-task-management-rag vollständig erhalten; das heutige Archon ist ein Neuanfang mit anderem Fokus.

Warum der Prozess kodiert wird statt einem Agenten zu vertrauen

Die Begründung im README beginnt mit einer Alltagsbeobachtung: Bittet man einen KI-Agenten, einen Fehler zu beheben, hängt das Ergebnis vom Lauf ab. Der Agent kann die Planung überspringen, vergessen, Tests zu laufen, oder eine PR-Vorlage ignorieren. Archon begegnet dem, indem der Prozess als Workflow festgeschrieben wird: Phasen, Validierungstore und Artefakte liegen fest, die KI füllt nur die Intelligenz je Schritt aus, während die Struktur deterministisch ist und beim Nutzer bleibt.

Fünf Eigenschaften listet das README dazu auf. Wiederholbar: derselbe Workflow, dieselbe Reihenfolge, jedes Mal. Isoliert: jeder Workflow-Lauf erhält einen eigenen Git-Worktree, fünf Fixes laufen parallel ohne Konflikte. Fire-and-forget: Man startet einen Workflow, arbeitet weiter und kehrt zu einem fertigen Pull Request mit Review-Kommentaren zurück. Zusammensetzbar: deterministische Knoten wie Bash-Skripte, Tests und Git-Operationen mischen sich mit KI-Knoten, die KI läuft nur dort, wo sie Wert schafft. Portabel: Workflows liegen in .archon/workflows/ im Repository und funktionieren gleichermäßig von CLI, Web-Oberfläche, Slack, Telegram oder GitHub aus.

Ein Workflow im Detail: von build-feature.yaml zum Pull Request

Das README zeigt als Beispiel einen Workflow .archon/workflows/build-feature.yaml. Er definiert einen Knoten plan mit dem Prompt, die Codebasis zu erkunden und einen Implementierungsplan zu erstellen. Der Knoten implement hängt davon ab und läuft als Schleife: Read the plan, implement the next task, run validation, wiederholt bis ALL_TASKS_COMPLETE erfüllt ist, mit dem Flag fresh_context: true, sodass jede Iteration mit einer frischen Sitzung beginnt.

Danach kommt run-tests als deterministischer Knoten ohne KI, der mit bun run validate die Tests ausführt, und schließlich review. Die illustrierte Nutzung zeigt, wie sich das anfühlt: Der Nutzer sagt Use archon to add dark mode to the settings page, der Agent wählt den Workflow archon-idea-to-pr, erzeugt einen isolierten Worktree auf dem Zweig archon/task-dark-mode, arbeitet vier Aufgaben ab, läuft nach fehlgeschlagenen Tests zweimal neu an und liefert am Ende einen fertigen Pull Request. Der Agent übernimmt laut README auch Workflow-Auswahl, Zweignamen und Worktree-Isolation; Projekte werden bei der ersten Nutzung automatisch registriert.

Zwei Einrichtungswege: Setup-Assistent und Schnellinstallation

Für den Einstieg beschreibt das README zwei Wege. Die vollständige Einrichtung in rund fünf Minuten braucht Bun, Claude Code und die GitHub-CLI. Danach folgt die Sequenz git clone https://github.com/coleam00/Archon, cd Archon, bun install, dann der Start von claude im Archon-Verzeichnis und die Anweisung Set up Archon. Der Assistent führt durch CLI-Installation, Authentifizierung und Plattformwahl und kopiert die Archon-Skill in die Zielprojekte.

Die Schnellinstallation in etwa 30 Sekunden richtet sich an Nutzer, die Claude Code schon haben: curl -fsSL https://archon.diy/install | bash unter macOS und Linux, irm https://archon.diy/install.ps1 | iex unter Windows oder die Homebrew-Formel brew install coleam00/archon/archon. Drei Einschränkungen nennt das README explizit: Die x64-Variante verlangt AVX2, ältere Intel- und AMD-Hardware sowie VMs mit maskiertem AVX2 müssen auf die Quellinstallation ausweichen, ARM64 ist nicht betroffen. Kompilierte Binärdateien bündeln Claude Code nicht und brauchen eine CLAUDE_BIN_PATH-Variable oder den Schlüssel assistants.claude.claudeBinaryPath in ~/.archon/config.yaml; nur das Docker-Image liefert Claude Code fertig mit. Ein wichtiger Hinweis betrifft den Arbeitsort: Claude Code immer im Ziel-Repository starten, nicht im Archon-Repository.

19 gebündelte Workflows und eigene YAML-Definitionen

Archon bringt laut Dokumentation 19 Standard-Workflows mit, die Aufgaben vom Beheben eines GitHub-Issues über das Erstellen eines Issues, das Review eines Pull Requests und das Bauen eines Features bis zur Erzeugung einer PRD, der Auflösung von Merge-Konflikten und sogar der Generierung von Remotion-Videokompositionen abdecken. Einblick gibt der Befehl archon workflow list, alternativ beschreibt man die Aufgabe, und der Router wählt einen passenden Workflow.

Eigene Prozesse entstehen als YAML-Dateien in .archon/workflows/, eigene Befehle als Markdown in .archon/commands/. Wichtig ist die Überschreibregel: Gleichnamige Dateien im Repository des Nutzers ersetzen die gebündelten Standardwerte. Ein Team kann denselben Prozess also einfach ins Projekt committen, und alle Beteiligten führen denselben Workflow aus, ohne an der Konfiguration von Archon selbst etwas zu ändern.

Web-Dashboard, Architektur und Datenhaltung

Zur Oberfläche gehört ein Web-Dashboard mit einer Chat-Seite, die Antworten in Echtzeit streamt und Tool-Aufrufe visualisiert, einem Überwachungsbereich für laufende Workflows mit filterbarem Verlauf nach Projekt, Status und Datum, einem visuellen Drag-and-Drop-Builder für DAG-Workflows mit Schleifenknoten sowie einer Ausführungsansicht, die den Fortschritt Schritt für Schritt zeigt. Die Seitenleiste fasst Gespräche aller Plattformen zusammen, nicht nur der Weboberfläche, also auch solche aus Slack, Telegram und GitHub.

Architektonisch zeigen die Dokumentation und Diagramme oben Plattform-Adapter, in der Mitte einen Orchestrator für Nachrichtenrouting und Kontextverwaltung und darunter einen Befehlshandler für Slash-Befehle, einen Workflow-Executor für YAML und KI-Assistenten-Clients für Claude, Codex und Pi. Daten landen in SQLite oder PostgreSQL, verteilt auf 14 Kerntabellen für Codebasen, Konversationen, Sitzungen, Workflow-Ausführungen, Isolationsumgebungen, Nachrichten, Workflow-Ereignisse, Nutzer und Einstellungen. Optionale Adapter sind dokumentiert: Telegram in 5 Minuten eingerichtet, Slack in 15, GitHub-Webhooks in 15, Discord in 5. CLI und Web-Oberfläche funktionieren auch ohne diese Adapter.

Telemetrie, Opt-out und die MIT-Lizenz von Archon

Die Telemetrie ist optional und in CI-Umgebungen standardmäßig deaktiviert. Gesendet werden anonyme Ereignisse wie archon_started, workflow_invoked, workflow_completed und chat_turn_handled mit kategorialen Angaben, etwa dem Workflownamen für gebündelte Workflows, wobei eigene Workflows nur als custom erscheinen, dazu Ausführungsergebnis, Knotentypen, Anbieter- und Modell-IDs, Dauer, Tokenzahl und Kosten. Das README listet explizit auf, was nicht gesendet wird: Code, Prompts, Nachrichten, eigene Workflownamen, Git-Remotes, Dateipfade, Nutzernamen, Token, KI-Ausgaben, Fehlertexte, IP-Adressen und geografische Standorte. Wer ganz abschaltet, setzt ARCHON_TELEMETRY_DISABLED, DO_NOT_TRACK oder POSTHOG_API_KEY=off.

Die MIT-Lizenz erlaubt Nutzung, Kopieren, Veränderung, Zusammenführung, Veröffentlichung, Vertrieb und Verkauf der Software, ohne Garantien. Der Versionsstand zeigt kurze Zyklen: v0.9.0 erschien am 17. August 2026, davor v0.8.0 am 6. August und v0.7.1 am 4. August 2026. Der Name CLI-Version im Release-Titel macht zugleich deutlich, dass sich das Projekt gegenwärtig primär über die Kommandozeile bedient.

Redaktionelles Fazit

Archon passt zu Entwicklern, die mit Claude Code arbeiten und deren Abläufe von Planung bis Pull Request wiederholbar bleiben sollen, statt bei jedem Agentenlauf neu ausgehandelt zu werden. Der Einstieg läuft über git clone, bun install und den Setup-Assistenten oder über die Schnellinstallation von archon.diy, bei der x64-Rechner AVX2 brauchen und kompilierte Binärdateien eine CLAUDE_BIN_PATH-Variable setzen müssen. Mit v0.9.0 vom 17. August 2026 ist das Projekt vor 1.0, die Lizenz ist MIT.

Offizielle Quellen

1. Official documentation
2. Official README
3. Project repository
4. Release notes