Archon : ce que le dépôt permet réellement

Périmètre déclaré par le README · coleam00 archon

Archon est un moteur de workflows pour les agents de codage IA. Les processus de développement sont définis comme des workflows YAML : la planification, l'implémentation, la validation, la revue de code et la création de pull requests peuvent chacun être un nœud. Le moteur exécute la même séquence sur tous les projets, et l'IA remplit l'intelligence à chaque étape tandis que la structure reste déterministe et contrôlée par l'utilisateur. La description du dépôt le présente comme le premier constructeur open source de harnais pour le codage IA, avec pour objectif de rendre le codage IA déterministe et répétable. Le README ne définit pas davantage le terme harnais au-delà de cette description de moteur de workflows. Dans coleam00/Archon, la lecture de « Périmètre déclaré par le README » doit rester attachée à Archon, à son README et à ses fichiers nommés. Le dépôt est présenté comme « The first open-source harness builder for AI coding. Make AI coding deterministic and repeatable. ». Cette description indique l intention du projet, mais elle ne prouve ni un niveau de performance, ni une compatibilité universelle, ni un engagement de support. Pour une vérification utile, utilisez l entrée documentée pour Archon, observez la sortie produite, puis relevez le message d erreur et la configuration effectivement chargée. Les éléments absents du README, notamment les valeurs par défaut, les limites de volume et le comportement en cas de panne, doivent rester signalés comme non documentés. Cette méthode permet de distinguer ce que coleam00/Archon annonce de ce que votre environnement confirme.

Objets et flux propres au dépôt · coleam00 archon

Le raisonnement du README part d'un problème concret : demander à un agent IA de corriger un bug peut produire des comportements différents à chaque exécution. L'agent peut sauter la planification, oublier les tests ou ignorer un modèle de PR. Archon répond en transformant le processus en workflow avec des phases, des portes de validation et des artefacts. L'IA décide toujours comment agir dans un nœud, mais l'ordre et les portes sont fixes. Le README liste cinq propriétés : répétable, isolé (chaque exécution obtient son propre worktree git), fire and forget, composable (des nœuds déterministes comme les scripts bash et les tests se mélangent aux nœuds IA) et portable (les workflows vivent dans .archon/workflows/ et s'exécutent depuis la CLI, l'interface web, Slack, Telegram ou GitHub). Dans coleam00/Archon, la lecture de « Objets et flux propres au dépôt » doit rester attachée à Archon, à son README et à ses fichiers nommés. Le dépôt est présenté comme « The first open-source harness builder for AI coding. Make AI coding deterministic and repeatable. ». Cette description indique l intention du projet, mais elle ne prouve ni un niveau de performance, ni une compatibilité universelle, ni un engagement de support. Pour une vérification utile, utilisez l entrée documentée pour Archon, observez la sortie produite, puis relevez le message d erreur et la configuration effectivement chargée. Les éléments absents du README, notamment les valeurs par défaut, les limites de volume et le comportement en cas de panne, doivent rester signalés comme non documentés. Cette méthode permet de distinguer ce que coleam00/Archon annonce de ce que votre environnement confirme.

Installation et première vérification · coleam00 archon

Le README montre un workflow YAML nommé build-feature.yaml. Il contient des nœuds pour la planification, une implémentation en boucle jusqu'à ce que toutes les tâches soient terminées, l'exécution de tests via une commande bash, la revue des modifications, une porte d'approbation interactive et la création d'une pull request. Le nœud de boucle possède un indicateur fresh_context pour que chaque itération démarre avec une nouvelle session ; le nœud d'approbation fait une pause et attend une saisie humaine. L'exemple utilise bun run validate comme commande de test déterministe. C'est la seule commande montrée dans le workflow ; le README ne documente pas quelles validations les autres workflows utilisent. Dans coleam00/Archon, la lecture de « Installation et première vérification » doit rester attachée à Archon, à son README et à ses fichiers nommés. Le dépôt est présenté comme « The first open-source harness builder for AI coding. Make AI coding deterministic and repeatable. ». Cette description indique l intention du projet, mais elle ne prouve ni un niveau de performance, ni une compatibilité universelle, ni un engagement de support. Pour une vérification utile, utilisez l entrée documentée pour Archon, observez la sortie produite, puis relevez le message d erreur et la configuration effectivement chargée. Les éléments absents du README, notamment les valeurs par défaut, les limites de volume et le comportement en cas de panne, doivent rester signalés comme non documentés. Cette méthode permet de distinguer ce que coleam00/Archon annonce de ce que votre environnement confirme.

Configuration et usage concret · coleam00 archon

Deux chemins d'installation sont documentés. La configuration complète nécessite Bun, Claude Code et la CLI GitHub. Elle commence par git clone, cd dans le dépôt, bun install, puis claude, et l'utilisateur dit à Claude Code de configurer Archon. L'assistant de configuration configure les identifiants, les intégrations de plateformes et copie la compétence Archon dans les projets cibles. L'installation rapide est destinée aux utilisateurs qui ont déjà Claude Code : un script curl pour macOS et Linux, un script PowerShell pour Windows et une formule Homebrew. Les binaires d'installation rapide nécessitent une variable d'environnement CLAUDE_BIN_PATH ou un paramètre assistants.claude.claudeBinaryPath dans ~/.archon/config.yaml, car les binaires ne regroupent pas Claude Code. Le README note également que l'installation rapide x64 nécessite la prise en charge d'AVX2 ; les anciens processeurs doivent utiliser le guide d'installation depuis les sources. Dans coleam00/Archon, la lecture de « Configuration et usage concret » doit rester attachée à Archon, à son README et à ses fichiers nommés. Le dépôt est présenté comme « The first open-source harness builder for AI coding. Make AI coding deterministic and repeatable. ». Cette description indique l intention du projet, mais elle ne prouve ni un niveau de performance, ni une compatibilité universelle, ni un engagement de support. Pour une vérification utile, utilisez l entrée documentée pour Archon, observez la sortie produite, puis relevez le message d erreur et la configuration effectivement chargée. Les éléments absents du README, notamment les valeurs par défaut, les limites de volume et le comportement en cas de panne, doivent rester signalés comme non documentés. Cette méthode permet de distinguer ce que coleam00/Archon annonce de ce que votre environnement confirme.

Limites que la documentation laisse ouvertes · coleam00 archon

Le tableau de bord web comprend une page de chat avec streaming en temps réel et visualisation des appels d'outils, un tableau de bord pour surveiller les workflows en cours avec un historique filtrable par projet, statut et date, un constructeur visuel de workflows par glisser-déposer pour créer des workflows DAG avec des nœuds de boucle, et une vue d'exécution de workflow qui montre la progression pas à pas de tout workflow en cours ou terminé. La barre latérale affiche les conversations de toutes les plateformes, pas seulement du web, y compris Slack, Telegram et GitHub. Le README documente des adaptateurs de plateformes optionnels avec leurs temps de configuration : Telegram en 5 minutes, Slack en 15, webhooks GitHub en 15 et Discord en 5. La CLI et l'interface web fonctionnent sans ces adaptateurs. Dans coleam00/Archon, la lecture de « Limites que la documentation laisse ouvertes » doit rester attachée à Archon, à son README et à ses fichiers nommés. Le dépôt est présenté comme « The first open-source harness builder for AI coding. Make AI coding deterministic and repeatable. ». Cette description indique l intention du projet, mais elle ne prouve ni un niveau de performance, ni une compatibilité universelle, ni un engagement de support. Pour une vérification utile, utilisez l entrée documentée pour Archon, observez la sortie produite, puis relevez le message d erreur et la configuration effectivement chargée. Les éléments absents du README, notamment les valeurs par défaut, les limites de volume et le comportement en cas de panne, doivent rester signalés comme non documentés. Cette méthode permet de distinguer ce que coleam00/Archon annonce de ce que votre environnement confirme.

Licence et décision d adoption · coleam00 archon

Archon est livré avec 19 workflows par défaut, listés dans un tableau qui couvre des tâches comme corriger un problème GitHub, créer un problème, revoir une PR, construire une fonctionnalité, générer une PRD, résoudre des conflits de fusion et même générer des compositions vidéo Remotion. Le README indique d'exécuter archon workflow list pour les voir, ou de décrire la tâche et le routeur en choisit un. Les workflows personnalisés sont des fichiers YAML dans .archon/workflows/, et les commandes sont des fichiers markdown dans .archon/commands/. Les fichiers du même nom dans le dépôt de l'utilisateur remplacent les valeurs par défaut fournies, afin qu'une équipe puisse valider le même processus. Dans coleam00/Archon, la lecture de « Licence et décision d adoption » doit rester attachée à Archon, à son README et à ses fichiers nommés. Le dépôt est présenté comme « The first open-source harness builder for AI coding. Make AI coding deterministic and repeatable. ». Cette description indique l intention du projet, mais elle ne prouve ni un niveau de performance, ni une compatibilité universelle, ni un engagement de support. Pour une vérification utile, utilisez l entrée documentée pour Archon, observez la sortie produite, puis relevez le message d erreur et la configuration effectivement chargée. Les éléments absents du README, notamment les valeurs par défaut, les limites de volume et le comportement en cas de panne, doivent rester signalés comme non documentés. Cette méthode permet de distinguer ce que coleam00/Archon annonce de ce que votre environnement confirme.

Conclusion éditoriale

Archon peut convenir à une équipe dont le besoin correspond au périmètre décrit par coleam00/Archon, mais le README ne constitue pas une preuve de performance, de sécurité ou de support durable. Avant adoption, exécutez l entrée documentée de Archon, contrôlez le fichier de configuration propre au projet et comparez la sortie obtenue avec le résultat annoncé. Notez aussi la version testée et les erreurs rencontrées.

Sources officielles

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