Files
Support-Agent/vues-deplacements/contexte/events-learner.md
T
maximeandClaude Opus 5.5 7fb176cf0a Events-learner: the analyst writes its own tools, a tool-builder brings them into agent-tools; /aiguiser retired (D-097)
- inventaire.py: what each source contains on the window (filled or empty columns, metric names, images), names and counts only
- analyser-lot: step 0 on the data, own scripts in <lot>/outils/, section 3 "Outils"
- tool-builder (the optimiser, rewritten): after the analyst, optimises or adds reading tools, never removes; no control yet
- /aiguiser skill, reader, corrector and voir.py removed; its sessions and spec stay as history
- docs: D-097, specs, CLAUDE.md, run.md, README, plan point 56; the shared files also carry another session's pending edits (D-096 entry, plan points 57 to 67)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-29 17:10:17 +01:00

9.6 KiB

events-learner : conception

Point 31 du plan docs/superpowers/plans/2026-10-23-journal-du-matin.md, brainstorming du 2026-10-24, d'abord sous le nom /boucle ; approuvée par l'utilisateur le 2026-10-24, rôles revus le 2026-10-29 (points 51 à 55 du plan, D-087 à D-092) ; les outils de lecture y entrent le même jour, avec le tool-builder, et /aiguiser se retire (point 56, D-097). Ce qui vient de l'utilisateur est dit « l'utilisateur » ; le reste est un choix de Claude, marqué (choix de Claude).

Cette page dit pourquoi le processus est ainsi. Comment il tourne est écrit une seule fois, ailleurs : le déroulé dans le skill .claude/skills/events-learner/SKILL.md, chaque rôle dans sa consigne, .claude/agents/<agent>.md. Ne pas les recopier ici.

1. Pourquoi

L'utilisateur veut que Claude apprenne sur des lots entiers de données de stations, sans lui : passer les détecteurs du journal du matin sur un lot, juger leurs résultats comme le ferait un expert, en regardant lui-même les courbes et les images, corriger les détecteurs, et garder sous forme d'events tout ce qui est nouveau.

À la fin d'une séance, il reste trois choses durables (l'utilisateur) :

  1. de la connaissance : de nouveaux events, appris sur des événements réels, de la même forme que ceux de la base, dans la même base, events/ (l'utilisateur) ;
  2. des détections optimisées : des détecteurs mieux réglés ;
  3. des outils de lecture meilleurs (D-097) : ceux dont l'analyste s'est servi, ou qu'il a dû écrire, optimisés ou ajoutés à agent-tools/. Seul l'analyste sait ce qui est pertinent dans les données : c'est son travail réel qui guide les outils (l'utilisateur, 2026-10-29), et non un lecteur à part qui en extrait tout sans savoir ce qui compte (/aiguiser, retiré).

2. Buts, non-buts, ce qui serait un échec

Buts. Une commande lance une séance sur une station ; elle tourne seule jusqu'au bout ; tout ce qu'elle fait est commité, étape par étape, pour s'y retrouver et revenir en arrière (l'utilisateur).

Non-buts.

  • Récupérer les données : la séance prend un dossier de station tel quel, au format de data/<STATION>/, qu'il vienne du pompage (extraction/pomper.py) ou de fichiers téléchargés à la main.
  • Les autres domaines (Energy, Storage, Cellular, Temperature) : les déplacements seulement.
  • L'agent de diagnostic (D-046) : il n'a de travail à aucun moment de la séance (l'utilisateur, 2026-10-24) ; elle ne touche pas à ses consignes et ne fait que compléter la base d'events.
  • L'exhaustivité : pas de rejeu des lots déjà vus, pas de revalidation générale après chaque modification ; on explore et on améliore peu à peu (l'utilisateur). Le score rejoue les lots d'avant sur leurs étiquettes, sans regard de Claude.
  • Mesurer les progrès de l'analyste (l'utilisateur, 2026-10-29, D-088).

Ce qui serait un échec.

  • La complexité : des détecteurs qui gonflent de règles et de cas particuliers pour un petit gain (la crainte de l'utilisateur) ; de même des outils de lecture qui grossissent sans servir, risque que le tool-builder, qui ne retire rien et n'a pas de contrôle (D-097), laisse ouvert : à observer.
  • Le sur-apprentissage : des détecteurs collés au lot courant, qui perdent en précision sur les events de la base (l'utilisateur, 2026-10-29, D-089).
  • Toucher aux events validés ou aux catégories du journal, validées (choix de Claude).
  • Un détecteur cassé qui disparaît sans bruit : le chargeur de categories.py saute, avec un simple message, un fichier qui ne se charge pas (constaté dans le code).

3. Les principes

  • Un agent, une responsabilité (l'utilisateur, 2026-10-29, D-090) :

    Agent Sa seule responsabilité Ce qu'il ne voit pas Décisions
    analyste (skill analyser-lot) l'analyse la plus précise du lot, la vérité ; tous les outils, détecteurs et base d'events compris, et ses propres scripts ; il dit les outils dont il s'est servi le code des détecteurs, les autres séances D-088, D-090, D-097
    tool-builder optimiser ou ajouter des outils de lecture d'après ceux dont l'analyste s'est servi ; ne rien retirer : un seul lot ne suffit pas (l'utilisateur) les détecteurs D-097
    detectors-critic juger les détecteurs face à l'analyse : quoi et où les données D-090
    detectors-upgrader adapter les détecteurs (ajouter, retirer, modifier), le plus simple d'abord — D-089
    detectors-control le garde-fou contre le sur-apprentissage ; il décide le lot (données, critique, score) D-089
    event-builder décider ce que le lot apprend de nouveau à la base d'events, et en faire des events bornés à l'événement — D-091

    Le releveur et l'améliorateur (D-060, D-071) sont communs à tous les processus automatiques, pas propres à celui-ci.

  • L'orchestrateur ne juge rien : il lit les lignes de verdict, transmet les chemins et commite (choix de Claude). C'est un skill, lancé dans la conversation principale, parce qu'un sous-agent ne peut pas lancer d'autres sous-agents.

  • Les agents ne se parlent pas (choix de Claude, accepté le 2026-10-24) : chacun reçoit un prompt court (dossier, dates, chemins à lire), écrit son rendu dans le dossier de la séance et répond en quelques lignes.

  • Tout est commité sur master, par chemin, une étape par commit (l'utilisateur ; D-070) ; l'utilisateur annule ce qu'il ne garde pas par git revert.

  • Sans question : la séance tourne seule ; un rendu absent va au bilan (choix de Claude).

  • L'utilisateur pilote les lots (2026-10-24) : avec les données en masse, on ne traitera pas tout ; la plage est le lot (D-072), une séance par plage choisie.

  • Les agents prennent le modèle et l'effort de la session (model: inherit, D-063).

4. Les mesures

  • Le score (D-062) : les détecteurs face aux étiquettes de l'analyste, mesure par mesure, sur ce lot et les lots d'avant de la station. Un contrôle pour le detectors-upgrader, pas un but (D-089) : l'alignement n'a pas à être parfait. Choix de Claude, laissés par l'utilisateur : un compte par mesure plutôt que par événement, par capteur, trois niveaux de validité.
  • Le benchmark (D-069) : les détecteurs face au diagnostic gardé dans chaque event de la base, ses cas de régression ; c'est sur lui seul que juge le detectors-control. Une hausse est un plus, pas un but : sur une dizaine d'events, les détecteurs se régleraient sur eux (l'utilisateur). Le benchmark de fin des détecteurs est celui de la dernière modification gardée, sur les mêmes events que celui du début ; les events créés pendant la séance se mesurent à la suivante (D-092). Limite : un event appris ne contient que l'événement ± 6 h, sans les 3 jours d'historique d'un lot.
  • Les étiquettes de l'analyste (D-061) ne dépendent pas des modifications des détecteurs : ce sont aussi les labels d'un futur modèle appris (point 44 du plan), à garder même si une modification est annulée.

5. Ce que l'utilisateur trouve à la fin

Les commits de la séance ; bilan.md (le lot, les outils modifiés, la modification gardée ou non, les events créés, les contradictions avec la base, les erreurs) ; les difficultés du processus dans docs/ameliorations-processus.md ; la page out/events-learner_<séance>.html (D-066), la lecture de l'analyste au-dessus des événements des détecteurs, catégorie par catégorie. Le but, séance après séance : que les deux coïncident. Les events appris attendent sa revue par /review-event.

6. Essai et séances

Essai du 2026-10-24 : l'analyste seul sur le lot 1 de NORDEND d'octobre (05/10 → 09/10) : verdict « suggestions » (deux : une référence rejetée qui fausse la compensation de toutes les cibles, fondue dans un épisode au lieu d'être grisée ; un nombre de capteurs faux dans la phrase de la buée), une nouveauté (halo sur la vitre sous PR17 au saut du 08/10 02:30, cause non établie), la buée du 07/10 au 08/10 retrouvée ; 53 appels d'outils, ~250 000 jetons, 8 min 30 (Opus, effort élevé ; les images pèsent le plus). Fonctionnement validé par l'utilisateur le 2026-10-24.

Séances : lancées par l'utilisateur seul ; six du 2026-10-26 au 2026-10-27, dans events-learner/, avec les rôles d'avant le 2026-10-29. Les rôles revus (points 51 à 54 du plan) attendent leur première séance.

Annexe : pistes à revoir

  • Un contrôle du tool-builder (sur le diff des outils, sans le lot), si les outils grossissent sans servir : l'utilisateur ne sait pas encore comment le faire (D-097).
  • Un audit indépendant de la lecture commune (donnees.py), par des scripts qui ne passent pas par elle, comme le correcteur de /aiguiser qui a trouvé l'erreur des rejets des références : de temps en temps, ou quand donnees.py change.
  • Plusieurs analystes en parallèle : les lots sont indépendants ; le detectors-upgrader reste seul, pour que deux agents ne modifient jamais le même détecteur.
  • Le rejeu sur les lots déjà vus (écarté le 2026-10-24 : trop lourd, pas exhaustif voulu).
  • Un plafond de lots ou de coût par séance ; plusieurs stations par séance.
  • La durée : ~8 min 30 par lot pour l'analyste seul. Leviers : son effort, moins de vignettes (risque de rater un événement court).
  • Le choix des lots parmi beaucoup de données (l'utilisateur : « on verra comment on fait ») ; le pompage en masse (points 27 à 29 du plan).
  • Le lot unique numéroté lot-01 (vestige du découpage en lots, D-072) : le retirer toucherait trois scripts et la lecture des séances passées.