- /boucle becomes /events-learner: skill and scripts in .claude/skills/events-learner/, sessions in events-learner/, spec vues-deplacements/contexte/events-learner.md, end page out/events-learner_<session>.html, commits "Learn <STATION> ..."; history keeps /boucle, the review page reads both. - No benchmark-fin.txt: the end benchmark is the last kept modification's, on the same events as the start. - The spec keeps only the why; the how lives in the skill and agents. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
8.2 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). 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 deux choses durables (l'utilisateur) :
- 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) ; - des détections optimisées : des détecteurs mieux réglés.
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).
- 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.pysaute, 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(skillanalyser-lot)l'analyse la plus précise du lot, la vérité ; tous les outils, détecteurs et base d'events compris le code des détecteurs, les autres séances D-088, D-090 detectors-criticjuger les détecteurs face à l'analyse : quoi et où les données D-090 detectors-upgraderadapter les détecteurs (ajouter, retirer, modifier), le plus simple d'abord — D-089 detectors-controlle garde-fou contre le sur-apprentissage ; il décide le lot (données, critique, score) D-089 event-builderdé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 pargit 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, 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
- Plusieurs analystes en parallèle : les lots sont indépendants ; le
detectors-upgraderreste 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.