Labels-learner: the analyst measures the expert's labels and asks until it understands, a documentaliste writes its conclusions into the docs (D-099, point 69)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-11-02 09:12:53 +01:00
1 parent 010798d992
commit d1fd7f6bdd
8 files changed
+212 -11

No files matched your search

+7
View File
@@ -978,3 +978,10 @@ Règles du journal :
- **Pourquoi** : l'utilisateur, 2026-10-30 : que l'analyste prenne connaissance des phénomènes sur des cas étiquetés par l'expert, en plus de ce qu'on lui explique (point 67) ; pas de catégorie pour ne pas borner, on en déduira après coup ; le but est d'avoir les étiquettes, pas une application. Constat de Claude : la seule vérité du projet était l'analyste (`score.py`, benchmark).
- **Options écartées** : l'étiquetage dans la page Status, avec les status des détecteurs, `error_value`, une température et une catégorie facultative (première proposition de Claude) : l'outil doit rester simple, le monitoring montre le reste ; le format de `etiquettes.json` : ses champs obligatoires (catégorie, preuve, capteurs) bornent, et un seul objet JSON se réécrit à chaque ajout.
- **Conséquence** : `score.py` ne lit pas ces étiquettes (pas de catégorie, et un instant sans étiquette n'y veut pas dire « rien vu »). Comment l'analyste s'en sert reste à décider, une fois assez d'étiquettes écrites (point 69 du plan : `/labels-learner` proposé). Une étiquette n'entre dans `events/` que par `/new-event` ou l'`event-builder`.
## D-099 — 2026-11-02 — Apprendre des étiquettes de l'expert : `/labels-learner`
- **Statut** : active, à l'essai ; point 69 du plan du journal du matin.
- **Décision** : un skill lancé par l'utilisateur, `/labels-learner <phénomène>`. L'orchestrateur retient avec lui au plus cinq étiquettes de `labeling/` sur ce phénomène ; l'agent `analyste`, sur une consigne à part (`.claude/skills/labels-learner/analyste.md`, pas `analyser-lot`), mesure dans les données ce que dit chacune (la signature : colonnes, capteurs, valeurs, ordre), les compare et pose ses questions à l'expert ; l'orchestrateur les relaie, l'analyste reprend avec les réponses, jusqu'à avoir compris (au plus trois tours), puis écrit ses conclusions. Un nouvel agent, le `documentaliste`, qui tient la documentation métier du projet, les fait entrer à leur place (chaîne de mesure, carte des événements, `lire-les-donnees`, `docs/domaine/`), sans doublon, avec leur source ; l'utilisateur relit le diff, puis commit. Rendus dans `labeling/lecons/<date>_<phénomène>/` (`etiquettes.jsonl`, `lecon.md`), versionnés.
- **Pourquoi** : l'utilisateur, 2026-10-30 : les étiquettes ne valent que si l'analyste en apprend, et apprendre, ici, c'est documenter ; 2026-11-02, sur ses 13 premières étiquettes : pas de lecture à l'aveugle, il n'en voit pas l'intérêt ; le texte des étiquettes suffit, pas de fiche de station. Le même jour, l'utilisateur : ce que l'analyste apprend doit être documenté ; il peut poser des questions, et quand il a tout compris, il passe ses conclusions à un agent de documentation, nouveau, dont le rôle est de maintenir la documentation du projet. Constat de Claude sur ces étiquettes : elles disent le mécanisme, et la mesure dans les données le précise (deux références acceptées donnent `reproj_err` = 0, une seule le laisse vide, à JUNGFRAU et NORDEND).
- **Options écartées** : des propositions présentées une à une à l'utilisateur, appliquées par l'orchestrateur (première version de Claude, le même jour) : les questions à l'expert tiennent lieu de validation, et la documentation a son agent ; la lecture à l'aveugle avant la confrontation (proposition de Claude, pour mesurer l'écart entre l'analyste seul et l'expert) : refusée par l'utilisateur ; une fiche de contexte par station (ouvrage, références) : le texte des étiquettes le dit ; un nouvel agent : l'analyste sait lire les données ; un document de leçons que l'analyste relirait : les acquis vont dans la chaîne de mesure, la carte et `lire-les-donnees` (point 67 : ne pas l'alourdir).
- **Conséquence** : le savoir entre par les réponses de l'expert et se relit au diff avant le commit ; une conclusion vue sur une seule station reste `[H]`. Le `documentaliste` est général : d'autres processus pourront lui passer leurs conclusions. La chaîne de mesure n'est pas encore lue par l'analyste de `/events-learner` (point 67) : ce qu'elle apprend ne l'atteint qu'ensuite. Ni détecteurs ni events ici : `/events-learner` et `/new-event`.