human-execution-engine

HEE (Human Execution Engine) est un framework d'exécution doctrine-first open source pour l'orchestration déterministe du travail humain. Il coordonne le raisonnement humain, l'assistance machine et l'automatisation sans ambiguïté, en privilégiant la correction plutôt que le consensus, la structure plutôt que les impressions, et la déterminisme plutôt que la commodité. Le projet s'attaque au problème de la dérive des enregistrements par rapport à la réalité — des affirmations devenant obsolètes ou incorrectes sans que quiconque mente activement. Comme les systèmes d'agents lisent et agissent sur les enregistrements à vitesse machine, les données périmées ou erronées se propagent plus rapidement que les humains ne pourraient les détecter. HEE fournit des mécanismes permettant de détecter intentionnellement les écarts plutôt que par hasard. Concepts de base : - Objets typés : Chaque enregistrement de gouvernance (Card, Pill, Contract, Blueprint, Plan, Registry) est un fichier YAML comportant un type, un bloc de métadonnées et une identité dérivée d'un hachage calculée comme sha256(seed). Ces objets sont validés avec hee lint. - Vérifications : hee check rapproche les affirmations des mesures réelles — vérification des entrées de liste par rapport aux comptes GitHub en direct, validation des signatures GPG détachées par rapport à leurs fichiers source, confirmation que les hachages d'identité se reproduisent à partir des graines, et détection de secrets dans les dépôts publics. - Chaînes de signatures : Les contrats sont ratifiés par des signatures GPG sur le YAML. Le fichier .asc situé à côté du YAML constitue la preuve ; la ligne de statut n'est qu'une affirmation à son sujet. - Thèse vs Duople : Une Thèse est une affirmation à soumettre à un test de résistance. Une Duople est cette même affirmation réduite à une forme vérifiable, étayée par des preuves. Qualifier quelque chose de Thèse constitue un rapport honnête de l'état, pas une rétrogradation. - Séparation de la doctrine : les répertoires blueprints/ et hee/ définissent ce qui doit être vrai. Les répertoires ci/, tooling/ et les scripts l'appliquent mais ne sont jamais une source de vérité. L'interface en ligne de commande hee propose des commandes telles que hee check, hee lint et hee list. Le projet recommande de l'utiliser dans un répertoire temporaire propre, aucune installation n'étant requise. Les répertoires clés comprennent : blueprints/ pour les schémas de doctrine et les contrats de validation, hee/ pour les cartes, pilules, contrats, registres et compétences, mib/ pour le module de vocabulaire HEE-MIB, docs/doctrine/ pour HEE_POLICY, et tooling/bin/ pour les outils hee. HEE définit ce qui doit être vrai, pas comment le rendre vrai. Ce n'est pas un outil de workflow, une bibliothèque de prompts ou un framework d'agents, et il n'a pas d'opinion sur le langage d'implémentation.