Workspace Intelligence

Workspace Intelligence répond à une seule question : comment fonctionne ce projet ?

Il ne s'agit pas de ce que contiennent les fichiers. Un agent peut les lire, et il les lit bien. Ce qu'il ne peut pas lire, ce sont les connaissances pratiques qu'un dépôt accumule autour de son code, c'est-à-dire précisément celles qui déterminent si une modification est juste ou seulement plausible.

Ce qu'elle modélise

• Les décisions d'architecture, et le raisonnement qui les a produites.
• Les contraintes cachées, qui n'apparaissent nulle part dans le code.
• Les exigences de vérification : ce qui doit être contrôlé avant de considérer une tâche comme terminée.
• Les correctifs antérieurs : ce qui a réellement fonctionné la dernière fois que ce problème précis s'est présenté.
• Les conventions qu'une équipe suit sans les avoir écrites.
• Les procédures : la manière ordonnée dont une tâche récurrente est menée ici.
• Les faits contextuels qui changent la bonne approche, par exemple une base de données qui est une réplique en lecture seule.
• Les justifications techniques, qui empêchent un agent de défaire, avec les meilleures intentions, une décision délibérée.
• Les implémentations privilégiées parmi plusieurs qui fonctionneraient toutes.
• Les décisions remplacées, pour qu'une ancienne décision cesse d'être traitée comme actuelle.

Tout cela réside dans trois types de contenu que votre équipe peut lire et modifier : les mémoires, les règles et les skills.

Périmètre

Workspace Intelligence est liée à un dépôt et, à l'intérieur de celui-ci, à des chemins.

C'est ce mécanisme qui empêche une couche de connaissances de devenir le problème qu'elle devait résoudre. Tout ce qui est vrai d'un monorepo n'est pas pertinent pour une modification dans un seul package, et tout transmettre met en concurrence les trois phrases qui comptent avec deux cents qui ne comptent pas. Les connaissances sont rattachées au chemin qu'elles régissent, et une tâche menée dans ce chemin reçoit ce qui le régit.

C'est aussi grâce au rattachement aux chemins qu'un espace de travail peut continuer à grossir sans que chaque échange s'alourdisse. Voir le fonctionnement de la récupération.

Autorité

Workspace Intelligence est la couche qui peut porter des exigences strictes.

Ces exigences résident dans les règles. Une règle énonce ce qui doit ou ne doit pas se produire dans un périmètre, porte une priorité et arrive dans sa propre section, séparée des conseils. Une règle peut aussi comporter une contrainte exécutable, c'est-à-dire un motif qu'une modification ne doit pas contenir. Une contrainte proposée par un agent est enregistrée comme proposition et n'est pas appliquée ; 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. Voir les règles comme garde-fous.

Ce sont des propriétés du projet. Elles ne sont pas écartées parce qu'une préférence personnelle serait plus commode, et User Intelligence ne peut pas prévaloir sur elles. Tout le reste de ce que contient Workspace Intelligence est consultatif et transmis comme conseil, si bien qu'un correctif antérieur n'est jamais présenté comme s'il primait sur une règle.

Sources

Il en existe quatre types, et il importe de savoir lequel est lequel.

Rédigées. Les mémoires, règles et skills qu'une personne a écrits délibérément, ou qu'un agent a écrits via les outils de Pathrule, généralement après vous les avoir proposés. Ce sont celles qu'une équipe peut désigner et discuter, et elles forment l'ossature de l'ensemble.

Constats tirés du code. Les constats qu'un agent a établis en lisant votre code, enregistrés avec les fichiers sur lesquels ils reposent et transmis comme conseils uniquement tant que ces fichiers restent inchangés. Voir l'apprentissage du projet.

Éléments issus du travail réel. Ce que les sessions d'agent ont rapporté sur elles-mêmes : quelles connaissances ont été transmises, lesquelles ont réellement été consultées, quels fichiers ont évolué ensemble, où un agent restait bloqué. Voir ce que Pathrule calcule.

Amorçage depuis votre copie locale, sur un espace de travail Cloud. La première fois qu'un agent demande à Pathrule un contexte approfondi sur un espace de travail Cloud, le runtime local lit les chemins de fichiers dans l'historique git récent pour savoir quels fichiers ont changé ensemble, et liste les noms de fichiers des premiers niveaux de l'arborescence pour reconnaître les technologies utilisées, par exemple une configuration TypeScript, Docker ou GitHub Actions. Les paires de chemins sont enregistrées dans l'espace de travail comme point de départ des fichiers qui changent ensemble, afin que ce signal soit utile avant même que votre équipe ait enregistré beaucoup de travail. Chaque technologie reconnue devient une courte mémoire à la racine de l'espace de travail, comme « TypeScript project », écrite sans vous le demander ; c'est une mémoire ordinaire que vous pouvez modifier ou supprimer. Un espace de travail local saute cette étape et apprend quels fichiers changent ensemble uniquement à partir du travail enregistré.

Ce qui n'est pas une source : votre code source. Pathrule n'envoie pas automatiquement votre code, et l'amorçage décrit ci-dessus lit des noms de fichiers et des chemins, pas le contenu des fichiers, les diffs ni les messages de commit. Sur un espace de travail Cloud, pathrule snapshot, lorsque vous ou votre agent l'exécutez, envoie l'arborescence des fichiers, les manifestes, de courts extraits de documentation et les métadonnées git récentes afin que Pathrule puisse décrire le projet. Ce que Pathrule calcule détaille ce qui est lu et ce qui est conservé.

Team Intelligence

Sur Pathrule Cloud, Team Intelligence examine l'ensemble des éléments produits par le travail d'une équipe et propose des patterns : des conventions, des correctifs et des décisions qui reviennent régulièrement. Elle est disponible avec les offres Team et Enterprise, et les propriétaires et administrateurs de l'organisation la gèrent dans la console web, dans les paramètres Team guidance de l'organisation.

Un pattern passe de l'état de brouillon à celui de suggestion, puis une personne le vérifie ou le rejette ; une suggestion que personne ne traite expire. Seuls les patterns vérifiés atteignent les agents. Rien de ce que Team Intelligence déduit n'est considéré comme fiable de lui-même.

Cycle de vie

1. Rédigé ou proposé. Une personne le rédige avec le CLI, l'extension VS Code ou son agent. Un agent qui a découvert quelque chose qui mérite d'être conservé l'enregistre via les outils d'écriture de Pathrule, généralement après vous l'avoir proposé, et l'écriture est attribuée, versionnée et réversible. Demander à votre agent « Set up Pathrule for this project » lance une analyse guidée au cours de laquelle l'agent propose des mémoires, des règles et des skills, puis écrit ceux que vous approuvez. Sur un espace de travail Cloud, Pathrule ajoute également les courtes mémoires de technologie décrites plus haut.
2. Approuvé, lorsqu'il a été déduit. Les connaissances déduites attendent une personne : la contrainte exécutable d'une règle n'est appliquée qu'après approbation, et un pattern de Team Intelligence n'atteint les agents qu'une fois vérifié. Les constats des agents sont la seule exception, et ils restent consultatifs. Voir Proposed Knowledge.
3. Transmis. La partie pertinente pour une tâche parvient à l'agent par le mécanisme que son client prend en charge. Voir Agent IR.
4. Mesuré. La transmission et ce que l'agent en a fait sont enregistrés, de sorte que le crédit d'une entrée reflète ce qui s'est passé plutôt que l'identité de son auteur.
5. Actualisé, remplacé ou retiré. Une connaissance qui semble périmée peut être signalée comme tâche d'actualisation, qu'une personne ou un agent traite ensuite. Une décision remplacée par une décision ultérieure cesse d'être traitée comme actuelle. Voir suggestions et auto-audit.

Ce qui change quand vous changez de projet

Tout. Workspace Intelligence appartient au dépôt, et en ouvrir un autre signifie disposer d'un autre ensemble de connaissances de projet, partagé avec toutes les personnes qui y travaillent.

Ce qui vous suit, c'est User Intelligence, qui vous appartient : les préférences que vous avez apprises à Pathrule et choisi d'appliquer partout.