Loop: the builder becomes the event-builder, called every batch (D-091)

- event-builder: called at every batch, reads the whole analysis and
  decides on its own, against the event base, what is new; an event
  keeps the bounds of the event, not of the batch (plus 6 h).
- the "Nouveautés" section leaves the analysis and the upgrader's
  output; the summary lists contradictions with the base.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-29 10:17:54 +01:00
1 parent c763cda5c3
commit 79d83be3ff
20 files changed
+129 -98

No files matched your search

+1 -1
View File
@@ -22,7 +22,7 @@ Détection mécanique des anomalies (D-055) : faire ressortir les courbes qui co
Journal du matin du client (D-056), le cap actuel : onglet `Journal` de la maquette ; un détecteur élémentaire par fichier dans `detectors/` (`detect(mesures)` -> épisodes `start`, `end`, `kind`, `label`, `text`, `ignore`, `sensors`), chargés et classés en événements des douze catégories du journal (D-074) par `detectors/categories.py` (`python3 detectors/categories.py <dossier>` : une ligne par événement), que `explore.py` affiche ; brainstorming et pistes dans `contexte/journal-du-matin.md`, registre des seuils provisoires dans `contexte/seuils-du-journal.md`, lissage dans `contexte/lissage.md`, données en masse et boucle Claude dans `contexte/donnees-et-boucle.md`.
Boucle automatique (D-057), lancée par l'utilisateur seul, sur les lots qu'il choisit : `/boucle <dossier de station> [--du … --au …]` fait analyser chaque lot par un analyste, juger les détecteurs du journal face à son analyse par un detectors-critic (D-090), les fait corriger par un detectors-upgrader, contrôlé sur la base d'events par un detectors-control (D-089), et ajoute les nouveautés à la base d'events par un builder ; une séance commitée directement sur `master` (D-070), ses rendus dans `boucle/<séance>_<STATION>/lot-NN/` (dont les étiquettes de l'analyste, `etiquettes.json`, D-061, et `score-avant.txt`, le score des détecteurs face à toutes les étiquettes, D-062) et son `bilan.md`, hors de tout dossier de station ; en fin de séance, la page `out/boucle_<séance>.html` montre l'analyste face aux détecteurs (D-066) ; à chaque lot et après chaque modification, le benchmark des détecteurs sur la base d'events (`.claude/skills/boucle/benchmark.py`, historique dans `benchmark/historique.csv`, D-069) ; avec `--ameliorer`, l'améliorateur corrige ensuite le skill et ses agents d'après les relevés du releveur (D-071) ; spec `contexte/boucle-automatique.md`.
Boucle automatique (D-057), lancée par l'utilisateur seul, sur les lots qu'il choisit : `/boucle <dossier de station> [--du … --au …]` fait analyser chaque lot par un analyste, juger les détecteurs du journal face à son analyse par un detectors-critic (D-090), les fait corriger par un detectors-upgrader, contrôlé sur la base d'events par un detectors-control (D-089), et fait décider par un event-builder ce que le lot apprend de nouveau à la base d'events (D-091) ; une séance commitée directement sur `master` (D-070), ses rendus dans `boucle/<séance>_<STATION>/lot-NN/` (dont les étiquettes de l'analyste, `etiquettes.json`, D-061, et `score-avant.txt`, le score des détecteurs face à toutes les étiquettes, D-062) et son `bilan.md`, hors de tout dossier de station ; en fin de séance, la page `out/boucle_<séance>.html` montre l'analyste face aux détecteurs (D-066) ; à chaque lot et après chaque modification, le benchmark des détecteurs sur la base d'events (`.claude/skills/boucle/benchmark.py`, historique dans `benchmark/historique.csv`, D-069) ; avec `--ameliorer`, l'améliorateur corrige ensuite le skill et ses agents d'après les relevés du releveur (D-071) ; spec `contexte/boucle-automatique.md`.
Aiguiser la lecture (D-059), lancé par l'utilisateur seul, sur les lots qu'il choisit : `/aiguiser <dossier de station> [--du … --au …]` améliore les outils de lecture (`agent-tools/`) et leur mode d'emploi, le skill `lire-les-donnees`, que suivent l'analyste et l'agent de diagnostic : un lecteur lit le lot avec le skill, un correcteur le lit à fond avec ses propres scripts et mesure l'écart, un optimiseur modifie le skill, un changement sans gain est annulé ; commandes des fiches lancées en fin de séance (D-064) ; une séance commitée directement sur `master` (D-077), ses rendus dans `aiguiser/<séance>_<STATION>/lot-NN/` et `bilan.md`, hors de tout dossier de station ; avec `--ameliorer`, l'améliorateur corrige ensuite le skill et ses agents d'après les relevés du releveur (D-076) ; spec `contexte/aiguiser-la-lecture.md`.
@@ -48,7 +48,7 @@ L'analyste, le detectors-critic et le detectors-control ne laissent rien de dura
2. **Detectors-critic** : il compare les détecteurs à l'analyse et écrit `critique.md`. Commit. Verdict « d'accord » : on passe à l'étape 5.
3. **Detectors-upgrader** : il adapte les détecteurs et écrit `modification-K.md` (K : numéro du passage). Commit.
4. **Detectors-control** : il juge la modification sur la base d'events, sans regarder le lot, et écrit `validation-K.md`, « accepté » ou « à reprendre ». Commit. « À reprendre » : retour à l'étape 3, le detectors-upgrader lit ce contrôle. Au plus trois passages du detectors-upgrader *(choix de Claude)* : au troisième contrôle, le detectors-control n'a plus que deux réponses, « garder » (ça va dans le bon sens) ou « annuler » (l'orchestrateur annule par `git revert` les commits de détecteurs du lot).
5. **Builder** : s'il y a des nouveautés dans les rendus du lot, il ajoute les events à la base, `events/`, et écrit `builder.md`. Un commit pour les events du lot (ils partagent la ligne d'index).
5. **Event-builder** : à chaque lot, il décide, face à la base d'events, ce que l'analyse lui apprend de nouveau ; il en fait des events, `events/`, et écrit `builder.md`. Un commit pour les events du lot (ils partagent la ligne d'index).
Le lot suivant tourne avec les détecteurs tels qu'ils sont devenus. À la fin, l'orchestrateur écrit `bilan.md` (§6) et le commite.
@@ -71,9 +71,8 @@ Une seule responsabilité depuis le 2026-10-29 (l'utilisateur, D-090) : l'analys
1. **Sa lecture**, avec tous les outils à sa disposition : outils de lecture (`lire-les-donnees`), images, la carte, la base d'events quand il veut (D-088) et la sortie des détecteurs quand il veut (D-090) ; un event connu ou un événement des détecteurs est une piste à vérifier sur les données, pas une conclusion. Il note chaque moment : début, fin, capteurs, ce qu'il voit, la catégorie de la carte qui conviendrait, ou « aucune catégorie ».
2. **Ses étiquettes**, une par moment.
3. **Events connus** : les events de la base proches de ses moments.
4. **Nouveautés** pour le builder : ce que ni la carte ni l'index ne décrivent, avec le moment, les capteurs et la figure qui le montre.
`analyse.md` reprend ces parties ; ses figures sont dans le dossier du lot. Avant D-090, l'analyste lisait sans les détecteurs, puis les comparait lui-même et rendait la critique : `critique.md` des séances d'avant porte les deux.
`analyse.md` reprend ces parties (avant D-091, aussi les nouveautés, pour le builder) ; ses figures sont dans le dossier du lot. Avant D-090, l'analyste lisait sans les détecteurs, puis les comparait lui-même et rendait la critique : `critique.md` des séances d'avant porte les deux.
### Detectors-critic : `.claude/agents/detectors-critic.md`
@@ -88,7 +87,7 @@ Il juge les détecteurs face à l'analyse, la vérité (l'utilisateur, 2026-10-2
**Score** (D-062, point 45 du plan, ajouté le 2026-10-25) : le but de la boucle est la précision de la détection sur tout le lot (l'utilisateur). `python3 .claude/skills/boucle/score.py <dossier>` compare, mesure par mesure et capteur par capteur, les événements des détecteurs aux étiquettes de **tous** les lots de la station : par catégorie et pour deux niveaux de validité (« à ignorer » : les zones grisées ; « prudence » : visibilité réduite et turbulence), « trouvées » (part des mesures étiquetées que les détecteurs signalent) et « justes » (part des mesures signalées que l'analyste a étiquetées). L'orchestrateur l'écrit au début de chaque lot (`score-avant.txt`) et en fin de séance (`score-fin.txt`) ; le detectors-upgrader le relance après une modification, comme un contrôle et non un but (D-089) : la catégorie en cause s'améliore sur ce lot, sans baisse nette ailleurs (une autre ligne de ce lot, les lots d'avant) ; un trou n'a pas de case (pas de mesure) : pour lui, la commande du lot dit le bon sens. Le score est un fait, pas un verdict : l'analyste peut se tromper aussi. Choix de Claude, laissé par l'utilisateur, à revoir après la première séance : trois niveaux plutôt que deux, un compte par mesure plutôt que par événement, par capteur plutôt que pour toute la station. Le script est hors de `detectors/` : le detectors-upgrader ne peut pas le modifier.
**Benchmark** (D-069, point 48 du plan, ajouté le 2026-10-26 à la demande de l'utilisateur) : chaque event de la base garde son diagnostic à la création, `etiquettes.json` au format des étiquettes de l'analyste, noms codés, figé ; `.claude/skills/boucle/benchmark.py` lance les détecteurs sur chaque event et les compare à ces étiquettes, comme le score (« trouvées », « justes », par catégorie, par cas et au total). Purement analytique, sans agent. L'orchestrateur le lance au début de chaque lot (`benchmark-avant.txt`), après chaque modification (`benchmark-K.txt`) et en fin de séance (`benchmark-fin.txt`), et l'ajoute à l'historique `vues-deplacements/benchmark/historique.csv`, avec la version des détecteurs (commit) ; le detectors-upgrader le relance et le detectors-control juge sur lui seul (D-089) : un event moins bien trouvé ou moins bien borné est un recul, une hausse un plus, pas un but (sur une dizaine d'events, les détecteurs se régleraient sur eux, choix de l'utilisateur). Le builder donne ses étiquettes à chaque event créé (`anonymiser.py --etiquettes`) ; E-001 à E-005 ont reçu les leurs d'un passage unique de l'analyste, corrigé par leur fiche (leur `etiquetage.md`). Limite : un event appris ne contient que l'événement ± 6 h, sans les 3 jours d'historique d'un lot.
**Benchmark** (D-069, point 48 du plan, ajouté le 2026-10-26 à la demande de l'utilisateur) : chaque event de la base garde son diagnostic à la création, `etiquettes.json` au format des étiquettes de l'analyste, noms codés, figé ; `.claude/skills/boucle/benchmark.py` lance les détecteurs sur chaque event et les compare à ces étiquettes, comme le score (« trouvées », « justes », par catégorie, par cas et au total). Purement analytique, sans agent. L'orchestrateur le lance au début de chaque lot (`benchmark-avant.txt`), après chaque modification (`benchmark-K.txt`) et en fin de séance (`benchmark-fin.txt`), et l'ajoute à l'historique `vues-deplacements/benchmark/historique.csv`, avec la version des détecteurs (commit) ; le detectors-upgrader le relance et le detectors-control juge sur lui seul (D-089) : un event moins bien trouvé ou moins bien borné est un recul, une hausse un plus, pas un but (sur une dizaine d'events, les détecteurs se régleraient sur eux, choix de l'utilisateur). L'event-builder donne ses étiquettes à chaque event créé (`anonymiser.py --etiquettes`) ; E-001 à E-005 ont reçu les leurs d'un passage unique de l'analyste, corrigé par leur fiche (leur `etiquetage.md`). Limite : un event appris ne contient que l'événement ± 6 h, sans les 3 jours d'historique d'un lot.
### Detectors-upgrader : `.claude/agents/detectors-upgrader.md`
@@ -113,15 +112,16 @@ Le garde-fou contre le sur-apprentissage (l'utilisateur, 2026-10-29, D-089) : de
- `validation-K.md` : « accepté » ou « à reprendre » avec ses remarques ; au troisième passage, « garder » ou « annuler ».
- Avant le 2026-10-29, le validateur jugeait aussi le lot (critique, score) et ne renvoyait que pour « un défaut net » ; il n'a jamais renvoyé une modification, et des mesures signalées à tort sur la base passaient (WILDSTRUBEL, point 52 du plan).
### Builder : `.claude/agents/builder.md`
### Event-builder : `.claude/agents/event-builder.md`
Il construit la base de connaissances (l'utilisateur). Outils : Read, Bash, Write, Edit. Il lit les nouveautés des rendus du lot ; c'est l'analyste qui en signale le plus, mais le detectors-upgrader peut en noter aussi (l'utilisateur : « pendant toutes ces phases »).
Il construit la base de connaissances (l'utilisateur). Outils : Read, Bash, Write, Edit. Renommé et redéfini le 2026-10-29 (l'utilisateur, D-091) : appelé à chaque lot, il lit toute l'analyse et décide seul ce qui est nouveau ; avant, il ne traitait que les nouveautés que l'analyste (ou l'upgrader) avait signalées, et l'orchestrateur ne l'appelait que s'il y en avait.
- **Une seule base** (l'utilisateur) : `events/`, à côté de E-001 à E-005 ; numéro suivant de l'index (`E-006`…), comme `/new-event`.
- **Un event par genre d'événement, pas par occurrence** *(choix de Claude)* : si un event de la base a déjà la même signature, dans sa ligne d'index ou dans sa fiche, rien ; une nouveauté qui contredit le diagnostic d'un event est « déjà connue », la contradiction dite pour l'utilisateur.
- Sinon, un event de la même forme que E-001 à E-005 : données de la fenêtre de l'événement, avec une marge, copiées et codées par `anonymize-event` (un état de plus d'un jour : un moment qui le montre, ± 6 h, la plage entière dite dans la fiche) ; fiche du §11.3, un fait hors des listes fermées rangé sous la plus proche, précisé (résumé, symptôme, verdict, signature avec ses commandes, diagnostic, preuves avec leurs figures) ; ligne d'index.
- **Marqué « appris »** *(choix de Claude)*, pour la revalidation à la main, plus tard : en tête de fiche, « Appris par la boucle le <date>, séance <dossier>, non revalidé par l'expert » ; dans l'index, le Verdict commence par « (appris) ».
- Il ne touche jamais aux events existants. Il ne passe pas par `/new-event` (ni passage à l'aveugle, ni validation) : les events appris s'ajoutent sans attendre (l'utilisateur : « ça ne peut pas vraiment faire de mal »).
- **Une seule base** (l'utilisateur) : `events/`, à côté de E-001 à E-005 ; numéro suivant de l'index, comme `/new-event`.
- **Ce qui est nouveau, à son jugement** (l'utilisateur) : il consulte la base (`read-event`) et décide, moment par moment, s'il faut un nouvel event. Ce que la base connaît se juge sur ses events, avec leurs données : un événement que la carte décrit sans event (« hypothétique ») n'est pas connu, son premier exemple réel peut devenir un event. Un moment qui contredit le diagnostic d'un event est noté pour l'utilisateur, sans event.
- **Bornes de l'événement, pas du lot** (l'utilisateur) : un lot peut couvrir des jours ; l'event ne garde que le moment où l'événement se produit, vérifié sur les données, plus 6 h de part et d'autre (un état qui couvre le lot : un moment qui le montre, ± 6 h, la plage entière dite dans la fiche). Données, étiquettes, figures et commandes de la signature s'y bornent.
- Sinon, un event de la même forme que E-001 à E-005 : données copiées et codées par `anonymize-event` ; fiche du §11.3, un fait hors des listes fermées rangé sous la plus proche, précisé ; ligne d'index.
- **Marqué « appris »** *(choix de Claude)*, pour la revalidation par `/review-event` : en tête de fiche, « Appris par la boucle le <date>, séance <horodatage>, non revalidé par l'expert » ; dans l'index, le Verdict commence par « (appris) ».
- Il ne touche jamais aux events existants ni à la carte (elle apprend à la validation, D-087). Il ne passe pas par `/new-event` (ni passage à l'aveugle, ni validation) : les events appris s'ajoutent sans attendre (l'utilisateur : « ça ne peut pas vraiment faire de mal »).
### Releveur : `.claude/agents/releveur.md` (D-060)
@@ -134,7 +134,7 @@ Ajouté le 2026-10-26 à la demande de l'utilisateur, seulement si `/boucle` est
## 6. Ce que l'utilisateur trouve à la fin
- Les commits de la séance sur `master`, un par étape, lisibles avec `git log` depuis la base de la séance (notée dans `bilan.md`) ; il annule ce qu'il ne garde pas par `git revert`.
- `bilan.md` : une ligne par lot (verdict de l'analyste ; étiquettes ; modification gardée, annulée ou aucune ; events créés), et le score de fin de séance (`score-fin.txt`) sur toutes les étiquettes de la station ; les suggestions non traitées (nouvelle catégorie, au-delà de deux) ; les nouveautés déjà connues ; les erreurs.
- `bilan.md` : une ligne par lot (verdict de la critique ; étiquettes ; modification gardée, annulée ou aucune ; events créés), et le score de fin de séance (`score-fin.txt`) sur toutes les étiquettes de la station ; les suggestions non traitées (nouvelle catégorie, au-delà de deux) ; les contradictions avec la base relevées par l'event-builder ; les erreurs.
- `docs/ameliorations-processus.md` : les difficultés du processus relevées pendant la séance ; avec `--ameliorer`, celles que l'améliorateur a corrigées sont marquées **traité**.
- La page `out/boucle_<séance>.html` (D-066, ajoutée le 2026-10-26 à la demande de l'utilisateur), ouverte en fin de séance : les courbes de toute la plage ; dessous, une ligne par catégorie, la lecture de l'analyste au-dessus des événements des détecteurs ; tout en bas, la ligne « Error rate » (`error_value` moyenne de tous les capteurs, du vert au rouge, avec sa barre de couleur, ajoutée le 2026-10-27 à la demande de l'utilisateur) ; le score de la séance. Le but, séance après séance : que les deux coïncident.