Agents
Cette page est générée depuis docs/guide.fr.md · Modifier cette page sur GitLab
Un agent est un profil de session : ce qu'on met autour d'un lancement de l'IA — un rôle, un périmètre de dépôts, des outils, des skills, des sous-agents, une sortie, parfois un horaire. Mergerie ne réinvente pas d'orchestrateur : l'intelligence reste dans le CLI. Un run d'agent est une session ordinaire — mêmes suivis, mêmes questions, mêmes passes archivées, même file de jobs, même coût.
Une session lancée dans un clone a déjà beaucoup : le code, le CLAUDE.md du dépôt, ses skills. Ce qu'elle n'a pas, Mergerie l'a : les vingt autres clones, ce qui vient d'être mergé, et une connaissance transverse qu'aucun dépôt ne porte parce qu'elle est entre les dépôts.
Trois règles, jamais négociables. Un agent ne pousse jamais et ne publie jamais de lui-même : l'auto-push est forcé à zéro sur toute session portée par un agent. Un agent ne devine jamais un dépôt : il lui est donné, ou il le trouve avec une preuve et le dit. Un agent ne traite pas les échanges entre humains.
Les deux exemples livrés
- Enquêteur d'incident — on lui colle une trace, un log, un extrait de ticket. Il la cherche dans tous les clones avec un sous-agent
chercheurpar dépôt, puis nomme le dépôt, le fichier et la ligne, avec une hypothèse de cause et les commits récents qui ont touché ces lignes. S'il ne trouve rien, il le dit en toutes lettres au lieu de proposer un dépôt plausible. Les sous-agents n'existent que chez Claude Code (--agents) : sur un autre backend, la demande ne les nomme pas et l'agent cherche lui-même. Son rapport se termine par un bloc de service qui alimente le bouton « Corriger sur dépôt » : un clic ouvre une session de codage sur le bon dépôt, avec le rapport en demande. - Documentaliste — il relit tous les dépôts et écrit la carte des services dans une page de notes : ce que fait chaque dépôt, ce qu'il expose, ce qu'il consomme, comment on le lance en local, où est sa configuration, et « qui appelle qui ». La page est créée au premier run puis mise à jour, jamais dupliquée — et ses sous-pages non plus : chacune garde le titre que l'agent lui a donné au premier run comme clé, et c'est par elle que le run suivant la retrouve. Renommer une sous-page à la main ne la casse pas : elle reste la même page sous son nouveau nom. Le run reçoit aussi les titres existants, et les retrouve même écrits un peu autrement (casse, accents, guillemets). Avec un horaire, le brief du matin annonce qu'elle a changé. Il dessine : la page générale porte un
flowchart« qui appelle qui » — un nœud par service, le libellé de la flèche disant le moyen (REST, événement, job), les bases et les files étant des nœuds aussi — et, quand un enchaînement traverse trois services, unsequenceDiagramqui le déroule. Chaque dépôt reçoit sa sous-page, avec le schéma de sa base enerDiagram: tables, colonnes-clés, relations, lus dans les migrations ou les modèles, et le chemin d'où ils sortent. Un dépôt sans base le dit en une ligne — la consigne lui interdit d'inventer une table, comme elle interdit à l'enquêteur d'inventer un dépôt.
Ces deux agents sont modifiables comme les autres — et restaurables d'un bouton si l'on va trop loin. Le troisième livré, le cartographe, ne se lance pas directement : c'est lui qui crée les agents de domaine.
Les agents de domaine
« Où est-ce qu'on gère les notifications, chez nous ? » se demandait au senior, ou s'explorait à neuf à chaque fois. Un agent de domaine porte la réponse.
Créer. Nouvel agent de domaine, un sujet (« les notifications : où elles sont émises, par quel mécanisme, quels types existent, où est la config, comment on les teste »), et le cartographe part. Il demande à un chercheur par dépôt si celui-ci est concerné, puis écrit un document à structure imposée — périmètre, dépôts, points d'entrée, mécanismes, types, configuration, tests, pièges, non trouvé, notes de l'équipe. Chaque chemin cité est ouvert sous le clone ; un chemin qui n'existe pas est marqué (non vérifié) et compté sur la carte. L'agent est créé directement : il n'a aucun effet tant qu'on ne le lance pas, et sa connaissance se modifie.
Essayer avant d'enregistrer. Le bouton Essai de l'éditeur ouvre une session portée par le profil tel qu'il est dans le formulaire — son modèle, ses outils, ses sous-agents, son prompt système — sans créer d'agent : essayer ne doit rien laisser derrière soi. Un bandeau le rappelle dans la modale, et ce qui échouerait au lancement (un mode de permission impossible, par exemple) est refusé tout de suite plutôt que trois minutes plus tard dans un journal. L'essai ne vaut que pour la session qu'on ouvre : la suivante repart vierge.
Utiliser. Demander lance une exploration sur ses dépôts, connaissance en tête. Coder ouvre la modale de session avec ses dépôts pré-cochés — on décoche et on confirme, ou, devant une longue liste (« tous les dépôts actifs »), Tout retirer la vide en une ligne prête à choisir, et l'on ajoute un par un. Toute réponse peut se terminer par la liste de ce que l'agent a constaté de faux dans sa propre carte ; il ne la corrige pas lui-même, il la signale, et le compteur d'écarts monte sur sa carte.
Savoir qu'elle a vieilli, pour rien. La connaissance enregistre le SHA de chaque dépôt et les chemins qu'elle cite. Mergerie compte les commits qui ont touché ces chemins-là depuis : « 7 commits depuis la carte » s'affiche sans aucun appel d'IA.
Mettre à jour. Mettre à jour relance le cartographe avec le même sujet, la connaissance précédente, les écarts constatés et la liste des commits : « regarde d'abord là ». Le résultat est une version en attente, avec un diff lisible — l'agent continue de travailler sur l'ancienne jusqu'à Relire et valider. C'est la seule sortie d'agent qui attend une validation. La section « Notes de l'équipe » est recopiée d'une version à l'autre par le code, pas seulement par le prompt : ce que l'équipe a écrit à la main ne se perd pas. Publier dans les notes en fait une page consultable.
Et la carte rejoint les reviews. La carte cite des chemins, une merge request porte les siens : le croisement se fait tout seul, sans IA et sans réseau — comme le badge « risque ». Une merge request qui touche ces chemins affiche donc un badge « ⚡ Notifications » sur sa carte et dans l'en-tête de son rapport ; le badge ouvre la carte, qui est justement ce qu'on voudrait relire à ce moment-là. Et la review elle-même reçoit l'index de la carte comme contexte, au même titre qu'un projet lié : l'agent sait ce que fait ce coin du code et ce qui casse quand on y touche, au lieu de le redécouvrir. L'index seulement, pas la carte entière — un prompt de review porte déjà le diff, le ticket, les règles et les projets liés, et trois pages de contexte de domaine noieraient ce qu'on venait ajouter.
Skills et sous-agents
Le sous-onglet Skills & sous-agents liste ce que le disque offre : les .claude/skills/<nom>/SKILL.md et .claude/agents/<nom>.md des dépôts clonés et de ton home. Mergerie les lit — il n'y écrit jamais rien. Un dépôt non cloné est signalé plutôt que passé sous silence.
Dans la modale de session, ils se cochent ; les skills cochés ouvrent la demande (/mon-skill), et ceux qui refusent le / sont nommés en toutes lettres. Dans le champ de demande comme dans un champ de suivi, taper « / » propose les skills, « @ » les sous-agents — rien ne s'insère sans une sélection explicite, et Échap ferme le menu sans fermer la fenêtre.
L'éditeur d'un agent
Six sections repliables, dans l'ordre des décisions : identité (nom, à quoi il sert, explorer ou coder), périmètre (tous les dépôts, ou une liste), rôle et demande (le texte ajouté au prompt système, et le gabarit — {question}, {repos}, {today}), capacités (modèle, ce qu'il a le droit de faire sans demander, outils autorisés et interdits, borne de tours, skills, sous-agents en JSON), sortie (un rapport, une page de notes, ou un agent de domaine), horaire.
Le formulaire se termine par l'argv réel, calculé par le serveur : c'est la seule façon de voir ce que tout cela produit. Le rôle s'ajoute au prompt système du CLI — le CLAUDE.md du dépôt et ses skills restent chargés. Le bouton Essai ouvre une session pré-remplie sans rien enregistrer.
Deux refus à la sauvegarde, pour ne pas les découvrir au moment où l'on comptait dessus : le mode de permission « poser la question » est impossible ici (l'entrée standard de l'agent est fermée, personne ne pourrait répondre), et un horaire exige une borne de tours — c'est la seule chose qui rende acceptable un agent qui part seul.
Horaires
Trois formes, écrites pour se relire sans manuel : chaque jour, chaque semaine (un jour), chaque mois (du 1 au 28 — au-delà, un mois sur deux serait sauté sans rien dire). Heure locale du serveur. Un créneau manqué parce que la machine était éteinte est rattrapé au démarrage suivant plutôt que perdu. Le plafond Runs d'agent automatiques par jour (Réglages → AI sessions) borne ce qui peut se déclencher tout seul ; atteint, les runs suivants sont sautés et le journal le dit.
Ailleurs dans l'outil
La palette propose « Demander à agent » et « Enquêter sur une trace d'erreur ». Un ticket Jira qui contient une trace affiche un bouton Enquêter. Les cartes de Dev IA portent la pastille de l'agent qui les a produites, et la liste se filtre par agent. Les statistiques ajoutent un coût par agent dès qu'un agent a tourné.