Concepts clés

Le modèle de données de Pathrule est volontairement réduit : trois types de contenu, une arborescence de nœuds et une portée fondée sur les chemins. Une fois cette structure en tête, tout le reste de Pathrule en découle.

Gardez une idée à l'esprit en lisant cette page : les trois types de contenu ci-dessous constituent la surface de rédaction. C'est ce qu'une personne écrit, modifie et discute, et ce sont des entrées. Ce que reçoit un agent dépend de la tâche : uniquement les éléments qui s'appliquent au travail en cours, priorisés et ajustés à la tâche. La vue d'ensemble de l'architecture traite de cet aspect ; cette page traite de ce que vous écrivez.

L'arborescence de l'espace de travail

Un espace de travail est une arborescence de nœuds. La racine est l'espace de travail lui-même. Les enfants sont des dossiers ou des fichiers qui reflètent les parties de votre dépôt sur lesquelles votre équipe consigne des connaissances.

/                            workspace root
  /apps                      folder node
    /apps/web                folder node
      /apps/web/auth         folder node
        /apps/web/auth/login.tsx   file node

Inutile de créer l'arborescence à la main. Lorsque vous écrivez une mémoire dans /apps/web/auth, Pathrule crée à la demande la chaîne de nœuds correspondante. Les nœuds vides ne coûtent rien et se suppriment facilement plus tard si le chemin n'est plus utile.

Mémoires

Une mémoire est un court document Markdown qu'un membre de l'équipe rédige pour que l'assistant puisse le lire plus tard.

• Faits : notes sur un schéma, décisions de conception, pièges à connaître.
• Postmortems : ce qui a cassé, ce que nous en avons appris, comment nous l'avons corrigé.
• Conventions : la manière dont l'équipe préfère faire les choses.

Par défaut, les mémoires sont indicatives. Elles apparaissent dans le contexte de l'assistant lorsque le hook juge qu'elles sont pertinentes pour le chemin sur lequel l'assistant travaille.

La plupart des mémoires sont écrites par des personnes ou par un assistant qui travaille avec vous. Sur un espace de travail Cloud, Pathrule en ajoute aussi quelques-unes de lui-même : de courtes notes technologiques à la racine de l'espace de travail, comme « TypeScript project » ou « Docker containerization », déduites des noms de fichiers la première fois qu'un agent demande un contexte approfondi. Ce sont des mémoires ordinaires : vous pouvez les modifier ou les supprimer comme les autres.

Règles

Une règle est une contrainte que l'assistant doit respecter dans une portée donnée.

Une règle comporte :

• Un type de portée. folder signifie que la règle s'applique sous un répertoire. file_type signifie qu'elle s'applique à un motif de fichiers comme *.tsx. project signifie qu'elle s'applique partout dans l'espace de travail.
• Une priorité. high pour les contraintes les plus importantes, medium pour les recommandations générales, low pour les préférences de style. La priorité détermine la force avec laquelle une règle remonte, pas le fait qu'elle bloque ou non.
• Un mode d'application. Les règles advisory accompagnent le contexte et l'assistant décide de la façon de les appliquer. Une règle strict porte une contrainte exécutable approuvée par une personne et peut bloquer une modification correspondante avant qu'elle ne soit appliquée, dans les clients dont les hooks s'exécutent avant un appel d'outil.
• Un corps. Une courte liste à puces formulée à l'impératif fonctionne le mieux.

Les règles de priorité élevée remontent en premier lorsque leur portée correspond au chemin courant. Les règles de priorité plus faible remontent lorsqu'elles ont de bonnes chances d'être utiles.

Skills

Un skill est une procédure nommée que l'assistant peut invoquer au lieu de reconstituer les étapes à chaque fois.

Exemples :

• replay-stripe-webhook : une checklist avec la commande CLI exacte et les précautions à prendre avant de l'exécuter.
• regenerate-fixtures : le chemin du script, les entrées et le résultat attendu.
• release-check : la checklist d'avant release que l'équipe veut toujours voir l'assistant dérouler.

Les skills sont repérables par leur nom. L'assistant peut demander à Pathrule les skills associés au chemin courant et choisir celui qui correspond à la tâche.

Portée par chemin

Chaque mémoire, règle et skill se trouve à un chemin de nœud. Ce chemin détermine où l'élément apparaît.

• Une mémoire dans /apps/web est pertinente pour tout travail sous apps/web.
• Une mémoire dans / est pertinente partout.
• Un skill dans /services/billing est proposé à l'assistant lorsque le travail se déroule dans le service de facturation.

C'est la portée par chemin qui permet de garder la fenêtre de contexte de l'assistant compacte. Une retouche d'interface dans apps/web/dashboard n'a pas besoin des règles sur les migrations de base de données.

Priorité et application

La priorité et l'application sont deux réglages indépendants.

• La priorité (high, medium, low) détermine la force avec laquelle une règle remonte. Utilisez high avec parcimonie, pour les contraintes les plus importantes.
• L'application (advisory ou strict) détermine ce qui se passe en cas de violation. Les règles indicatives sont transmises comme contexte et l'assistant décide de la façon de les appliquer ; toute nouvelle règle commence en mode indicatif. Un agent peut proposer une contrainte exécutable pour une règle : elle est enregistrée comme proposition et n'est pas appliquée. Une fois qu'une personne l'a approuvée, le hook local vérifie toute modification correspondante avant qu'elle ne soit appliquée, peut bloquer la modification et indique la règle comme motif.

Le CLI Pathrule et l'extension VS Code enregistrent les hooks disponibles pour Claude Code, Codex, Cursor et GitHub Copilot, et le blocage s'applique là où le hook du client peut interrompre un appel d'outil. Windsurf n'a pas de hooks, et le Remote MCP n'en installe aucun : tous deux reçoivent les règles comme contexte, sans événement de blocage Pathrule avant écriture.

Pour aller plus loin

• Ce que Pathrule calcule présente la couche dérivée qui s'articule autour de ces trois types de contenu rédigé.
• Fonctionnement des hooks explique comment le runtime choisit la portion de contenu à transmettre.
• Présentation du MCP liste les outils que l'assistant utilise pour lire et écrire des nœuds.
• Démarrage rapide est le moyen le plus rapide de voir ce modèle en action.