Concepts clés

Neuronz.ai conserve quelques types d'enregistrements (faits, documents de connaissances, travail passé, sujets, règles et quelques autres), les relie entre eux et oriente votre agent vers ceux qui correspondent à ce que vous faites. Voici à quoi sert chacun.

Le vocabulaire

• Harnais d'agent (harness) : l'agent de code que vous utilisez, à savoir Claude Code, l'application Claude pour ordinateur ou Oh-My-Pi.
• Profil : l'espace où vit votre mémoire, en général un par projet.
• Enregistrement : un élément conservé, par exemple un fait, un document de connaissances, une action, un sujet ou une règle.
• Fait : une courte affirmation qui mérite d'être retenue.
• Connaissances : un document de référence plus long, conservé en entier.
• Action : la trace de ce qui s'est passé, qu'il s'agisse d'un travail fait par l'agent ou d'une discussion avec vous.
• Sujet : un problème récurrent ou un chantier, suivi dans la durée.
• Règle : une consigne que vos agents doivent suivre, approuvée par vous.
• Voix : la façon dont vos textes doivent se lire dans une situation donnée.
• Persona : ce que l'on sait de vous, ou d'un collègue, en tant que personne.

Profils

Un profil est l'espace où vit votre mémoire, en général un par projet : le contexte du dépôt d'un client n'apparaît ainsi jamais dans votre projet personnel. L'agent choisit le profil d'après le dossier dans lequel il tourne. Plusieurs dossiers peuvent partager un même profil ; un dossier qui ne correspond à aucun profil reçoit le sien. Presque tout ce qui suit appartient à un profil. Voir profils.

Faits

Le cœur de votre mémoire : un fait court par enregistrement, jamais un pavé de texte collé. Un fait se suffit à lui-même ou est tiré d'un document de connaissances, et il a un statut : vérifié, non vérifié, ou prévu.

• L'historique est conservé : quand vous corrigez un fait, l'ancienne version reste dans l'historique et la nouvelle devient le fait en vigueur.
• Pas de doublons : un nouveau fait est comparé à ce qui est déjà enregistré, pour que la même chose ne soit pas enregistrée deux fois.

Un fait peut aussi porter sur une personne : vous, ou un collègue avec qui vous travaillez. C'est ce qui alimente les personas : ce que l'on sait de vous arrive au début de la session, et l'agent est orienté vers le profil d'un collègue quand un prompt le concerne.

Connaissances

Les documents de référence plus longs : procédures, documentation, notes d'infrastructure. Un document de connaissances garde son texte complet, découpé en sections pour que le rappel puisse désigner le passage utile plutôt que le fichier entier. Les faits tirés d'un document renvoient vers lui : le fait court est trouvé en premier, et le document complet n'est qu'à une étape quand il vous en faut davantage. Voir documents de connaissances.

Actions

Une action garde la trace de ce qui s'est passé : une correction, un déploiement, une pull request, l'exécution d'une de vos commandes, ou une discussion avec vous. Le plugin enregistre automatiquement le travail d'une session, et l'agent peut lui-même consigner une action en résumant ce qui a été fait ou discuté, ce qui a été envisagé et pourquoi, et ce qui reste en suspens. C'est grâce aux actions qu'une nouvelle session découvre ce que les sessions précédentes ont déjà fait et reprend le fil là où il s'était arrêté.

Sujets

Un sujet suit un problème récurrent ou un chantier dans la durée : le même problème vient enrichir un seul sujet au lieu de créer des doublons. Un sujet de type tâche a une priorité et un statut, et apparaît sur le tableau kanban du tableau de bord. Le rappel ne renvoie pas de sujets ; l'agent peut se voir proposer des sujets liés, sous forme de liens qu'il peut ouvrir. Voir sujets.

Règles

Les règles sont les consignes que vos agents doivent suivre (« fais toujours X »). Un agent peut proposer une règle, mais vous seul pouvez l'approuver : rien ne devient une règle tout seul.

Chaque règle porte des conditions qui disent quand elle s'applique. Certaines sont vérifiées par Neuronz.ai lui-même (l'outil sur le point de s'exécuter, le fichier en cours de modification) ; d'autres ne peuvent être jugées que par l'agent dans la session (« quand la commande touche la production »). Une règle dont les conditions ne sont pas remplies est laissée de côté.

Ce qui parvient à l'agent, c'est le nom de la règle, avec l'appel qui permet d'en récupérer le texte, jamais le texte lui-même. Cela se produit à chaque prompt et, dans Claude Code, aussi juste avant un appel d'outil concerné par une règle. Voir règles.

Rappel

C'est ainsi que le bon contexte parvient à l'agent. À chaque prompt, Neuronz.ai cherche dans vos faits, vos actions et vos connaissances ce qui correspond à ce que vous venez de demander. Ce qui arrive est un pointeur : le nombre d'enregistrements trouvés, et l'appel qui permet de les lire. L'agent lit ensuite ceux dont il a besoin. Votre voix arrive de la même façon. Voir rappel automatique.

• Mots-clés et sens : les deux types de recherche tournent ensemble, si bien que le rappel trouve le bon enregistrement même quand la formulation diffère.
• Reclassement : les résultats sont réordonnés selon leur adéquation au prompt.
• Enregistrements liés : quand l'agent lit ce qui a été trouvé, le rappel suit aussi une étape du graphe pour récupérer les enregistrements étroitement liés.

Le graphe

Les enregistrements sont liés entre eux : un fait tiré d'un document de connaissances, une action qui a corrigé un sujet, et ainsi de suite. Le rappel s'appuie sur ces liens pour atteindre le document plus long derrière un fait court, uniquement quand c'est nécessaire. Voir le graphe de connaissances.

Pour aller plus loin

• Voix : conserve la façon dont vos textes doivent se lire selon les situations et l'applique à vos brouillons.
• Skills et ressources : des skills, des commandes et des agents enregistrés dans Neuronz.ai et placés dans vos projets au début de chaque session.

Et ensuite

• Toutes les fonctionnalités : une page détaillée par fonctionnalité.
• Outils MCP : les outils qui lisent et écrivent tout cela.