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:
1 parent
c763cda5c3
commit
79d83be3ff
20 files changed
+129
-98
No files matched your search
@@ -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.
|
||||
|
||||
|
||||
Reference in new issue
Block a user