{"id":3897,"date":"2026-07-22T07:45:00","date_gmt":"2026-07-22T05:45:00","guid":{"rendered":"https:\/\/isla-stud.io\/?p=3897"},"modified":"2026-07-24T14:02:31","modified_gmt":"2026-07-24T12:02:31","slug":"referentiel-git-cerveau-de-mes-agents","status":"publish","type":"post","link":"https:\/\/isla-stud.io\/fr\/ki-b2b\/gehirn-meiner-agenten-git-repo\/","title":{"rendered":"Le cerveau de mes agents est un d\u00e9p\u00f4t Git"},"content":{"rendered":"<p class=\"wp-block-paragraph\"><strong>Ce que tu vas en retirer :<\/strong> Tu d\u00e9couvriras les sept r\u00e8gles et la structure simple de Vault qui me permettent de garantir que les connaissances des agents restent lisibles, g\u00e9r\u00e9es par versions et ind\u00e9pendantes des outils.<\/p>\n\n\n\n<div class=\"wp-block-rank-math-toc-block\" id=\"rank-math-toc\"><h2>Table des mati\u00e8res<\/h2><nav><ul><li><a href=\"#regel-1-markdown-ist-die-quelle-der-wahrheit\">R\u00e8gle n\u00b0 1 : le Markdown est la source de la v\u00e9rit\u00e9<\/a><\/li><li><a href=\"#regel-2-eine-persona-hat-genau-ein-brain\">R\u00e8gle n\u00b0 2 : un persona n'a qu'un seul \u00ab cerveau \u00bb<\/a><\/li><li><a href=\"#regel-3-adapter-bleiben-dunn\">R\u00e8gle n\u00b0 3 : les adaptateurs doivent rester fins<\/a><\/li><li><a href=\"#regel-4-geteiltes-wissen-wird-referenziert\">R\u00e8gle n\u00b0 4 : les connaissances partag\u00e9es font l'objet d'une r\u00e9f\u00e9rence<\/a><\/li><li><a href=\"#regel-5-am-session-ende-wird-geschrieben\">R\u00e8gle n\u00b0 5 : l'\u00e9criture a lieu \u00e0 la fin de la session<\/a><\/li><li><a href=\"#regel-6-approval-gates-sind-explizit\">R\u00e8gle n\u00b0 6 : les \u00e9tapes d'approbation sont explicitement d\u00e9finies<\/a><\/li><li><a href=\"#regel-7-das-brain-ist-kein-secret-store\">R\u00e8gle n\u00b0 7 : le cerveau n'est pas un \u00ab secret store \u00bb<\/a><\/li><li><a href=\"#so-ist-der-vault-aufgebaut\">Voici comment est structur\u00e9 le Vault<\/a><\/li><li><a href=\"#warum-git-und-keine-datenbank\">Pourquoi Git et pas une base de donn\u00e9es ?<\/a><\/li><li><a href=\"#obsidian-ist-die-oberflache-nicht-das-fundament\">Obsidian, c'est l'interface, pas la base<\/a><\/li><li><a href=\"#der-praktische-prufstein\">Le crit\u00e8re pratique<\/a><\/li><\/ul><\/nav><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Pour moi, un agent IA n'a pas besoin d'une m\u00e9moire mystique. Il a besoin de fichiers que je puisse lire, v\u00e9rifier et r\u00e9utiliser.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">C\u2019est pourquoi le \u00ab cerveau \u00bb de mes agents se trouve dans un d\u00e9p\u00f4t Git priv\u00e9. Le Markdown y est la source de v\u00e9rit\u00e9. Git consigne chaque modification. Obsidian est mon interface pratique pour la recherche, les liens et la vue d\u2019ensemble, mais ce n\u2019est pas une condition indispensable pour acc\u00e9der au contenu.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Si Obsidian n'est pas disponible, j'ouvre les fichiers dans un \u00e9diteur de texte. Lorsqu'un outil d'agent est supprim\u00e9, son adaptateur pointe vers le m\u00eame dossier. Lorsqu'un moteur de m\u00e9moire suppl\u00e9mentaire est ajout\u00e9, il peut indexer le contenu existant, mais ne doit pas le remplacer.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Cela semble simple. Pour \u00e9viter que cela ne redevienne au quotidien un tas de documents en d\u00e9sordre, sept r\u00e8gles strictes s'imposent.<\/p>\n\n\n\n<h2 id=\"regel-1-markdown-ist-die-quelle-der-wahrheit\" class=\"wp-block-heading\">R\u00e8gle n\u00b0 1 : le Markdown est la source de la v\u00e9rit\u00e9<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Les personas, les r\u00e8gles de travail et les connaissances s\u00e9lectionn\u00e9es sont disponibles au format Markdown. Une recherche s\u00e9mantique, un index vectoriel ou un moteur de m\u00e9moire peuvent permettre d'en g\u00e9n\u00e9rer une vue plus rapide. Cependant, cette d\u00e9rivation ne constitue jamais la seule source d'information.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Cela permet non seulement d'\u00e9viter la d\u00e9pendance vis-\u00e0-vis d'un outil, mais aussi de rendre les corrections v\u00e9rifiables. Je peux voir dans le diff quelle phrase a \u00e9t\u00e9 modifi\u00e9e, au lieu de me fier \u00e0 un processus de m\u00e9moire invisible qui aurait d\u00e9j\u00e0 enregistr\u00e9 la bonne version.<\/p>\n\n\n\n<h2 id=\"regel-2-eine-persona-hat-genau-ein-brain\" class=\"wp-block-heading\">R\u00e8gle n\u00b0 2 : un persona n'a qu'un seul \u00ab cerveau \u00bb<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Un m\u00eame agent ne doit pas se voir attribuer une version l\u00e9g\u00e8rement diff\u00e9rente de son identit\u00e9 dans chaque outil. Claude, Codex, Gemini et Hermes doivent acc\u00e9der aux m\u00eames fichiers canoniques.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Sinon, on assiste \u00e0 un \u00ab glissement de persona \u00bb : une nouvelle r\u00e8gle de validation s'applique dans un outil, tandis que l'ancien outil continue d'utiliser l'ancienne r\u00e8gle. Ou bien une correction n'appara\u00eet que dans une invite du syst\u00e8me et est perdue lors du prochain changement de compte.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Une source emp\u00eache ces d\u00e9rivations silencieuses.<\/p>\n\n\n\n<h2 id=\"regel-3-adapter-bleiben-dunn\" class=\"wp-block-heading\">R\u00e8gle n\u00b0 3 : les adaptateurs doivent rester fins<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Un \u00ab harness \u00bb est l'outil dans lequel un agent travaille. Pour cela, chaque syst\u00e8me a besoin d'une passerelle adapt\u00e9e : un fichier de configuration, un briefing de projet ou une invite syst\u00e8me.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Ces adaptateurs ne doivent remplir que trois fonctions : trouver le dossier d'agent appropri\u00e9, indiquer l'ordre de lecture et demander la r\u00e9\u00e9criture en m\u00e9moire. La persona, l'expertise et la gouvernance ne sont pas copi\u00e9es dans l'adaptateur.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Plus le pont est fin, plus il est facile de le remplacer.<\/p>\n\n\n\n<h2 id=\"regel-4-geteiltes-wissen-wird-referenziert\" class=\"wp-block-heading\">R\u00e8gle n\u00b0 4 : les connaissances partag\u00e9es font l'objet d'une r\u00e9f\u00e9rence<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Plusieurs agents doivent utiliser la m\u00eame voix de marque, les m\u00eames r\u00e8gles typographiques ou les m\u00eames conventions de s\u00e9curit\u00e9. Ces contenus sont stock\u00e9s dans un espace commun et sont charg\u00e9s \u00e0 partir de l\u00e0.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Je ne les copie pas dans chaque dossier d'agent. Une modification apport\u00e9e \u00e0 la source commune doit s'appliquer \u00e0 tous les r\u00f4les concern\u00e9s. Les copies ne seraient plus synchronis\u00e9es d\u00e8s la premi\u00e8re modification.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Cette r\u00e8gle n'a rien d'exceptionnel. C'est justement pour cela qu'elle est importante. L'infrastructure n'a rien de tr\u00e8s attrayant. Mais elle dure plus longtemps que les fonctionnalit\u00e9s.<\/p>\n\n\n\n<h2 id=\"regel-5-am-session-ende-wird-geschrieben\" class=\"wp-block-heading\">R\u00e8gle n\u00b0 5 : l'\u00e9criture a lieu \u00e0 la fin de la session<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Un syst\u00e8me de fichiers ne conserve en m\u00e9moire que ce qui se trouve effectivement dans les fichiers. C'est pourquoi une entr\u00e9e dans la m\u00e9moire journali\u00e8re est n\u00e9cessaire \u00e0 la fin d'une session d'agent.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Ce document ne contient pas l'int\u00e9gralit\u00e9 de la conversation. Il consigne les d\u00e9cisions prises, les \u00e9tapes franchies, les constatations importantes et les points en suspens. Par la suite, les connaissances acquises au quotidien sont transform\u00e9es en connaissances \u00e0 long terme tri\u00e9es et s\u00e9lectionn\u00e9es ou en une le\u00e7on durable.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Sans cette routine, le r\u00e9f\u00e9rentiel ne serait qu'un simple recueil statique d'invites.<\/p>\n\n\n\n<h2 id=\"regel-6-approval-gates-sind-explizit\" class=\"wp-block-heading\">R\u00e8gle n\u00b0 6 : les \u00e9tapes d'approbation sont explicitement d\u00e9finies<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Chaque agent productif d\u00e9finit ce qu'il est autoris\u00e9 \u00e0 faire lui-m\u00eame et les cas o\u00f9 une personne doit prendre une d\u00e9cision. Dans le cas de Sol, par exemple : elle est autoris\u00e9e \u00e0 cr\u00e9er des brouillons, mais ne peut rien publier. Un autre agent est autoris\u00e9 \u00e0 modifier le code, mais ne peut pas d\u00e9clencher de d\u00e9ploiement en production sans validation.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Ces limites sont d\u00e9finies au niveau de l'agent, et pas seulement dans une interface. Elles sont donc conserv\u00e9es lors du changement d'outil.<\/p>\n\n\n\n<h2 id=\"regel-7-das-brain-ist-kein-secret-store\" class=\"wp-block-heading\">R\u00e8gle n\u00b0 7 : le cerveau n'est pas un \u00ab secret store \u00bb<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Un r\u00e9f\u00e9rentiel priv\u00e9 n'est pas forc\u00e9ment l'endroit id\u00e9al pour tous les types de contenu. Les secrets en clair n'ont jamais leur place l\u00e0-bas. Les personas li\u00e9s aux clients et les contenus de travail confidentiels restent dans leur contexte de projet prot\u00e9g\u00e9 respectif.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Le \u00ab cerveau \u00bb central ne contient que ce qui doit r\u00e9ellement s'y trouver, tous agents confondus. Cette limite fait partie int\u00e9grante de l'architecture ; il ne s'agit pas d'un travail de nettoyage a posteriori.<\/p>\n\n\n\n<h2 id=\"so-ist-der-vault-aufgebaut\" class=\"wp-block-heading\">Voici comment est structur\u00e9 le Vault<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">La structure concr\u00e8te est d\u00e9lib\u00e9r\u00e9ment pr\u00e9visible :<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>On commence par d\u00e9finir les sp\u00e9cifications et les aper\u00e7us destin\u00e9s aux personnes et aux agents.<\/li>\n\n\n<li>Un espace commun regroupe les \u00ab Brand Voices \u00bb, les conventions et les enseignements tir\u00e9s de l'exp\u00e9rience de tous les agents.<\/li>\n\n\n<li>Les mod\u00e8les permettent de s'assurer que les nouveaux agents re\u00e7oivent les m\u00eames \u00e9l\u00e9ments de base.<\/li>\n\n\n<li>Les adaptateurs de harnais font le lien avec les diff\u00e9rents outils.<\/li>\n\n\n<li>Chaque agent dispose de son propre dossier contenant son profil, ses comp\u00e9tences manuelles, ses aptitudes, ses limites et sa m\u00e9moire.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Cet ordre est plus important que le nom exact du dossier. Un nouvel agent doit pouvoir comprendre o\u00f9 il a le droit de lire et d'\u00e9crire sans avoir \u00e0 conna\u00eetre au pr\u00e9alable l'historique complet du projet.<\/p>\n\n\n\n<h2 id=\"warum-git-und-keine-datenbank\" class=\"wp-block-heading\">Pourquoi Git et pas une base de donn\u00e9es ?<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Une base de donn\u00e9es permettrait de r\u00e9pondre plus rapidement aux requ\u00eates. Cependant, en ce qui concerne l'identit\u00e9 canonique de mes agents, Git pr\u00e9sente trois avantages qui me semblent plus importants.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Lisibilit\u00e9 :<\/strong> Les fichiers Markdown peuvent \u00eatre ouverts sans logiciel sp\u00e9cifique.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Tra\u00e7abilit\u00e9 :<\/strong> Un diff montre ce qui a chang\u00e9. Un commit associe la modification, la date et la justification.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Portabilit\u00e9 :<\/strong> Un dossier clon\u00e9 peut \u00eatre r\u00e9utilis\u00e9 sur un autre ordinateur et avec un autre outil.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Cela ne signifie pas pour autant que les bases de donn\u00e9es ou la recherche vectorielle soient inutiles. Dans ma configuration, elles peuvent \u00eatre int\u00e9gr\u00e9es en tant qu'index ou cache. Elles servent \u00e0 acc\u00e9l\u00e9rer le processus, mais ne sont pas les d\u00e9tentrices du savoir.<\/p>\n\n\n\n<h2 id=\"obsidian-ist-die-oberflache-nicht-das-fundament\" class=\"wp-block-heading\">Obsidian, c'est l'interface, pas la base<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">J'utilise la racine du r\u00e9f\u00e9rentiel comme coffre-fort Obsidian. Cela me permet d'avoir acc\u00e8s \u00e0 des liens wiki, \u00e0 Graph, \u00e0 la fonction de recherche et \u00e0 des pages r\u00e9capitulatives organis\u00e9es. Pour moi, en tant qu'utilisateur, c'est tr\u00e8s utile.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Mais le point important, c'est que : Obsidian enregistre les notes sous forme de fichiers locaux. L'interface peut \u00e9voluer sans qu'il soit n\u00e9cessaire de r\u00e9\u00e9crire le code source.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">C'est pr\u00e9cis\u00e9ment cette distinction que j'aimerais voir s'appliquer \u00e9galement du c\u00f4t\u00e9 des agents. Un bon outil a pour but de rendre le travail plus agr\u00e9able. Il ne devrait pas d\u00e9terminer si mes connaissances restent lisibles.<\/p>\n\n\n\n<h2 id=\"der-praktische-prufstein\" class=\"wp-block-heading\">Le crit\u00e8re pratique<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Un \u00ab Agents Brain \u00bb n'est portable que si tu peux r\u00e9pondre \u00ab oui \u00bb \u00e0 ces trois questions :<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Peux-tu consulter la persona sans l'outil utilis\u00e9 jusqu'\u00e0 pr\u00e9sent ?<\/li>\n\n\n<li>Un autre outil peut-il charger ces m\u00eames r\u00e8gles sans que tu aies \u00e0 les copier ?<\/li>\n\n\n<li>Peut-on voir ce qu'un agent a enregistr\u00e9 de mani\u00e8re permanente \u00e0 la fin de la session ?<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">Si la r\u00e9ponse est \u00ab non \u00bb, cela signifie qu'\u00e0 ce stade, les connaissances se trouvent encore dans l'outil plut\u00f4t que dans le cerveau.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Dans la partie suivante, je d\u00e9compose un agent individuel en ses quatre fichiers principaux : SOUL, MASTER, RULES et MEMORY. Leur s\u00e9paration permet de transformer une longue invite en une identit\u00e9 de travail plus facile \u00e0 g\u00e9rer.<\/p>\n\n\n\n<h3 id=\"quellen\" class=\"wp-block-heading\">Sources<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Source du projet :<\/strong> Sp\u00e9cification d'agents-brain, structure de Vault et validateurs, version du 15 juillet 2026 (source primaire priv\u00e9e)<\/li>\n\n\n<li><a href=\"https:\/\/spec.commonmark.org\/0.31.2\/\" target=\"_blank\" rel=\"noopener\">CommonMark : sp\u00e9cification Markdown ouverte<\/a><\/li>\n\n\n<li><a href=\"https:\/\/git-scm.com\/book\/en\/v2\/Getting-Started-What-is-Git%3F\" target=\"_blank\" rel=\"noopener\">Pro Git : Qu'est-ce que Git ?<\/a><\/li>\n\n\n<li><a href=\"https:\/\/help.obsidian.md\/Files-and-folders\/How-Obsidian-stores-data\" target=\"_blank\" rel=\"noopener\">Aide Obsidian : Comment Obsidian stocke les donn\u00e9es<\/a><\/li>\n<\/ul>\n\n\n\n<div class=\"wp-block-group agents-brain-series-nav is-layout-flow wp-block-group-is-layout-flow\"><p><strong>S\u00e9rie Agents Brain<\/strong><\/p><p><a href=\"https:\/\/isla-stud.io\/fr\/ki-b2b\/openclaw-a-ete-supprime-ce-quil-restait-de-lequipe-ki\/\">\u2190 Partie 1 : J'ai mis fin \u00e0 OpenClaw. Ce qu'il reste de mon \u00e9quipe d'IA.<\/a><br><a href=\"https:\/\/isla-stud.io\/fr\/ki-b2b\/lagent-se-compose-de-quatre-fichiers\/\">Partie 3 : Chez moi, un agent se compose de quatre fichiers \u2192<\/a><\/p><\/div>","protected":false},"excerpt":{"rendered":"<p>Sept \u00ab r\u00e8gles d'or \u00bb transforment les fichiers Markdown en un \u00ab cerveau d'agent \u00bb portable \u2013 avec un historique Git, des limites claires et des adaptateurs d'outils l\u00e9gers.<\/p>","protected":false},"author":1,"featured_media":3931,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_et_pb_use_builder":"","_et_pb_old_content":"","_et_gb_content_width":"","footnotes":""},"categories":[754,13],"tags":[769,771,770,772],"dipi_cpt_category":[],"class_list":["post-3897","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-ki-b2b","category-ratgeber","tag-agents-brain","tag-context-engineering","tag-ki-agenten","tag-multi-agenten-systeme"],"acf":[],"_links":{"self":[{"href":"https:\/\/isla-stud.io\/fr\/wp-json\/wp\/v2\/posts\/3897","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/isla-stud.io\/fr\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/isla-stud.io\/fr\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/isla-stud.io\/fr\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/isla-stud.io\/fr\/wp-json\/wp\/v2\/comments?post=3897"}],"version-history":[{"count":4,"href":"https:\/\/isla-stud.io\/fr\/wp-json\/wp\/v2\/posts\/3897\/revisions"}],"predecessor-version":[{"id":3983,"href":"https:\/\/isla-stud.io\/fr\/wp-json\/wp\/v2\/posts\/3897\/revisions\/3983"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/isla-stud.io\/fr\/wp-json\/wp\/v2\/media\/3931"}],"wp:attachment":[{"href":"https:\/\/isla-stud.io\/fr\/wp-json\/wp\/v2\/media?parent=3897"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/isla-stud.io\/fr\/wp-json\/wp\/v2\/categories?post=3897"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/isla-stud.io\/fr\/wp-json\/wp\/v2\/tags?post=3897"},{"taxonomy":"dipi_cpt_category","embeddable":true,"href":"https:\/\/isla-stud.io\/fr\/wp-json\/wp\/v2\/dipi_cpt_category?post=3897"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}