touchstone

Touchstone établit une base de référence pour les développeurs individuels dirigeant plusieurs agents IA sur des projets GitHub. Il propose deux composants principaux : des invites de guidance instruisant les agents sur les standards de workflow (branchement en premier, commits à préoccupation unique, résolution obligatoire des problèmes et conformité aux portes), et des outils de push (un CLI appliquant des modèles d'utilisation corrects de GitHub). Le système standardise le flux de développement via une adoption « une fois configuré, jamais modifié », où les dépôts restent corrects sans intervention supplémentaire. Le CLI valide les vérifications déclarées du projet, vérifie les revendications du tracker, applique la politique GitHub et fournit quatre opérations PR limitées (ouverture, statut, fusion, réponse). Il n'effectue explicitement ni staging, ni commit, ni push de code, et ne remplace jamais la décision de fusion de GitHub. Chaque opération inclut des chemins de récupération documentés utilisant git/gh en brut. Touchstone fonctionne selon trois principes : contraindre la livraison sur la branche par défaut via les règles GitHub (rejet des pushes directs/forcés/non revus), rendre l'état lisible grâce aux interfaces natives GitHub (git, PRs, issues), et maintenir des règles cohérentes sur tous les projets et agents. Une règle clé exige que l'application des règles se fasse au niveau capable de les appliquer (GitHub gère les jeux de règles/vérifications requises, tandis que les scripts observent et séquencent uniquement). La porte de fusion implémente un système de verdict exact-head : le workflow de review-gate réussit uniquement pour un verdict propre et fiable lié à la tête actuelle de la PR. L'installation s'effectue via Homebrew (macOS) ou des scripts de publication agnostiques de plateforme. L'adoption implique de déclarer les faits du projet et d'appliquer une politique GitHub auditée via des commandes documentées.