Optio : Orchestration d'Agents d'IA de Codage dans Kubernetes du Ticket à la PR

Optio est un système d'orchestration open source pour les agents de codage IA qui gère le flux de travail complet, de la réception des tâches à la fusion des demandes de fusion (pull requests), sans nécessiter une supervision humaine constante. Développé avec Fastify, Next.js, BullMQ et Drizzle sur Postgres, il est livré avec un chart Helm pour le déploiement en production.

Fonctionnement

Le système suit un pipeline en trois étapes :

• Réception – Récupère les tâches depuis GitHub Issues, Linear ou une création manuelle
• Exécution – Lance des pods Kubernetes isolés par dépôt, exécute Claude Code ou Codex dans des arbres de travail git
• Surveillance des demandes de fusion – Surveille les vérifications d'intégration continue, l'état de la revue et la préparation à la fusion toutes les 30 secondes

Le principal différentiateur est la boucle de rétroaction. Lorsque l'intégration continue échoue, Optio transmet l'échec à l'agent. Lorsqu'un réviseur demande des modifications, les commentaires deviennent la prochaine instruction de l'agent. Il continue jusqu'à ce que la demande de fusion soit fusionnée ou que vous l'arrêtiez manuellement.

Architecture et fonctionnalités

Optio utilise une architecture de pod par dépôt avec un pod Kubernetes de longue durée par référentiel. Chaque pod maintient une isolation des arbres de travail git pour plusieurs tâches simultanées. Le système inclut :

• Auto-réparation – Redémarre automatiquement l'agent en cas d'échec d'intégration continue, de conflits de fusion ou de demandes de modifications des réviseurs
• Automatisation de la finalisation – Fusionne la demande de fusion par écrasement et ferme le problème lié lorsque toutes les vérifications sont réussies
• Configuration par dépôt – Sélection du modèle, modèles d'instructions, images de conteneur, limites de concurrence et commandes de configuration ajustables par référentiel
• Agent de revue de code – Lance automatiquement un agent de revue en tant que sous-tâche avec une instruction et un modèle séparés
• Tableau de bord en temps réel – Diffusion en direct des journaux, progression du pipeline, analyse des coûts et surveillance de l'état du cluster

Implémentation technique

L'architecture se compose de trois composants principaux :

• Interface web (Next.js sur le port 3100) avec tableau de bord, gestion des tâches et diffusion en direct
• Serveur API (Fastify) avec des workers pour la file d'attente des tâches, le surveillant de demandes de fusion, la surveillance de l'état et la synchronisation des tickets
• Cluster Kubernetes avec des pods de dépôt contenant plusieurs arbres de travail exécutant des agents IA

Les services incluent la gestion du pool de dépôts, l'exécution des agents de revue et la gestion de l'authentification et des secrets, tous soutenus par Postgres pour les tâches, journaux et événements.