Ingestion

Ces outils font entrer de l'information dans la mémoire : une capture libre (mem), une note, un principe, un objectif, une fiche de personne, un document local, un fait de carte de codebase.

Tous écrivent. Chacun dépose son atome dans sa zone : 00-inbox/ pour mem et mem_doc, 20-knowledge/ pour les notes, 40-principles/, 50-goals/, 60-people/. Pour mem_note, une collision de nom se résout par un suffixe, jamais par un écrasement.

Pour les demander en parlant à votre agent, voir Écrire dans la mémoire.

En pratique

Vous demandez à l’agent

« Note ceci : « Le fragment scellé ne se modifie jamais à la main. » »

→ L’agent appellemem_note

• title = Fragment scellé
• content = Le fragment scellé ne se modifie jamais à la main.

Vous demandez à l’agent

« Retiens ce principe, une ligne rouge : on ne documente que ce que le code soutient. »

→ L’agent appellemem_principle

• title = Ne documenter que ce que le code soutient
• content = Une affirmation que le catalogue ou le code ne soutient pas n'a pas sa place dans la référence.
• force = red-line

Vous demandez à l’agent

« Ajoute un objectif à court terme : publier la documentation d'ici le 2026-12-01. »

→ L’agent appellemem_goal

• title = Publier la documentation
• horizon = short
• deadline = 2026-12-01

Vous demandez à l’agent

« Crée la fiche de Claire Martin, cliente. »

→ L’agent appellemem_person

• name = Claire Martin
• relation = client

Vous demandez à l’agent

« Absorbe ce document dans la mémoire : /Users/ben/Documents/cahier-des-charges.pdf. »

→ L’agent appellemem_doc

• path = /Users/ben/Documents/cahier-des-charges.pdf
• title = Cahier des charges

Les outils

mem

Capture universelle dans 00-inbox/, quand la nature du contenu n'est pas précisée. Un indice de type oriente le classement ultérieur.

Paramètre / Parameter	Type	Requis / Required	Description (catalogue)
content	string	oui / yes	Texte ou Markdown à capturer.
hint	string	non / no	Indice de type : note, principle, goal, person ou idea.

mem_note

Ingère une note de connaissance dans 20-knowledge/. Une collision de nom est résolue par un suffixe, jamais par un écrasement.

Paramètre / Parameter	Type	Requis / Required	Description (catalogue)
content	string	oui / yes	Corps Markdown de la note.
project	string	non / no	Projet de rattachement.
scope	string	non / no	work (défaut), personal ou all.
title	string	oui / yes	Titre de la note, qui sert de slug.

mem_principle

Ingère un principe dans 40-principles/{scope}/, avec sa force : red-line, heuristic, value ou action-rule.

Paramètre / Parameter	Type	Requis / Required	Description (catalogue)
content	string	oui / yes	Corps Markdown : raison d'être, quand l'appliquer.
force	string	non / no	red-line, heuristic (défaut), value ou action-rule.
project	string	non / no	Projet de rattachement.
scope	string	non / no	work (défaut), personal ou all.
title	string	oui / yes	Titre court du principe.

mem_goal

Ingère un objectif dans 50-goals/{horizon}/, avec son horizon, son statut et son échéance éventuelle.

Paramètre / Parameter	Type	Requis / Required	Description (catalogue)
content	string	non / no	Corps Markdown facultatif.
deadline	string	non / no	Échéance au format AAAA-MM-JJ.
horizon	string	non / no	short (défaut), medium ou long.
project	string	non / no	Projet de rattachement.
scope	string	non / no	work (défaut), personal ou all.
status	string	non / no	open (défaut), in-progress, done ou abandoned.
title	string	oui / yes	Titre de l'objectif.

mem_person

Ingère une carte de personne dans 60-people/{relation}/. La carte est marquée sensible par défaut.

Paramètre / Parameter	Type	Requis / Required	Description (catalogue)
name	string	oui / yes	Nom complet, qui sert de slug.
notes	string	non / no	Notes libres.
project	string	non / no	Projet de rattachement.
relation	string	non / no	colleague (défaut), client, friend, family ou other.
role	string	non / no	Fonction ou intitulé de poste.
scope	string	non / no	work (défaut), personal ou all.
sensitive	boolean	non / no	Marquer la carte sensible (vrai par défaut).

mem_doc

Ingère un document local dans 00-inbox/. Formats lus : Markdown, texte, PDF, DOCX, XLSX, PPTX, HTML et CSV.

Paramètre / Parameter	Type	Requis / Required	Description (catalogue)
path	string	oui / yes	Chemin absolu du document local.
project	string	non / no	Projet de rattachement.
scope	string	non / no	work (défaut), personal ou all.
title	string	non / no	Titre. Défaut : le radical du nom de fichier.

mem_codebase

Inscrit à la carte d'une codebase un fait que le code ne dit pas de lui-même : ce qui a le droit de traverser quelle couche, un invariant qui tient, un piège déjà payé, une décision qui explique une forme surprenante. À APPELER SUR LE MOMENT, quand tu viens de comprendre quelque chose de coûteux — une demi-heure plus tard le fait est acquis et ne paraîtra plus digne d'être écrit. Consulte d'abord mem_codebase_scan : ses candidats non décrits nomment les fichiers que la carte attend. L'entrée cite les fichiers qu'elle décrit et leurs empreintes sont relevées au disque, ce qui permettra de la déclarer périmée quand ils bougeront. Refusée si elle ne cite aucun fichier sans dire pourquoi.

Paramètre / Parameter	Type	Requis / Required	Description (catalogue)
aliases	array<string>	non / no	Les mots par lesquels un humain cherchera plus tard, en langue VÉCUE et non technique.
body	string	oui / yes	Pourquoi c'est vrai, et ce que coûte de l'ignorer.
describes	array<string>	non / no	Chemins RELATIFS à la racine du dépôt que cette entrée décrit. Leurs empreintes sont calculées ici en lisant les fichiers — ne les fournis pas. Un chemin absent est refusé : l'entrée naîtrait périmée.
fact	string	oui / yes	LE FAIT, écrit comme il se dit : « la CI ne couvre pas release-kit », jamais « ci ». Il nomme l'atome et c'est par lui qu'on le retrouvera.
project	string	oui / yes	Slug du projet dont il est question.
unmeasurable_because	string	non / no	Obligatoire SI et seulement si describes est vide : pourquoi ce fait ne se rattache à aucun fichier. Un interdit de conception, par exemple. Sans lui ni describes, l'entrée est refusée.