À propos du projet

Repo Agent Orchestration est une Skill Codex communautaire non officielle (sous licence MIT) qui maintient les conventions de livraison de dépôts multi-agents à l'intérieur du dépôt lui-même plutôt que dans un service central. Son objectif déclaré est de finaliser le travail sur le dépôt à travers des contextes appropriés avec une propriété claire, une vérification proportionnelle et un transfert récupérable. Le projet note explicitement qu'il n'accorde aucune permission, ne débloque aucune capacité de produit et ne reproduit aucun système d'orchestration propriétaire. La documentation définit trois modes de propriété — direct, delivery et architected — comme des descriptions de qui détient les décisions plutôt que comme un nombre fixe de conversations. Les directives couvrent la délégation de travaux séparables, la poursuite des travaux prêts pour les dépendances au lieu de sonder un statut inchangé, le maintien de l'indépendance entre les jugements de mise en œuvre et de revue, et la vérification de l'identité Git réelle et des chemins exclusifs. Les rédacteurs internes sont décrits comme partageant l'arbre de leur propriétaire avec des portées disjointes, tandis que les rédacteurs App s'exécutant indépendamment utilisent des worktrees locaux au dépôt enregistrés séparément. Une revue de conception indépendante est requise par des exigences explicites de l'utilisateur ou du dépôt, ou pour un risque matériel transversal ou irréversible. L'installation s'effectue à partir du checkout source avec scripts/install_repository.py pointé vers un chemin de dépôt. Elle copie la Skill dans .agents/skills/repo-agent-orchestration et met à jour de manière idempotente un bloc marqué dans le fichier AGENTS.md à la racine du dépôt, préservant les règles en dehors de ce bloc. Un flag --dry-run permet de prévisualiser les écritures, et --check détecte les dérives de fichiers installés ou de profil sans modifier la cible. L'installateur accepte des options couvrant la branche principale, la racine du worktree, le préfixe de branche, la politique de worktree racine, la politique d'hôte de tâche, la politique de modèle de contrôleur, les paramètres de modèle par rôle, les chemins d'intégration partagés, la politique de continuité et les portes externes. Les valeurs par défaut du modèle sont app_default, qui omet les substitutions de modèle et de réflexion ; les mises à jour préservent les liaisons explicites existantes, sauf pour une valeur par défaut de l'installateur retirée qui migre vers app_default. Un adaptateur structuré optionnel prend en charge les tâches App explicitement demandées lorsque l'hôte supporte une route locale de projet sauvegardé (saved-project). Son constructeur et son validateur gèrent huit types de paquets — binding, write, review, update, design_handoff, delivery_update, design_reopen et design_decision — partageant un schéma. La documentation stipule que l'adaptateur vérifie le confinement du chemin, l'identité du projet sauvegardé, la branche et le commit Git actuels, la revue en lecture seule et les paramètres de rapport préservés, mais ne prouve pas l'autorisation de la tâche, la livraison réelle, la qualité de la revue ou l'acceptation, et que le champ DELIVERY d'un rapport est une route prévue plutôt qu'un reçu. La validation repose sur la découverte unittest de la bibliothèque standard Python, un validateur d'exemple et une démo locale, avec une CI ciblant Python 3.11 et 3.13 ; Git est requis pour les tests de l'installateur et du worktree. La démo crée un dépôt Git temporaire et des arbres de rédacteurs isolés et prouve uniquement les vérifications Git locales et contractuelles, et non la création d'App, la livraison de messages, les modèles effectifs ou le comportement réel des agents. Des cas comportementaux sont fournis pour des exercices que les assertions de chaînes ne peuvent prouver. Les directives de nettoyage exigent une décision explicite pour chaque worktree et branche possédés, ne supprimant que les résidus validés comme propres, intégrés ou explicitement abandonnés via le flux de worktree de Git, et conservant les résidus dangereux ou utiles avec des coordonnées exactes ; aucun nettoyage basé sur l'âge, aucune suppression forcée de travail récupérable, aucune suppression de branche distante, aucun démon d'arrière-plan ni aucune escalade automatique de permissions n'est inclus. La structure sépare la Skill installable, l'installateur, le validateur d'exemple, la démo locale, les entrées comportementales, un runbook de bureau optionnel et des tests déterministes.