Qu’est-ce qui mérite d’être retenu ?

Prenons une conversation terminée avec un agent. Elle contient des exigences, quelques fausses pistes, une correction de l’utilisateur et ce qui a finalement fonctionné. Tout sauvegarder est facile. Décider de ce qu’une autre session devrait en recevoir demande davantage de réflexion.

Je commencerais par un seul travail avant d’en faire une habitude d’entreprise. Gardons la conversation d’origine accessible. Puis écrivons la plus petite note qui aurait aidé quelqu’un face à la même difficulté.

Le premier essai ressemble souvent à « vérifier les données soigneusement » ou « s’assurer que les permissions sont correctes ». Cela sonne comme un enseignement parce que le travail a été pénible. Mais en lisant la phrase sans se rappeler l’incident, il devient difficile d’en tirer une action. Une collègue compétente avait probablement déjà l’intention de faire les deux. Le détail utile se trouve généralement un peu plus loin.

Placer la note à côté d’une vraie décision

Voici un incident hypothétique pour travailler. Un agent modifie un enregistrement et le rend accidentellement visible à un groupe plus large. L’application dispose d’un champ qui définit le public autorisé, mais le chemin de correction n’a pas conservé celui de l’enregistrement source.

« Faire attention aux accès » conserverait l’impression laissée par l’incident. Une note plus exploitable dirait de vérifier qu’une correction reprend le public autorisé existant quand aucun nouveau public n’est fourni.

La note désigne maintenant une décision concrète : que doit-il se passer quand l’appelant ne renseigne pas ce champ ? Elle suggère aussi une vérification observable. Un test peut créer un enregistrement partagé avec un groupe restreint, le corriger sans changer son public autorisé, puis examiner qui peut lire le résultat.

L’exemple est illustratif. Le principe vient de la discipline d’apprentissage conservée dans Mana : retenir un enseignement qui change une décision future, et rendre la stratégie assez concrète pour qu’un lecteur puisse l’appliquer sans reconstituer l’incident initial.

Cela donne à la personne qui relit une question utile. Si quelqu’un lit cette note demain, que fera-t-il différemment ?

Conserver la limite de l’enseignement

Raccourcir une phrase comporte un risque. « Les corrections doivent préserver les accès » paraît net, mais que se passe-t-il si l’appelant souhaite explicitement restreindre le public ? L’incident initial concernait un champ omis. En retirant ce détail, l’enseignement commence à gouverner des situations qu’il n’expliquait pas.

La note a besoin de son périmètre. Elle doit aussi distinguer ce qui a été observé de ce qui semble seulement probable. Un défaut dans un chemin de correction ne prouve pas que chaque import, export ou résumé présente le même problème.

C’est la même question que dans la réponse qui était juste autrefois, vue au moment où la connaissance est consignée pour la première fois. Une phrase circule plus sûrement lorsque le lecteur suivant peut voir les conditions qui l’ont rendue utile.

Il n’y a rien à gagner à exprimer chaque enseignement comme une règle universelle. Une instruction précise qui évite une erreur récurrente peut mériter d’être conservée. Un grand principe dont le lecteur doit lui-même fournir le sens peut n’ajouter que peu de valeur.

La confier à quelqu’un qui n’a pas vu l’incident

Avant d’ajouter la note aux consignes partagées, imaginons la donner à une collègue qui n’a rien vu de la conversation. Mieux encore, faisons l’essai avec une personne ou un nouvel agent, sur un petit exemple artificiel. Demandons ce que la note lui dit de vérifier et dans quels cas elle s’applique.

N’expliquons pas d’abord la réponse attendue. Si son interprétation diffère, la formulation n’a pas encore réussi à transmettre l’enseignement au-delà du contexte d’origine.

C’est un moyen pratique de révéler le contexte manquant. Il doit aussi laisser la possibilité de rejeter la note. Certains incidents conduisent à une tâche pour corriger un défaut précis, sans instruction réutilisable à ajouter. Certains enseignements proposés répètent des consignes déjà présentes. Garder les deux versions peut ajouter de la lecture sans ajouter de décision.

Le récit de ce qui s’est passé peut rester dans l’historique du projet. Le petit ensemble d’instructions transmis aux travaux futurs mérite une sélection plus exigeante.

La recherche fait partie de l’essai

Une fois la note stockée, essayons de la retrouver avec les mots qu’utiliserait quelqu’un qui rencontre le problème. Cherchons la tâche, l’incertitude ou l’effet, plutôt que le seul titre exact.

Si la note reste introuvable, elle n’aide pas encore le futur lecteur. Si elle apparaît dans des tâches sans rapport, sa formulation ou son périmètre est peut-être trop large. Si une ancienne version ressort après une correction, il faut examiner la recherche avant de compter sur le conseil le plus récent.

Mana fournit un espace partagé pour ces enregistrements et un moyen de les retrouver. Leur valeur dépend toujours de la qualité de l’enseignement consigné et de sa présence au moment où il compte. Une petite comparaison entre des tâches répétées peut en dire davantage que le nombre de souvenirs stockés.

Je terminerais l’exercice avec une seule note, plutôt qu’une conversation réécrite en manuel. Relisons-la après avoir pris de la distance avec l’incident. Peut-on encore identifier la décision, la vérification et la limite ?

Si oui, c’est une candidate raisonnable à la mémoire partagée. Sinon, l’expérience peut encore compter, mais son enseignement n’est pas encore transmissible.