wastech-orchestrator
Macht aus einer Aufgabenbeschreibung einen Pull Request für Ihr Review.
Die Änderungen nehmen die Agenten vor, und der Orchestrator steuert den Ablauf und die gesamte Git-Arbeit drumherum, vom Branch bis zum Pull Request. Jeder Schritt wird als Checkpoint in einer lokalen SQLite-Datenbank gespeichert, sodass jeder Lauf eine Spur hinterlässt, die Sie später nachverfolgen können.
Warum es hier ist
Ich nutze diesen Orchestrator selbst, um Features zu entwickeln, Texte zu schreiben und Ideen zu prüfen. Er ist ein Beispiel dafür, was ich für Sie und Ihr Team einrichten könnte. Code und Dokumentation sind öffentlich, sodass Sie nachlesen können, wie er funktioniert, bevor Sie etwas entscheiden.
Problem
Damit jemand im Review der Änderung eines Agenten folgen kann, braucht sie mehrere Schritte drumherum. Wenn niemand für diese Schritte zuständig ist, ist der Pull Request eines Agenten schwer zu prüfen und sein Ergebnis schwer zu wiederholen. Das ist einer der Gründe, warum die Arbeit mit Agenten ins Stocken gerät, neben der Qualität des Kontexts, den der Agent liest.
Lösung
Der Orchestrator übernimmt den Prozess und die Git-Arbeit, und die Agenten werden nicht gebeten zu committen oder zu pushen. Ein Ablauf beschreibt die Schritte, und Aufgaben werden für ihn geschrieben. Der Pull Request wird geöffnet, sobald die von Ihnen konfigurierten Prüfungen und das Review durch einen Agenten bestanden sind, mit einer schriftlichen Zusammenfassung dessen, was sich geändert hat.
- Eine Aufgabe geht an einen Agenten und kommt als Pull Request zurück, sobald die Prüfungen bestanden sind, die Sie für Ihr Repository konfiguriert haben.
- Die Schritte sind als Ablauf festgehalten, sodass jeder Lauf die Stationen durchläuft, die Sie dafür festgelegt haben.
- Ein optionaler Audit-Commit legt die Aufgabendatei und ihre Zusammenfassung neben den Code.
Wichtige Funktionen
- Von der Aufgabe zum Pull RequestAus einer Aufgabe in Markdown werden ein Branch, eine Änderung, die Prüfungen Ihres Repositorys und ein Pull Request mit schriftlicher Zusammenfassung.
- Zwei Agenten, eine SchnittstelleOpenAI Codex und Anthropic Claude Code sind austauschbar, und wenn beide eingerichtet sind, wechselt ein Lauf bei einem Infrastrukturfehler zum anderen.
- Git bleibt beim OrchestratorDie Agenten werden nicht gebeten zu committen oder zu pushen. Mit strikter Isolation und einem Host, der sie in einer Sandbox ausführen kann, können sie nicht in .git schreiben, und preflight warnt, wenn dieser Schutz fehlt.
- Fortsetzbare LäufeJeder Schritt wird als Checkpoint gespeichert, sodass ein Neustart die laufende Aufgabe fortsetzt, ohne doppelt zu committen oder einen Pull Request erneut zu öffnen.
Pipeline
- AufgabeEine Markdown-Datei in Ihrem RepositorySie
- BranchVon Ihrem Basis-Branch abgezweigtOrchestrator
- AblaufschrittePlanung und Änderungen, ein Schritt nach dem anderenKI-Agenten
- PrüfungenIhre eigenen Test- und Lint-Befehle nach jeder ÄnderungOrchestrator
- ReviewLesen die Änderung und schicken Befunde zur Korrektur zurückKI-Agenten
- CommitEin Commit nur für die Aufgabe, dann der PushOrchestrator
- Pull RequestMit einer Zusammenfassung für Ihr Review geöffnetOrchestrator
Für wen
- Menschen und Teams, die mit KI-Agenten arbeiten möchten.
- Tech Leads, die wollen, dass jede Änderung eines Agenten durchs Review geht und eine Spur hinterlässt.
Stack
- Kern
- Python 3.12+
- Agenten
- OpenAI Codex CLI
- Anthropic Claude Code CLI
- Zustand
- SQLite (Checkpoints, Audit-Tabellen)
- Git
- git
- GitHub CLI (gh)
Installation
pipx install "git+https://github.com/VladimirMakarevich/wastech-orchestrator.git"cd path/to/your-repoworc install .worc preflightGrenzen
- Führt eine Aufgabe nach der anderen aus, jeweils von Anfang bis Ende.
- Öffnet Pull Requests nur auf GitHub, über die gh CLI.
- Der Prüfschritt hält eine Aufgabe erst auf, wenn Sie Ihre Test- und Lint-Befehle in der Konfiguration eintragen. Nach einer frischen Installation steht dort keiner.
- Nach einer frischen Installation ist die strikte Isolation aus, und ein Host ohne Sandbox des Betriebssystems, etwa natives Windows, kann Schreibzugriffe auf .git nicht verhindern.