Definition of Ready La Definition of Ready, souvent abrégée DoR, aide une équipe à décider si un sujet est prêt à être travaillé. Elle répond à une question simple : est-ce qu’on en sait assez pour démarrer sans faire semblant ? Dans un contexte avec IA, elle devient encore plus utile. Un agent peut produire très vite à partir d’une demande floue. Le problème, c’est qu’il produira aussi très vite les mauvaises choses. ...
Vérifier qu’une demande est assez claire pour être déléguée - et pour reconnaître un résultat acceptable.
Definition of Done La Definition of Done, souvent abrégée DoD, décrit l’état observable dans lequel un travail peut être considéré comme terminé. Elle ne se contente pas d’énumérer les actions à effectuer. Elle précise les résultats qui doivent être vérifiés à la fin de la mission. Elle dépasse le simple « le code marche sur ma machine ». Un travail terminé doit pouvoir être relu, testé, compris, exploité et repris. ...
ADR Un ADR est un Architecture Decision Record. C’est une trace courte d’une décision d’architecture : le contexte, le choix retenu, et les conséquences connues au moment de décider. Un bon ADR garde la mémoire d’une bifurcation importante sans raconter toute la vie du projet. Dans l’atelier Quand une équipe travaille avec l’IA, les décisions peuvent naître dans une conversation avec un assistant. Sans trace, elles disparaissent vite. L’ADR remet la décision dans la mémoire collective. ...
RACI Le RACI est un outil pour clarifier les responsabilités. Il aide à distinguer qui fait, qui valide, qui est consulté, et qui doit être informé. Dans une équipe, beaucoup de tensions viennent d’un flou très simple : on ne sait pas qui porte vraiment le sujet. Dans l’atelier Avec l’IA, ce flou peut devenir dangereux. Un agent peut produire une spec, une analyse ou du code. Mais l’agent n’assume rien. Quelqu’un doit encore porter la décision, valider le résultat et répondre des conséquences. ...
Contrat de délégation IA Un contrat de délégation IA décrit ce qu’on confie à un assistant ou à un agent. Il précise l’objectif, le contexte, les limites et les preuves attendues. Il peut tenir en quelques lignes. Quand on délègue mal, on récupère souvent un résultat difficile à vérifier. Dans l’atelier Le contrat évite de lancer l’agent avec une consigne vague, puis de découvrir trop tard qu’il a pris des libertés. ...
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. ...