Ce que Claude a promis doit vivre hors de la conversation
Une promesse faite en conversation disparaît avec le contexte, après une compaction ou une nouvelle session ; un registre d'une tâche par fichier, avec un état et des règles de fermeture, la fait survivre ; les transcriptions de sessions, lues sans leur contenu, disent quelles sessions ont bougé.
Une promesse faite en conversation, « je m'en occupe », « je reviens vers vous », n'existe que tant que cette conversation reste dans le contexte. Après une compaction ou une nouvelle session, elle a disparu, et rien n'avertit l'assistant qu'elle était ouverte. Le remède est celui de la première leçon de ce module : écrire dans un fichier ce qui doit survivre.
Un fichier par tâche, un état par fichier
Le registre est un dossier : un fichier par tâche, avec une ligne d'état parmi ouverte, en-cours, livree, abandonnee, retiree, écrits ainsi, sans accent, dans les fichiers. Les trois derniers ferment la tâche. La démonstration crée ses données dans un dossier jetable :
mkdir -p registre && cd registre
printf 'etat: ouverte\ntitre: Relire le devis du fournisseur\n' > t001.md
printf 'etat: livree\npreuve: devis-relu.md\ntitre: Envoyer la synthèse\n' > t002.md
printf 'etat: abandonnee\ncitation: "laisse tomber le comparatif"\ntitre: Comparer trois offres\n' > t003.md
grep -L -E '^etat: (livree|abandonnee|retiree)' t*.md
t001.md
La commande liste les fichiers qui n'ont aucune ligne de fermeture : les tâches encore ouvertes ou en cours. Une tâche annoncée comme terminée en conversation, mais jamais fermée dans le registre, y reste visible : c'est voulu, car la fermeture exige une pièce.
Des règles de fermeture
- Un seul outil écrit dans le registre, sous verrou, pour que deux sessions ne s'écrasent pas, outil donné plus bas (un coffre partagé n'a pas d'édition concurrente).
- Une tâche ne sort que livrée, avec une preuve nommée, abandonnée, avec la citation de la personne qui a renoncé, ou retirée, avec le motif (doublon, saisie par erreur).
- Une tâche abandonnée ne revient pas parce qu'un nouveau titre ressemble à l'ancien.
- À la reprise, un crochet
SessionStartaffiche les tâches ouvertes avant la première demande.
Voici cet outil, en quelques lignes. mkdir échoue si le dossier existe déjà : un seul processus à la fois passe le verrou, les autres attendent. Un verrou resté après un plantage se retire à la main (rmdir .verrou). Rejoué sous Git Bash le 2026-11-16, il rend la sortie ci-dessous et la tâche reste listée par la commande précédente.
ecrire() { # ecrire t001.md en-cours
until mkdir .verrou 2>/dev/null; do sleep 1; done
sed -i "s/^etat: .*/etat: $2/" "$1"
rmdir .verrou
}
ecrire t001.md en-cours && cat t001.md
etat: en-cours
titre: Relire le devis du fournisseur
Suivre l'activité depuis les transcriptions
Les conversations sont enregistrées en clair dans projects/<projet>/<session>.jsonl, dans le dossier de configuration de Claude Code, et conservées 30 jours par défaut (documentation officielle, consultée le 2026-11-16). Un outil en lecture seule peut dire quelles sessions ont bougé sans afficher leur contenu :
mkdir -p projets/a
echo '{"type":"user"}' > projets/a/active.jsonl
echo '{"type":"user"}' > projets/a/ancienne.jsonl
touch -t 202601010000 projets/a/ancienne.jsonl
find projets -name '*.jsonl' -mmin -10
projets/a/active.jsonl
Le format interne de ces lignes n'est pas garanti d'une version à l'autre. Limitez l'outil à ce qui n'en dépend pas, le nom du fichier et sa date de modification.
Le cycle d'une tâche dans le registre
Une coordinatrice demande à son assistant, un vendredi, de préparer la relance de trois fournisseurs. Le lundi, dans une nouvelle session, l'assistant n'a plus aucun souvenir de cette demande. Elle ouvre le dossier du registre, qui contient trois fichiers, et lance la commande qui cherche les fichiers n'ayant pas de ligne de fermeture : elle liste deux noms. Elle relance l'assistant sur ces deux tâches.
Écrivez en une phrase ce que cette situation établit, et en une phrase ce qu'elle n'établit pas.
Ce que cela établit : Elle établit que, d'après les lignes d'état du registre, deux des trois tâches n'ont pas de ligne de fermeture, et que la relance du lundi repose sur un fichier plutôt que sur la mémoire de la conversation.
Ce que cela n’établit pas : Elle n'établit pas que ces deux tâches restent réellement à faire, car une tâche terminée dont l'état n'a pas été mis à jour apparaîtrait aussi, ni que la troisième ait été menée à bien sans lire sa pièce de fermeture.
Les trois calibrages faux les plus courants
- Trop large Ce registre garantit qu'aucune promesse de l'assistant ne se perd, quelle que soit la façon dont les tâches y sont écrites.
- Trop étroit La commande a seulement affiché deux noms de fichiers, sans rien dire des tâches.
- À côté Cette situation montre que l'assistant est peu fiable puisqu'il a oublié une demande en changeant de session.
- Une promesse faite en conversation disparaît avec le contexte, après une compaction ou une nouvelle session : ce qui doit survivre s'écrit dans un fichier.
- Un fichier par tâche, avec une ligne d'état, permet de retrouver les tâches ouvertes par une seule recherche des fichiers sans ligne de fermeture.
- Une tâche ne sort du registre que livrée avec une preuve, abandonnée avec la citation de la personne ou retirée avec un motif, et une tâche abandonnée ne revient pas parce qu'un titre y ressemble.
- Les transcriptions situent l'activité des sessions, mais leur format est interne : lisez le nom et la date, pas le contenu.
Dans un dossier temporaire, créez trois fichiers d'état comme ci-dessus, lancez la commande grep -L et vérifiez qu'elle ne rend que la tâche non fermée.
Ces points dépendent d’une interface ou d’une règle qui peut avoir changé depuis la rédaction. Vérifiez-les sur votre propre écran avant de vous y fier.
- Reproduisez la démonstration dans un dossier temporaire : la commande doit rendre un seul fichier, celui sans ligne de fermeture. Changez l'état d'un autre fichier pour le rouvrir et relancez.
Chaque affirmation datable de cette leçon renvoie ici au texte public qui la porte. Une source qui ne s’ouvre pas ne prouve rien.
- Claude Code, documentation du dossier de configuration : transcriptions et durée de conservation consultée le 2026-11-16
- Journal de Claude Code : crochets SessionStart consultée le 2026-11-16