Vue d'ensemble de l'architecture

Pathrule est la couche d'intelligence située entre vous, votre espace de travail et les agents de codage que vous utilisez.

Chaque morceau de cette phrase a un sens précis, et il vaut la peine de les reprendre un par un. Entre vous et vos agents, parce qu'une partie de ce que Pathrule conserve porte sur votre façon de travailler, et non sur le code. Entre votre espace de travail et vos agents, parce que le reste correspond à ce qu'un dépôt, et l'équipe qui l'entoure, a appris sur lui-même. Une couche, parce que Pathrule ne vit à l'intérieur d'aucun agent : passer de Claude Code à Codex change qui exécute, pas ce qui est connu.

Ce que Pathrule n'est pas : un modèle de codage, un IDE ou un runtime d'agent. Il n'écrit pas le code de votre application, et votre agent de codage conserve son propre fournisseur de modèle.

La forme du système

        YOU                        YOUR TEAM
         |                             |
         v                             v
 USER INTELLIGENCE   WORKSPACE INTELLIGENCE   TEAM INTELLIGENCE
  (your machine)     (memories, rules,        (Pathrule Cloud,
                      skills, findings)        human-verified)
         \                   |                    /
          \                  v                   /
           +-------->  TASK-SCOPED DELIVERY  <--+
                             |
                             v
        Claude Code / Codex / Cursor / Copilot / Windsurf

Plusieurs sources de connaissances convergent. Pour un travail donné, la partie pertinente pour ce chemin et ce prompt est sélectionnée, priorisée, puis transmise à l'agent par le mécanisme que son client prend en charge.

Fondations et clients

Le CLI, l'extension VS Code et le serveur MCP local sont les composants que vous installez. Pathrule CLI, Pathrule pour VS Code et Remote MCP décrivent chacun d'eux.

Le cycle de vie

Six étapes. Chacune est observable dans le produit, ce n'est pas un simple schéma.

Observer. Le travail produit des éléments probants : les mémoires, règles et skills rédigés par des personnes et des agents, les constats que les agents enregistrent sur le code, l'activité qu'ils journalisent, et ce qui a été transmis à chaque session.

Comprendre. L'Intelligence Engine de Pathrule détermine ce que ces éléments signifient pour le travail à venir. Sur Pathrule Cloud, Team Intelligence analyse les éléments de l'équipe pour en tirer des patterns suggérés. Sur un Mac Apple Silicon, le modèle local facultatif transforme ce que vous lui apprenez sur votre façon de travailler en une préférence structurée, fondée sur vos propres mots. Tout ce qui est déduit reste une suggestion tant qu'une personne ne l'a pas approuvé.

Compiler. Les connaissances sont restituées dans les fichiers que chaque agent lit déjà, comme CLAUDE.md ou AGENTS.md aux chemins qu'elles régissent, ainsi que dans un index local lu par les hooks. Voir compilation.

Diffuser et appliquer. Pour chaque tâche, les connaissances qui s'appliquent au chemin et au prompt sont sélectionnées, priorisées et transmises dans un budget par prompt ; tout ce qui ne tient pas dans ce budget est listé par titre. Une règle peut porter une contrainte exécutable ; une fois qu'une personne l'a approuvée, le hook pré-outil peut bloquer une modification correspondante dans les clients dont les hooks le permettent. Une exigence rédigée ne crée pas à elle seule de contrôle bloquant.

Vérifier. Pathrule enregistre ce qu'il a transmis et les entrées que l'agent a ensuite consultées, afin que l'effet d'une connaissance puisse être mesuré plutôt que supposé.

Apprendre. Ce que les agents ont réellement utilisé oriente ce qui sera mis en avant la fois suivante. Les connaissances obsolètes peuvent être signalées pour être actualisées. Sur Cloud, les patterns d'équipe passent de brouillon à suggéré puis à vérifié, ou sont rejetés ou expirent, et seuls les patterns vérifiés atteignent les agents.

Des mots qui ne sont pas synonymes

Le reste de cette documentation suppose de bien distinguer ces termes.

• Mémoire : ce qui a été consigné. Une note sur une décision, écrite à un moment donné.
• Connaissances : ce que cette trace signifie pour le travail à venir, avec les éléments qui l'étayent.
• Intelligence : le système qui décide quelles connaissances comptent, et quand.
• Contexte : la réponse pour une tâche donnée, ce qui compte ici et maintenant.
• Constat : une conclusion qu'un agent a enregistrée sur le code. C'est un conseil, confronté au code à chaque diffusion, qui ne devient jamais une règle de lui-même.
• Suggestion : ce que Pathrule ou un agent a déduit sans qu'une personne l'ait approuvé. Elle n'est pas considérée comme fiable.
• Connaissances vérifiées : ce qu'une personne a approuvé.
• Règle : une contrainte fixée par une personne pour un périmètre. Sa forme exécutable n'est appliquée qu'après approbation par une personne.
• Diffusion : ce qui atteint réellement l'agent pour une tâche. Agent IR la décrit.

Une mémoire est une entrée. Le contexte est une sortie. Ni l'un ni l'autre n'est le produit.

Pour aller plus loin

• Workspace Intelligence : périmètre, autorité, sources, cycle de vie.
• User Intelligence : ce que vous enseignez, ce que vous contrôlez, et pourquoi les exigences du projet priment toujours.
• Apprentissage du projet : les constats que les agents tirent de votre code, partagés comme conseils.
• Le modèle local : le modèle facultatif exécuté sur l'appareil, sa plateforme et son usage.
• Knowledge IR : comment la nature et l'autorité de chaque connaissance sont préservées lors de la diffusion.
• Compilation : ce que Pathrule écrit dans les fichiers que lisent vos agents.
• Proposed Knowledge : tout ce qui attend l'aval d'une personne avant d'être considéré comme fiable.
• Agent IR : ce qu'un agent reçoit pour une tâche.
• Sécurité et repli : ce que fait Pathrule lorsqu'il n'est pas sûr.

La frontière du code ouvert

Pathrule CLI est open source sous licence Apache-2.0 et publié sur npm sous le nom @pathrule/cli. Les dépôts publics de github.com/pathrule comprennent le CLI, le cœur, les patterns et les benchmarks sous Apache-2.0, ainsi que l'ancien serveur MCP sous MIT.

Pathrule Cloud et l'Intelligence Engine, qui couvre l'extraction, l'apprentissage, l'évaluation, la sélection et la priorisation ainsi que les fonctionnalités assistées par modèle, sont propriétaires. Cette documentation décrit ce qu'ils font pour vous, pas la façon dont ils sont construits.

Consultez Cœur open source pour plus de détails.