Aller au contenu
Pathrule

documentation

Proposed Knowledge

Tout ce que Pathrule ou un agent propose sans qu'une personne l'ait encore approuvé. Ce qui distingue une suggestion d'un constat, d'une connaissance vérifiée et d'une règle, où chaque type de proposition attend, et ce que l'approbation change pour vos agents.

Sur cette page

Proposed Knowledge regroupe tout ce qui attend l'aval d'une personne avant que vos agents soient autorisés à s'y fier.

Pathrule et vos agents remarquent sans cesse des choses : une convention qu'une équipe suit régulièrement, un correctif qui fonctionne à chaque fois, une contrainte qu'un paragraphe semble impliquer. Remarquer, c'est déduire, et une déduction ne devient une connaissance que lorsque quelqu'un s'en porte garant. Ce qui est appris n'est jamais considéré comme fiable automatiquement.

Cinq mots qui ne sont pas synonymes

Toute la conception repose sur ce qui les distingue.

Ce que c'estAtteint les agents ?
ConstatUne conclusion qu'un agent a tirée de votre code et enregistrée, avec les fichiers sur lesquels elle reposeOui, comme conseil à vérifier, et seulement tant que ses sources n'ont pas changé
SuggestionUne déduction de Pathrule ou d'un agent que personne n'a approuvéeNon
Connaissance vérifiéeUn élément approuvé par une personneOui
RègleUne contrainte posée par une personne pour un périmètre donné ; sa forme exécutable n'est appliquée qu'une fois approuvée par une personneOui, comme exigence
LivraisonCe qui parvient réellement à l'agent pour une tâche donnéeC'est précisément ce qui les atteint

D'où viennent les propositions, et où elles attendent

Votre agent, lors de la configuration d'un projet

Demandez à votre agent « Set up Pathrule for this project » et il lance une analyse guidée : il lit le projet, propose des mémoires, des règles et des skills, et n'enregistre que ceux que vous approuvez dans la conversation. Rien de ce qu'il propose n'est sauvegardé sans votre accord.

En dehors de cette analyse, un agent qui découvre quelque chose qui mérite d'être conservé vous le propose généralement avant de l'écrire. Lorsqu'il écrit, l'écriture est attribuée, versionnée et réversible.

Une contrainte associée à une règle

Une règle peut porter une contrainte exécutable : un motif qu'une modification ne doit pas contenir, et ce qu'il faut faire à la place. Lorsqu'un agent en associe une via pathrule_write_rule ou pathrule_update_rule, elle est stockée comme proposition. Elle n'est pas appliquée, et un agent ne peut pas l'approuver. Ce n'est qu'une fois approuvée par une personne que le hook pré-outil peut bloquer une modification correspondante, dans les clients dont les hooks le permettent. Voir les règles comme garde-fous.

Team Intelligence, sur Pathrule Cloud

Team Intelligence examine l'ensemble des éléments produits par le travail d'une équipe et propose des patterns. Un pattern passe de l'état de brouillon à celui de suggestion, puis un propriétaire ou un administrateur de l'organisation le vérifie ou le rejette dans la console web, dans les paramètres Team guidance de l'organisation ; une suggestion dont personne ne s'occupe expire. Seuls les patterns vérifiés atteignent les agents. Cette fonctionnalité est disponible avec les offres Team et Enterprise.

Vos préférences personnelles

Une préférence que vous enseignez avec pathrule me teach est vérifiée par rapport à vos propres mots avant d'être stockée. Une préférence pas encore en usage est listée par pathrule me list sous « Not in use yet » et n'atteint jamais un agent. pathrule me explain <id> indique sur quoi elle repose, et pathrule me forget <id> la rejette. Voir User Intelligence.

Connaissances obsolètes

Lorsqu'une connaissance semble dépassée, elle peut être signalée comme tâche d'actualisation, par exemple par un agent qui a remarqué l'écart et appelé pathrule_request_refresh. Une tâche d'actualisation est une proposition de modification d'une connaissance existante, qu'une personne ou un agent traite avec pathrule refresh ou les outils d'actualisation MCP. Voir suggestions et auto-audit.

L'exception : les constats

Les constats sont le seul type de connaissance apprise qui atteint les agents sans étape de revue, et c'est voulu. Un constat est un conseil, pas une politique :

  • il n'est enregistré qu'après vérification de ses fichiers sources sur le disque,
  • il n'est livré que tant que ces fichiers sont inchangés dans la copie de travail du lecteur,
  • il est retenu lorsque ses sources changent ou qu'il contredit un autre constat,
  • et il ne devient jamais de lui-même une mémoire, une règle ou un skill.

Tout ce qui doit s'imposer à tous les agents relève toujours d'une règle ou d'une mémoire, rédigée et revue par votre équipe.

Ce que change l'approbation

C'est l'approbation qui fait passer un élément du statut de suggestion à celui de connaissance vérifiée.

  • Une proposition d'analyse approuvée devient une mémoire, une règle ou un skill ordinaire, livré comme n'importe quel autre.
  • Un pattern d'équipe vérifié commence à atteindre les agents sur les espaces de travail de l'organisation concernée.
  • Une contrainte de règle approuvée devient applicable par le hook pré-outil dans les clients qui le prennent en charge.
  • Une proposition rejetée le reste, de sorte que les mêmes éléments ne la font pas réapparaître aussitôt.

Ce qu'il ne fait jamais

  • Il n'approuve jamais rien à votre place, et rien de ce qui requiert une approbation n'atteint un agent avant qu'une personne l'ait donnée.
  • Il ne laisse jamais un agent approuver sa propre proposition.
  • Il ne transforme jamais un constat en règle.
  • Il ne modifie jamais ce que votre équipe a écrit sans qu'une personne ou un agent agisse sur une proposition.

Pour savoir ce qui se passe une fois une connaissance approuvée, voir Agent IR et sécurité et repli.