Connaissances

L'onglet Connaissances présente la mémoire partagée d'un projet sous forme d'une seule carte. La mémoire, c'est ce que le code ne dit pas : le piège sur lequel quelqu'un est tombé en production, la convention qu'une équipe a adoptée, la note qu'un agent a laissée à la fin d'une session de travail. Les personnes l'écrivent depuis l'application ; les agents l'écrivent via le harness (remember, finish_work_session). Tout arrive au même endroit, et tout est servi au prochain agent qui touche la même partie du système.
Ouvrez-le depuis l'en-tête du projet (Connaissances), depuis la palette de commandes, ou via un lien que quelqu'un vous a partagé.
Lire la carte
- Les éléments sont les anneaux : les systèmes, conteneurs et composants C4 dont parlent les connaissances. Chaque mémoire se place autour de l'élément auquel elle est rattachée.
- Les mémoires sont les points, colorés selon leur type : piège, convention, note. Un point avec un anneau intérieur clair a été écrit par une personne ; les autres viennent d'agents.
- Les décisions (ADR) sont des carrés, reliés quand une mémoire y renvoie avec
[[ADR-12]]. - Les fantômes en pointillés sont des liens que personne n'a encore écrits : une mémoire mentionne
[[Rate limits]]et aucune mémoire ne porte ce titre. Cliquez dessus pour l'écrire.
La carte reste lisible avec des milliers de mémoires. Les mémoires qui énoncent le même fait se replient en un seul point, marqué ×3 quand trois copies le disent. Les bilans de session sont masqués par défaut et comptés sur leur élément ; affichez-les avec le bouton des sessions dans la barre d'outils. La légende des types sert aussi de filtre, et la frise en bas rejoue la façon dont les connaissances se sont accumulées.
Cliquez sur un point pour lire la mémoire en entier, avec ses liens et rétroliens. Cliquez sur un élément pour voir tout ce qui y est rattaché et écrire la mémoire suivante à son sujet.
Clavier : / lance la recherche, N écrit une mémoire, F cadre toute la carte, Esc revient en arrière.
Poser une question

Tapez une question dans le champ de recherche et cliquez sur Demander (ou appuyez sur Entrée après un point d'interrogation). La réponse est rédigée uniquement à partir des mémoires du projet, avec la même recherche que celle des agents : les mots et le sens, plus les mémoires liées aux meilleurs résultats. Chaque affirmation cite sa source par un numéro ; cliquez dessus pour retrouver cette mémoire sur la carte, où les mémoires citées sont mises en évidence.
Quand la mémoire ne contient rien sur le sujet, la réponse le dit au lieu de deviner. C'est le moment de noter le fait : la prochaine personne et le prochain agent le trouveront. Si aucun fournisseur d'IA n'est disponible, vous obtenez les mémoires les plus proches à la place d'une réponse. Poser une question ne compte pas comme des mémoires servies à un agent, et ne fausse donc pas les chiffres d'usage décrits plus bas.
Les réponses passent par le fournisseur d'IA de votre organisation, comme les autres fonctionnalités du harness.
Contradictions

Quand vous écrivez une mémoire presque identique à une mémoire existante sur les mêmes éléments, mais avec des chiffres différents (« relancé 8 fois » contre « relancé 3 fois »), Archyl s'arrête avant de fermer la boîte de dialogue et affiche les deux. Deux mémoires actives qui se contredisent, c'est ce qu'on peut servir de pire à un agent ; c'est donc à vous de choisir :
- Remplacer l'ancienne : l'ancienne mémoire passe dans l'historique. Les agents ne la voient plus, et la carte la garde comme fantôme reliée à sa remplaçante.
- Garder les deux : quand les deux sont vraies (deux environnements, deux tenants), gardez-les et rendez la différence explicite.
- Supprimer la mienne : c'est votre mémoire qui était fausse.
Réécrire mot pour mot un fait qui existe déjà ne stocke pas de deuxième copie : la mémoire existante est confirmée à la place, et la boîte de dialogue l'indique. Les agents bénéficient du même traitement via l'API, dans les champs deduplicated et conflicts de remember.
Partager un lien vers n'importe quel fait
Chaque mémoire et chaque élément a sa propre adresse. Le lien du panneau de lecture la copie ; collez-la dans une pull request, un ADR ou un fil Slack, et elle ouvre la carte sur cette mémoire avec ses voisines. Les liens vers une mémoire continuent de fonctionner après sa fusion avec un doublon, et un lien vers une mémoire remplacée depuis ouvre la vue de l'historique, pour toujours arriver quelque part.
Doublons
Quand des agents écrivent le même fait de plusieurs façons, le bouton des doublons affiche chaque groupe. Fusionner en une seule garde la copie la plus confirmée, retire les autres et déplace leurs liens. La fusion reste toujours votre décision : une formulation proche sur deux éléments différents, ou avec des chiffres différents, n'est jamais proposée comme doublon.
À revalider

Une mémoire que personne ne revalide devient fausse sans bruit. La lecture À revalider de la carte ne laisse en pleine intensité que les mémoires qui demandent un regard humain, et les liste :
- Son élément a changé : le code sous l'élément a évolué depuis la dernière confirmation de la mémoire. Les agents la reçoivent toujours, marquée comme à vérifier. Si elle est toujours juste, Toujours vrai la confirme et retire la marque ; sinon, ouvrez-la pour la corriger ou la remplacer.
- Les agents ne l'utilisent jamais : elle a été servie à cinq sessions ou plus et aucune n'a indiqué qu'elle avait servi. Ouvrez-la pour la préciser, la rattacher au bon élément ou la supprimer.
Rien dans cette liste n'est supprimé automatiquement. Les mêmes éléments arrivent à l'équipe dans le digest hebdomadaire, pour que la liste ne dépende pas de quelqu'un qui ouvre l'onglet.
Usage

La lecture Usage dimensionne chaque mémoire selon le nombre de sessions d'agent auxquelles elle a été servie. Les points pleins ont été utilisés au moins une fois (un agent les a cités dans usedMemories en terminant sa session), les creux ont été servis sans jamais être utilisés, les pâles n'ont jamais été servis. Elle répond d'un coup d'œil à deux questions : quelles connaissances portent réellement le travail des agents, et lesquelles ne sont que du bruit.
Permissions
Toute personne qui peut voir le projet peut lire la carte et poser des questions. Écrire, confirmer, fusionner, remplacer et supprimer des mémoires demande les droits d'édition sur le projet.