Remplir un profil

Un nouveau profil est vide au départ. /neuronzai:init-profile le remplit à partir des endroits où vos connaissances se trouvent déjà (dépôts, GitHub, Notion, documentation interne), pour que chaque agent qui travaille ensuite dans ce profil connaisse ce contenu comme un collègue présent depuis le début, sans rouvrir les sources.

Lancer la commande

Nommez les sources avec vos propres mots :

/neuronzai:init-profile analyse tout le dépôt billing ici et tout ce qu'il a sur GitHub, plus l'intégralité du wiki d'ingénierie Notion

Lancée sans argument dans un dépôt git, la commande analyse ce dépôt : son organisation, comment le compiler, le lancer et le tester, son architecture, ses conventions et ses pièges, son historique récent, et la documentation qu'il contient (README, CLAUDE.md, AGENTS.md, docs/). Elle n'écrit rien dans le dépôt : tout ce qu'elle apprend est enregistré dans Neuronz.ai. Lancée sans argument hors d'un dépôt, l'agent vous demande quoi lire.

Les enregistrements vont dans le profil qu'utilise la session. Pour remplir un profil tout neuf, créez-le d'abord avec /neuronzai:new-profile, qui vous propose cette commande une fois terminé.

Ce qu'elle fait

1. Elle vérifie d'abord les accès. Pour chaque source, l'agent s'assure qu'il peut l'atteindre : le serveur MCP ou l'outil en ligne de commande correspondant (GitHub, Notion, …) est installé et connecté. Une source inaccessible est signalée tout de suite avec ce qu'il lui faut, et les autres sont traitées.

2. Elle lit tout et enregistre ce qui compte. L'agent lit intégralement chaque source accessible et note ce qu'un collègue expérimenté saurait : ce qu'est le produit, qui est responsable de quoi, comment se passent les mises en production, les incidents et les revues, le vocabulaire interne, les décisions passées et leurs raisons, et les pièges. Il ne recopie pas les sources. Les états qui changent d'un jour à l'autre, comme le résultat d'un build ou l'état d'une pull request, sont laissés de côté. Les secrets (mots de passe, jetons, clés) ne sont jamais enregistrés, même quand une source en contient : l'enregistrement indique plutôt où ils se trouvent.

3. Elle range chaque chose au bon endroit :

   • les informations ponctuelles, y compris les termes du glossaire et les systèmes nommés, en faits ;
   • les procédures, processus, vues d'ensemble de l'architecture et une vue d'ensemble par dépôt en documents de connaissances ;
   • les collègues et les équipes sur la carte sociale, avec ce dont ils sont responsables et leur façon de travailler ;
   • chaque consigne que le contenu donne aux personnes qui y travaillent (« toujours… », « jamais… ») en règle proposée, en attente de votre approbation. Une phrase qui se contente de décrire le comportement du logiciel est enregistrée comme un fait.

   Chaque enregistrement se suffit à lui-même : un lien vers la source peut y être joint, mais le contenu est toujours rédigé en entier.

4. Elle découpe les grosses sources. Une source trop volumineuse pour être lue d'un coup est divisée en sections, lues chacune par un sous-agent qui rédige ses propres enregistrements selon les mêmes consignes. Les doublons entre sections sont fusionnés.

5. Elle vérifie le résultat par un quiz. L'agent rédige des questions à partir des sources (qui approuve une mise en production, ce que signifie un terme, pourquoi quelque chose a été abandonné, comment lancer les tests) et un nouveau sous-agent, sans accès aux sources, y répond à partir de Neuronz.ai seul. Chaque question manquée est une lacune que l'agent comble, et le quiz recommence jusqu'à ce que chaque question ait une réponse ou qu'il soit établi que les sources n'en donnent pas.

Elle écrit sans vous demander de valider chaque enregistrement. Les règles font exception : elles restent proposées jusqu'à ce que vous les approuviez.

Le compte rendu

Une fois terminé, l'agent vous indique :

• les sources qu'il a lues, et dans quelle mesure ;
• les sources qu'il a laissées de côté, pourquoi, et ce qui permettrait d'y accéder ;
• les enregistrements qu'il a rédigés, comptés par type ;
• le score du quiz, au premier passage et au dernier.

Relancer la commande

Relancer la commande sur les mêmes sources met le profil à jour. Chaque document de connaissances est rattaché à sa provenance : il est donc mis à jour sur place au lieu d'être dupliqué, et un fait qui a changé dans la source remplace l'ancien.

Voir aussi

• Profils — créer un profil et choisir les dossiers qui l'utilisent.
• Documents de connaissances — les documents que la commande rédige.
• Règles — approuver les règles qu'elle propose.
• Comparatif des outils (en anglais) — les harnais d'agent (harness) qui prennent en charge cette commande.