Introduction

Pathrule est la couche d'intelligence de vos agents de codage.

Il conserve ce qu'un projet, un développeur et une équipe ont appris, lie ces connaissances à des chemins du code et transmet à l'agent de codage que vous utilisez déjà ce dont chaque tâche a besoin. Project Intelligence décrit le fonctionnement d'une base de code : les décisions, contraintes, exigences de vérification, correctifs et procédures qu'un dépôt accumule autour de son code. User Intelligence décrit votre façon de travailler, et reste stockée sur votre machine. Team Intelligence, sur Pathrule Cloud, analyse les éléments factuels de l'équipe pour en tirer des patterns qui ne parviennent aux agents qu'après vérification par une personne.

Pathrule n'est ni un modèle de code, ni un IDE, ni un runtime d'agent. Claude Code, Codex, Cursor, GitHub Copilot, Windsurf et les autres clients compatibles MCP restent les moteurs d'exécution, chacun avec son propre fournisseur de modèle. Pathrule est leur point de départ : c'est pourquoi changer d'agent ne remet pas à zéro ce que l'on sait du travail.

Pour une vue complète de l'architecture, consultez la vue d'ensemble de l'architecture.

Ce que vous écrivez, et ce que Pathrule en fait

Votre équipe rédige délibérément trois types de contenu. Ce sont des entrées, et ils forment la surface de rédaction : c'est ce qu'une personne modifie et discute, pas ce que reçoit un agent.

• Mémoire : une courte note en Markdown qui consigne une décision, un piège de schéma, un postmortem ou une convention. Elle est rattachée à un chemin de l'espace de travail et n'apparaît donc que lorsque le travail se fait à proximité.
• Règle : une contrainte que l'assistant doit respecter lorsqu'il travaille dans un périmètre donné. Chaque règle a une priorité (high, medium, low) qui détermine avec quelle force elle remonte. Une règle est transmise comme contexte ; une règle dont la contrainte exécutable a été approuvée par une personne peut aussi bloquer une modification correspondante, dans les clients dont les hooks le permettent.
• Skill : une procédure nommée que l'assistant peut invoquer au lieu de reconstituer les étapes lui-même. Utile pour les tâches récurrentes, comme rejouer un webhook, régénérer une fixture ou dérouler une checklist de release.

Ce que Pathrule ne fait pas : analyser ou envoyer automatiquement votre code source. Ce qu'il lit dans une copie de travail est limité et clairement identifié. Sur un espace de travail Cloud, la première fois qu'un agent demande un contexte approfondi, le runtime local lit les chemins de fichiers de l'historique git récent pour apprendre quels fichiers évoluent ensemble, ainsi que les noms de fichiers proches de la racine de l'arborescence pour reconnaître les technologies utilisées. Les paires de chemins de fichiers et quelques courtes mémoires sur les technologies sont enregistrées dans l'espace de travail, sans demande de confirmation ; ni le contenu des fichiers, ni les diffs, ni les messages de commit ne sont lus pour cela. En mode Cloud, le début de chaque prompt est envoyé pour prioriser les connaissances, et pathrule snapshot, lorsque vous ou votre agent l'exécutez, envoie une vue d'ensemble du projet. Ce que calcule Pathrule détaille précisément ce qui est lu et ce qui est conservé.

Ce que reçoit un agent est plus restreint que ces documents. Pour une tâche donnée, Pathrule sélectionne les entrées qui s'appliquent au chemin et à la demande, les priorise et les fait tenir dans un budget par prompt ; ce qui ne tient pas est listé par titre, pour que l'agent puisse aller le chercher délibérément. Une règle arrive comme une exigence et un correctif mémorisé comme un conseil, au lieu de deux paragraphes de même poids. Agent IR décrit le contenu de ce paquet transmis.

Et ce qu'il en déduit

Ces trois types de contenu sont ce que rédige votre équipe. Ils ne représentent que la plus petite partie de ce que contient la couche.

Autour d'eux s'ajoute une couche dérivée que personne ne saisit. Chaque entrée existe aussi sous la forme d'une représentation calculée de son sens : c'est ainsi qu'un prompt en turc retrouve une mémoire en anglais avec laquelle il n'a aucun mot en commun. Chaque transmission est mesurée : quelles entrées ont été envoyées, lesquelles l'assistant a réellement consultées, combien d'appels d'outils le tour a nécessité et combien ont échoué. Ces mesures s'accumulent pour dresser un tableau de ce qui aide selon le type de travail, un graphe des fichiers que votre équipe modifie ensemble, une carte des endroits où un assistant se retrouve régulièrement bloqué, et des jugements sur les entrées que le code a rendues obsolètes.

Tout cela provient de ce que votre équipe a consigné et de ce que le travail a rapporté sur lui-même, auxquels s'ajoutent, sur un espace de travail Cloud, les chemins de fichiers de l'historique git récent, qui amorcent le repérage des fichiers modifiés ensemble avant que votre équipe ait enregistré beaucoup de travail. Rien de tout cela ne provient de la lecture du contenu de vos fichiers. C'est aussi la raison pour laquelle les trois mêmes fichiers posés dans un répertoire ne se comportent pas de la même façon : un répertoire ne sait pas ce qui a été transmis, ce qui a aidé, ni quels fichiers évoluent ensemble. Voir ce que calcule Pathrule.

Une seule intelligence, tous les accès

Les mêmes connaissances sont accessibles depuis chaque surface :

• CLI : installation, configuration Cloud ou Local, connexion de vos agents de codage, lecture et ajout de connaissances depuis le terminal, scripts et automatisation.
• Extension VS Code : parcourir et modifier les connaissances à côté de vos fichiers, enregistrer le MCP pour le mode agent de GitHub Copilot et connecter d'autres clients.
• Serveur MCP local : les outils de l'espace de travail pour chaque client pris en charge, installés avec le CLI ou l'extension VS Code.
• Remote MCP : un endpoint MCP hébergé pour les clients qui se connectent en Streamable HTTP avec votre compte Pathrule.
• Pathrule Cloud : comptes, organisations, espaces de travail, persistance gérée et historique, Team Intelligence, Remote MCP et facturation.
• Auto-hébergé pour les entreprises : Pathrule Cloud dans votre propre compte Cloudflare, via l'équipe commerciale.

L'indépendance vis-à-vis des agents ne signifie pas que tous sont atteints de la même manière. Claude Code et Codex disposent de hooks qui transmettent le contexte à la soumission d'un prompt. Cursor et GitHub Copilot disposent de hooks de session et d'outils. Windsurf n'a pas de hooks et fonctionne à partir d'un fichier de règles et du MCP. La présentation du MCP donne le détail pour chaque client.

Le déroulement d'une session

1. Votre équipe rédige une mémoire sur un chemin de l'espace de travail, par exemple /apps/api/payments.
2. Vous ouvrez Claude Code dans ~/repos/main/apps/api/payments.
3. Lorsque vous soumettez un prompt, le hook Pathrule lit la partie mise en cache pour ce chemin et la transmet à l'agent avant son premier appel d'outil.
4. L'assistant voit la mémoire, les règles pertinentes et les skills rattachés à ce périmètre, et se comporte comme s'il les connaissait déjà.

Pas de prompt supplémentaire à écrire, pas d'aller-retour MCP supplémentaire en cours de tâche, et pas de fichier global qui grossit indéfiniment. Les clients sans hook de prompt reçoivent les connaissances via leurs fichiers d'instructions, via des hooks de session et d'outils lorsqu'ils en ont, ou via le MCP, comme l'indique leur guide.

Pour aller plus loin

• La vue d'ensemble de l'architecture présente tout le système sur une seule page, ainsi que le vocabulaire sur lequel s'appuie le reste de cette documentation.
• Le guide de démarrage rapide explique comment installer le CLI, connecter un espace de travail, rédiger votre première mémoire et voir le hook se déclencher.
• Les concepts clés expliquent la différence entre mémoires, règles et skills, ainsi que le fonctionnement du périmètre de chemin et de la priorité.
• Pathrule pour VS Code traite du travail sur les connaissances dans l'éditeur.
• La présentation du MCP présente les outils MCP que l'assistant utilise pour lire et écrire du contenu.