Golden-Thread

Vérifier qu’une demande est assez claire pour être déléguée - et pour reconnaître un résultat acceptable.

Convention Une convention décrit la manière de faire habituellement attendue dans un projet ou une organisation. Elle permet à plusieurs personnes - et à plusieurs agents - de produire un travail cohérent sans devoir rediscuter chaque détail. Une convention peut concerner : la structure du code ; les choix architecturaux ; la stratégie de tests ; les règles de nommage ; l’usage de Git ; la documentation ; la manière de préparer une pull request. Dans un projet assisté par IA, les conventions aident l’agent à distinguer les pratiques réellement attendues des habitudes qu’il pourrait déduire au hasard en parcourant le dépôt. ...

Mandat de délégation Un mandat de délégation décrit la mission confiée à un agent IA, mais aussi le pouvoir qui lui est accordé pour l’accomplir. Une tâche indique généralement ce qui doit être obtenu : corriger un bug, préparer une migration, ajouter une fonctionnalité ou produire une pull request. Le mandat précise également : le périmètre dans lequel l’agent peut intervenir ; les fichiers, outils et environnements auxquels il peut accéder ; les décisions qu’il peut prendre seul ; les limites qu’il ne doit pas franchir ; les situations qui imposent un retour vers l’humain ; les conditions permettant de considérer le travail comme terminé. Exemple Corrige le bug dans le module de facturation. Tu peux modifier le code et les tests de ce module, mais pas le schéma de base de données. Prépare une branche et une pull request. Ne fusionne pas et ne déploie rien. Reviens vers moi si la correction nécessite de modifier le contrat de l’API. ...

Guardrail Un guardrail est un mécanisme qui protège une limite sans dépendre uniquement de la bonne interprétation de l’agent. Une instruction peut demander à un agent de ne jamais déployer en production. Un guardrail réduit ou supprime techniquement sa capacité à le faire. Il peut prendre la forme : d’une permission limitée ; d’une sandbox ; d’un hook ; d’une policy ; d’un test bloquant ; d’un contrôle dans la CI ; d’une validation humaine obligatoire ; de l’absence d’accès à certains secrets ou environnements. Exemple Instruction : « Ne modifie pas les fichiers de migration. » ...

Harness Le harness est le harnais d’exécution qui encadre l’agent : ce qui exécute les outils, collecte les mesures et vérifie que le travail respecte le mandat. Une instruction peut demander à un agent de ne pas pousser en production. Un guardrail peut lui retirer la permission. Le harness, lui, est l’ensemble du cadre dans lequel l’agent tourne : scripts, hooks, policies, tests, validations de sortie, permissions et mécanismes qui ne dépendent pas seulement de la bonne volonté du modèle. ...

Progressive disclosure La progressive disclosure consiste à fournir à un agent les informations utiles lorsqu’elles deviennent nécessaires, plutôt qu’à charger tout le savoir disponible dans son contexte initial. Au fil des incidents, un fichier d’instructions peut accumuler des règles, des exemples, des exceptions et des procédures. Le contexte finit alors par contenir beaucoup d’informations, mais il devient plus difficile d’identifier celles qui comptent vraiment pour la tâche en cours. ...

Le craft, ce n’est pas relire chaque ligne à l’œil — c’est savoir quoi regarder, avec quels instruments, pour accepter ou refuser un changement.

Sans preuve, la revue repose sur l’intuition. Avec des preuves, l’équipe suit le fil : demandé, changé, vérifié.

CRAP combine complexité cyclomatique et couverture pour signaler les zones où un changement agentique mérite plus d’attention.

Quand la quantité de code rend la relecture exhaustive impraticable, le test gauntlet déplace la confiance vers des barrières observables et reproductibles.