wastech-orchestrator
Transforme une tâche rédigée en pull request soumise à votre revue.
Les agents font les modifications, et l’orchestrateur pilote le scénario et tout le travail Git autour d’eux, de la branche à la pull request. Chaque étape est enregistrée dans une base SQLite locale, et chaque exécution laisse ainsi une trace que vous pouvez suivre ensuite.
Pourquoi ce projet est ici
J’utilise moi-même cet orchestrateur pour développer des fonctionnalités, rédiger des textes et explorer des idées. C’est un exemple de ce que je pourrais mettre en place pour vous et votre équipe, et son code et sa documentation sont publics, vous pouvez donc lire comment il fonctionne avant de décider quoi que ce soit.
Problème
Avant qu’un relecteur puisse suivre la modification d’un agent, plusieurs étapes sont nécessaires autour d’elle. Quand personne n’en est responsable, la pull request d’un agent est difficile à relire et son résultat difficile à reproduire. C’est l’une des raisons pour lesquelles le travail avec les agents piétine, à côté de la qualité du contexte que lit l’agent.
Solution
L’orchestrateur prend en charge le processus et le travail Git, et on ne demande pas aux agents de faire de commit ni de push. Un scénario décrit les étapes, et les tâches sont rédigées en fonction de lui. La pull request s’ouvre une fois que les vérifications que vous avez configurées et la revue par un agent sont passées, avec un résumé écrit de ce qui a changé.
- Une tâche part chez un agent et revient sous forme de pull request une fois passées les vérifications que vous avez configurées pour votre dépôt.
- Les étapes sont écrites sous forme de scénario, et chaque exécution suit celles que vous avez définies.
- Un commit d’audit facultatif place le fichier de la tâche et son résumé à côté du code.
Fonctionnalités clés
- De la tâche à la pull requestUne tâche en Markdown devient une branche, une modification, les vérifications de votre dépôt et une pull request avec un résumé écrit.
- Deux agents, une interfaceOpenAI Codex et Anthropic Claude Code sont interchangeables, et si les deux sont configurés, une exécution bascule sur l’autre en cas de panne d’infrastructure.
- Git reste du côté de l’orchestrateurOn ne demande pas aux agents de faire de commit ni de push. Avec l’isolation stricte activée et un hôte capable de les exécuter dans un bac à sable, ils ne peuvent pas écrire dans .git, et preflight prévient quand cette protection manque.
- Reprise des exécutionsGrâce au point de contrôle enregistré à chaque étape, un redémarrage reprend la tâche en cours sans commit en double ni nouvelle pull request.
Pipeline
- TâcheUn fichier Markdown dans votre dépôtVous
- BrancheCréée à partir de votre branche de baseOrchestrateur
- Étapes du scénarioPlanification et modifications, une étape à la foisAgents IA
- VérificationsVos propres commandes de test et de lint, après chaque modificationOrchestrateur
- RevueLisent la modification et renvoient leurs remarques pour correctionAgents IA
- CommitUn commit limité à la tâche, puis le pushOrchestrateur
- Pull requestOuverte avec un résumé pour votre revueOrchestrateur
Pour qui
- Les personnes et les équipes qui veulent travailler avec des agents IA.
- Les tech leads qui veulent que chaque modification d’un agent passe par une revue et laisse une trace.
Stack technique
- Cœur
- Python 3.12+
- Agents
- OpenAI Codex CLI
- Anthropic Claude Code CLI
- État
- SQLite (état par points de contrôle, tables d’audit)
- Git
- git
- GitHub CLI (gh)
Installation
pipx install "git+https://github.com/VladimirMakarevich/wastech-orchestrator.git"cd path/to/your-repoworc install .worc preflightLimites
- Exécute une seule tâche à la fois, de bout en bout.
- Ouvre des pull requests uniquement sur GitHub, via la CLI gh.
- L’étape de vérification ne bloque une tâche qu’une fois vos commandes de test et de lint listées dans la configuration ; une installation neuve n’en liste aucune.
- Une installation neuve laisse l’isolation stricte désactivée, et un hôte sans bac à sable du système d’exploitation, comme Windows en natif, ne peut pas bloquer l’écriture dans .git.