Apprentissage du projet

L'essentiel de ce qu'un agent apprend sur votre projet, il l'apprend en lisant le code. Pourquoi une file s'arrête à la première erreur réseau, par quel helper passent tous les chemins de paiement, comment l'équipe a tranché le dernier débat sur la gestion des erreurs : un agent le comprend, s'en sert, puis la session se termine. L'agent suivant, ou celui d'un collègue, doit refaire tout ce travail, et le payer.

L'apprentissage du projet conserve ces conclusions. Un agent enregistre ce qu'il a compris avec les fichiers qu'il a lus, et chaque agent de l'espace de travail part de là, tant que le code dit toujours la même chose.

Qu'est-ce qu'un constat

Un constat est une conclusion qu'un agent a tirée de votre code, accompagnée des fichiers sur lesquels elle repose et de ce que contenaient ces fichiers au moment de la lecture. Pathrule compare ces fichiers à ce qui se trouve sur le disque avant d'accepter le constat : un constat ne porte donc jamais que sur du code qui existe.

Un constat n'est ni une mémoire, ni une règle, ni un skill. Il n'en devient jamais une de lui-même, et il ne bloque jamais rien. Il occupe sa propre couche, à côté des connaissances rédigées par votre équipe.

Comment il parvient aux agents

Les constats arrivent dans le contexte qu'un agent demande à Pathrule, via pathrule_get_context. Ils sont présentés comme des conseils à vérifier, et les agents ont pour consigne de les traiter comme des informations et non comme des instructions : un texte glissé dans un fichier ne peut donc pas se transformer en ordre permanent.

Un constat n'est fourni que tant que ses éléments de preuve tiennent dans votre copie de travail :

• Sources inchangées. Le constat est fourni.
• Une source a changé. Le constat est retenu jusqu'à ce qu'un agent relise le code et le confirme ou le corrige. Personne ne reçoit de réponse portant sur du code qui n'existe plus.
• Deux constats se contredisent. Les deux sont retenus, plutôt que de choisir l'un d'eux au hasard.

Cette vérification se fait pour chaque copie de travail : un collègue sur une branche plus ancienne ou plus récente ne reçoit que les constats valables pour le code qu'il a sous les yeux.

Corriger et retirer

Un agent peut corriger un constat en en enregistrant un nouveau qui le remplace, avec des sources fraîchement vérifiées. Un constat qui s'avère faux peut être retiré par la personne dont l'agent l'a enregistré. Le retrait s'applique immédiatement à tout l'espace de travail, et une ancienne tentative venue d'une machine restée hors ligne ne peut jamais le faire revenir.

Les agents peuvent lister les constats à jour, obsolètes et contradictoires, y compris ceux retenus hors du contexte : chacun peut ainsi voir exactement ce que contient la couche et pourquoi un élément n'a pas été fourni.

Apprendre des revues passées

Avec un accès GitHub via votre connexion gh existante, un agent peut lire les anciennes discussions de revue du dépôt pour voir comment l'équipe a tranché une question similaire, et les citer dans un constat. Pathrule ne stocke pas les commentaires eux-mêmes, et ignore les revues de bots, les revues externes et les revues rejetées. Sans accès GitHub, tout le reste continue de fonctionner.

Ce qui quitte votre machine

L'apprentissage du projet ne nécessite aucun modèle local et n'écrit rien dans votre dépôt.

Dans un espace de travail local, les constats restent dans son stockage local, sur votre machine. Dans un espace de travail Cloud, Pathrule partage le constat et son origine, c'est-à-dire les chemins des fichiers et une empreinte de ce que contenait chacun d'eux, afin que les autres copies de travail puissent déterminer si le constat tient toujours. Le contenu des fichiers n'est pas envoyé. Un constat enregistré hors ligne attend dans une file et part dès le retour de la connexion.

Il n'y a pas d'étape de revue

Un constat est partagé dès que ses sources sont vérifiées ; personne ne l'approuve au préalable. C'est un choix délibéré : les constats sont des conseils revérifiés par rapport au code à chaque fourniture, pas une politique d'équipe. Tout ce qui doit s'imposer à chaque agent a toujours sa place dans une règle ou une mémoire, rédigée et relue par votre équipe.

Les outils correspondants sont listés dans la référence des outils MCP.