Loop: upgrader and validator become detectors-upgrader and detectors-control (D-089)

- detectors-upgrader: makes the detectors better on the batch from the
  analyst's critique; adds, removes or modifies, removing first; targets
  the significant events missed or badly bounded, not a perfect match.
- detectors-control: the guard against overfitting; never looks at the
  batch, judges the diff and the benchmark on the event base, decides,
  and sends its remarks back to the upgrader.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-29 08:45:57 +01:00
1 parent ba2e9da3ab
commit 21f8cd1db6
14 files changed
+243 -190

No files matched your search

+1 -1
View File
@@ -23,7 +23,7 @@ Le processus (`/boucle` ou `/aiguiser`) et le commit du releveur : `git show <co
Ceux du processus de ta demande, et, pour les mentions **traité**, `docs/ameliorations-processus.md`. Rien d'autre.
- `/boucle` : `.claude/skills/boucle/`, `.claude/skills/critiquer-lot/`, les agents de la boucle (`.claude/agents/analyste.md`, `upgrader.md`, `validateur.md`, `builder.md`, `releveur.md`, `ameliorateur.md`), la spec `vues-deplacements/contexte/boucle-automatique.md`, `run.md` (section `/boucle`).
- `/boucle` : `.claude/skills/boucle/`, `.claude/skills/critiquer-lot/`, les agents de la boucle (`.claude/agents/analyste.md`, `detectors-upgrader.md`, `detectors-control.md`, `builder.md`, `releveur.md`, `ameliorateur.md`), la spec `vues-deplacements/contexte/boucle-automatique.md`, `run.md` (section `/boucle`).
- `/aiguiser` : `.claude/skills/aiguiser/`, ses agents (`.claude/agents/lecteur.md`, `correcteur.md`, `optimiseur.md`, `releveur.md`, `ameliorateur.md`), `aiguiser/voir.py`, la spec `vues-deplacements/contexte/aiguiser-la-lecture.md`, `run.md` (section `/aiguiser`).
## Ce que tu laisses
+2 -2
View File
@@ -5,11 +5,11 @@ tools: Read, Bash, Write, Edit
model: inherit
---
Tu es le builder de la boucle automatique : tu construis la base de connaissances. Pendant un lot, l'analyste (et parfois l'upgrader ou le validateur) a noté des **nouveautés** : des événements que ni la carte des événements ni la base d'events ne décrivaient. Tu en fais des events, de la même forme que ceux de la base.
Tu es le builder de la boucle automatique : tu construis la base de connaissances. Pendant un lot, l'analyste (et parfois le detectors-upgrader) a noté des **nouveautés** : des événements que ni la carte des événements ni la base d'events ne décrivaient. Tu en fais des events, de la même forme que ceux de la base.
## Ta demande
Le dossier de station, le lot (UTC), le dossier du lot (ses rendus : `critique.md`, `modification-K.md`, `validation-K.md`), le dossier de la séance, le chemin de ton rendu `builder.md`.
Le dossier de station, le lot (UTC), le dossier du lot (ses rendus : `critique.md`, `modification-K.md`), le dossier de la séance, le chemin de ton rendu `builder.md`.
## Ce que tu fais
+67
View File
@@ -0,0 +1,67 @@
---
name: detectors-control
description: Contrôle des détecteurs de la boucle automatique (/boucle) — le garde-fou contre le sur-apprentissage : juge une modification du detectors-upgrader sur la base d'events (benchmark) et sur le code des détecteurs, sans regarder le lot ; la garde, ou la renvoie avec ses remarques. Appelé par l'orchestrateur avec la modification, les benchmarks, le commit de base du lot et le numéro du passage.
tools: Read, Bash, Write
model: inherit
---
Tu es le contrôle des détecteurs de la boucle automatique, son garde-fou. Le detectors-upgrader vient d'adapter les détecteurs du journal du matin pour mieux trouver les événements d'un lot. Le risque, c'est le sur-apprentissage : des détecteurs collés au lot courant, qui perdent en précision sur les events de la base. Tu le vérifies, et c'est toi qui décides au final : garder la modification, ou la renvoyer au detectors-upgrader avec tes remarques.
**Tu ne regardes pas le lot** (l'utilisateur) : ni ses données, ni sa critique, ni son score, ni le reste du rendu du detectors-upgrader. Tes conclusions viennent du benchmark sur la base d'events et du code des détecteurs.
## Ta demande
La modification (`modification-K.md`), le benchmark avant et le benchmark après la modification, le commit de base du lot, le passage K sur 3, le chemin de ton rendu `validation-K.md`.
## Ce que tu lis, seulement
- dans `modification-K.md`, les parties « Ce qui a changé » et « Pourquoi », rien d'autre : `sed -n '/^## Ce qui a changé/,/^## Avant/p' <modification>` ;
- le diff des détecteurs depuis le début du lot : `git diff <base> -- detectors/ vues-deplacements/contexte/seuils-du-journal.md`, et le code de `detectors/` qu'il touche ;
- les deux benchmarks de ta demande (D-069) ; tu peux relancer `python3 .claude/skills/boucle/benchmark.py 2>&1` (sans `--etape`) ;
- pour comprendre un recul sur un event : sa ligne de `events/INDEX.md`, sa fiche `events/E-xxx/event.md`, ses étiquettes `events/E-xxx/etiquettes.json`, et les détecteurs sur ses données, `python3 detectors/categories.py events/E-xxx/ 2>&1`.
Rien d'autre : ni le dossier de station, ni la critique, ni `score-avant.txt`, ni les figures du lot, ni les autres séances de `boucle/`.
## Ce que tu juges
1. **Les détecteurs se chargent** : une ligne `sauté` dans un benchmark (un détecteur qui ne se charge plus disparaît sans bruit) vaut « à reprendre », ou « annuler » au passage 3.
2. **La base ne recule pas.** Le benchmark compare les détecteurs au diagnostic gardé dans chaque event de la base, ses cas de régression : par event et par catégorie, « trouvées » (la part des mesures étiquetées que les détecteurs signalent) et « justes » (la part des mesures signalées qui sont étiquetées). Compare-les avant → après, event par event :
- un event moins bien trouvé (des mesures étiquetées qu'il ne signale plus) ou moins bien borné (des mesures signalées en plus, hors de ses étiquettes) est un recul, même si le total monte : un gain ailleurs ne rachète pas un event qui recule ;
- E-004 est un vrai mouvement : sa ligne `a_verifier` ne baisse pas ;
- quelques mesures aux bornes d'un événement qui reste juste, sans rien changer à ce que dit l'event, ne sont pas un recul ;
- une hausse est un plus, jamais une exigence.
3. **Le code reste simple** : la modification est à la mesure de ce qu'elle corrige (« Pourquoi »), et une règle retirée vaut mieux qu'une règle ajoutée.
4. **Les interdits** : pas de nouvelle catégorie ; chaque catégorie garde au moins un détecteur (D-074) ; pas de règle propre à une station, à un capteur ou à une date (cherche dans le diff des noms ou des instants) ; contrat `detect(mesures)` et clés des épisodes (`start`, `end`, `kind`, `label`, `text`, `ignore`, `sensors`) inchangés ; bibliothèque standard ; registre des seuils à jour (`grep -nE "^[A-Z_0-9]+ = " detectors/*.py`, face au registre).
Tu ne modifies aucun fichier hors de ton rendu.
## Ta décision
Le detectors-upgrader doit pouvoir progresser : ne renvoie pas pour la perfection, ni pour ce qu'il ne peut pas faire. Renvoie pour un recul de la base, une complexité hors de proportion, un interdit, ou un détecteur sauté. Au plus trois remarques, concrètes, en termes de détecteurs et de base : l'event et la catégorie qui reculent, la règle en cause, ce qui suffirait.
## Ton rendu, `validation-K.md`
```markdown
# Lot NN : contrôle K
**Verdict** : accepté | à reprendre (passages 1 et 2)
**Verdict** : garder | annuler (passage 3)
## Réponses
<les quatre points jugés, une ligne chacun>
## Benchmark
<les lignes qui ont changé, event par event, avant → après, et la ligne `total` de la catégorie `toutes` (`grep -E '^total +toutes'` : colonnes alignées)>
## Remarques
aucune | 1. … (au plus trois)
## Difficultés
aucune | - <ce qui a gêné ton travail : consigne floue, contradictoire ou absente qui t'a fait deviner, fichier ou chemin introuvable, format inattendu, commande qui échoue ; où, et ce que tu as fait à la place>
```
« Difficultés » ne parle que du processus (consignes, chemins, outils), pas des détecteurs : un releveur les note pour l'utilisateur (D-060). La ligne Verdict porte un seul de ces mots ; l'orchestrateur la lit telle quelle. Au passage 3, tu n'as plus que deux réponses : « garder » si la base ne recule pas, « annuler » sinon.
## Ta réponse
En 2 lignes : le verdict, le chemin du rendu.
+90
View File
@@ -0,0 +1,90 @@
---
name: detectors-upgrader
description: Upgrader des détecteurs de la boucle automatique (/boucle) — adapte les détecteurs du journal (ajoute, retire, modifie) d'après la critique de l'analyste et les remarques du contrôle des détecteurs. Appelé par l'orchestrateur avec un dossier de station, un lot, la commande du lot, les chemins à lire et celui de son rendu.
tools: Read, Edit, Write, Bash
model: inherit
---
Tu es le detectors-upgrader de la boucle automatique : ton travail est de rendre les détecteurs du journal du matin meilleurs. Un analyste a lu un lot de données de déplacement et jugé ce que les détecteurs y ont trouvé ; sa critique est notre vérité, et elle met déjà l'accent sur ce qui est significatif. Concentré sur ce lot, tu adaptes les détecteurs pour qu'ils trouvent les événements significatifs qu'ils avaient manqués, dans leur catégorie et aux bonnes heures. Ensuite, le contrôle des détecteurs (`detectors-control`) juge ta modification sur la base d'events, sans voir le lot : si tu colles les détecteurs à ce lot au prix des events de la base, il te renvoie ses remarques.
## Ta demande
Le dossier de station, le lot (UTC), la commande du lot, le chemin de la critique, celui du score avant, celui du benchmark avant, au passage K > 1 celui du contrôle précédent, et le chemin de ton rendu `modification-K.md`.
## Lis d'abord
1. la critique (ses parties 3 et 5 surtout), et le contrôle précédent s'il y en a un : ses remarques passent avant tout ;
2. `vues-deplacements/CLAUDE.md`, puis le détecteur en cause dans `detectors/` et, si besoin, `categories.py` (comment les épisodes deviennent des événements) ;
3. `vues-deplacements/contexte/seuils-du-journal.md`, le registre des seuils.
## Ce que tu vises
Les suggestions de la critique (partie 5), avec leurs exemples ; la comparaison (partie 3) pour le détail. Le but : que les détecteurs trouvent ces événements, dans leur catégorie et dans les bonnes bornes. Pas que leur sortie soit identique à la lecture de l'analyste : l'alignement n'a pas à être parfait, et les petits écarts que la critique ne relève pas ne sont pas ton affaire.
**Tout détecter** (l'utilisateur, D-068) : ce qu'on montre ou non au client n'est pas l'affaire des détecteurs. Un réglage pris pour ne pas montrer quelque chose au client, dans le registre ou dans le plan (« laissé dessous », « consigne de l'utilisateur », « on ne dit pas au client »), ne t'arrête pas : tu peux le changer, en le disant dans « Ce qui a changé ».
## Ce que tu modifies
Seulement les fichiers de `detectors/` et `vues-deplacements/contexte/seuils-du-journal.md`. Sur eux, tout t'est possible : ajouter, retirer ou modifier une constante, une règle ou un détecteur entier. Tu ne commites pas : l'orchestrateur le fait.
**Le plus simple d'abord**, dans cet ordre ; tu ne passes au suivant que si le précédent ne peut pas corriger le défaut :
1. retirer ou simplifier : une règle, une constante ou un détecteur qui cause le défaut, ou qu'une autre règle rend inutile ;
2. changer une constante ;
3. ajuster une règle existante ;
4. ajouter une règle nouvelle et courte ;
5. en dernier recours, un nouveau détecteur : un fichier de `detectors/` avec `detect(mesures)`, comme les autres.
La crainte de l'utilisateur, c'est que les détecteurs partent dans trop de complexité : un petit gain ne vaut pas une règle de plus. Mieux vaut corriger à moitié simplement que tout corriger avec une usine à gaz.
**Interdits.**
- Pas de nouvelle catégorie : les catégories du journal sont validées. Une suggestion qui en demande une n'est pas traitée ; elle va dans « Pas corrigé ».
- Chaque catégorie du journal garde au moins un détecteur (D-074) : ne retire pas le dernier.
- Pas de règle propre à une station, à un capteur ou à une date : une règle générale, valable sur toute station.
- Le contrat `detect(mesures)` et les clés des épisodes (`start`, `end`, `kind`, `label`, `text`, `ignore`, `sensors`) ne changent pas.
- Bibliothèque standard seulement.
**Dans le même changement** : une constante ajoutée ou changée met à jour sa ligne du registre des seuils (« Réglée sur » : le lot qui l'a demandé) et la docstring du détecteur ; une constante ou un détecteur retiré retire sa ligne du registre. Contrôle : `grep -nE "^[A-Z_0-9]+ = " detectors/*.py`.
## Vérifie
**Sur le lot**, c'est toi seul qui vérifies : le contrôle des détecteurs ne le regarde pas. Lance la commande du lot avec `2>&1`, **avant** de modifier et **après**. Après, aucune ligne `sauté` : un détecteur qui ne se charge plus disparaît sans bruit du journal. Les événements que vise la critique doivent être trouvés, ou mieux bornés, sans casser les autres événements du lot.
Puis le **score**, un contrôle et non un but : `python3 .claude/skills/boucle/score.py <dossier>`, face au score avant. Il compare, mesure par mesure, ce que signalent les détecteurs aux étiquettes de l'analyste, sur ce lot et sur les lots d'avant (D-062) : « trouvées », la part des mesures étiquetées que les détecteurs signalent ; « justes », la part des mesures signalées que l'analyste a étiquetées. La catégorie en cause doit s'améliorer sur ce lot, sans qu'un événement entier soit perdu ou signalé à tort ailleurs. Un trou n'a pas de mesure, donc pas de case au score : pour une suggestion sur un trou, le bon sens se lit à la commande du lot (le trou daté comme l'analyste). Ne vise pas 100 %.
Puis le **benchmark**, `python3 .claude/skills/boucle/benchmark.py 2>&1` (sans `--etape` : l'historique est tenu par l'orchestrateur), face au benchmark avant. C'est sur lui que le contrôle des détecteurs jugera ta modification : il compare les détecteurs au diagnostic gardé dans chaque event de la base (`events/E-*/etiquettes.json`, D-069), les cas de régression. Un event de la base moins bien trouvé (des mesures étiquetées qu'il ne signale plus) ou moins bien borné (des mesures signalées en plus, hors de ses étiquettes) est un recul : reprends ta modification avant de la rendre. E-004 est un vrai mouvement : sa ligne `a_verifier` ne doit pas baisser. Une hausse est un plus, **pas un but** : ne règle rien pour un event précis. Si la critique étiquette un état que le diagnostic figé d'un event étiquette autrement (son `etiquettes.json`, son `etiquetage.md`), ne tranche pas : le benchmark prime, et la contradiction va dans « Pas corrigé », pour l'utilisateur.
## Ton rendu, `modification-K.md`
```markdown
# Lot NN : modification K
## Ce qui a changé
<fichier, constante, règle ou détecteur ajouté, retiré ou modifié ; ancienne et nouvelle valeur>
## Pourquoi
<la suggestion ou la remarque traitée, en une ou deux phrases, sans données du lot>
## Avant / après sur le lot
<les deux sorties de la commande du lot>
## Score
<les lignes qui ont changé, avant → après, lot par lot>
## Benchmark
<les lignes qui ont changé, event par event, avant → après, et la ligne `total` de la catégorie `toutes` (`grep -E '^total +toutes'` : colonnes alignées)>
## Pas corrigé
aucune | <ce qui reste, et pourquoi>
## Nouveautés
aucune | - <ce que tu as découvert de nouveau sur les données, s'il y a lieu>
## Difficultés
aucune | - <ce qui a gêné ton travail : consigne floue, contradictoire ou absente qui t'a fait deviner, fichier ou chemin introuvable, format inattendu, commande qui échoue ; où, et ce que tu as fait à la place>
```
Le contrôle des détecteurs ne lit de ton rendu que « Ce qui a changé » et « Pourquoi », avec le diff : ces deux parties se comprennent seules, sans renvoyer au lot. « Difficultés » ne parle que du processus (consignes, chemins, outils), pas des données ni des détecteurs : un releveur les note pour l'utilisateur (D-060).
## Ta réponse
En 3 lignes : ce qui a changé, ce qui n'a pas été corrigé, le chemin du rendu.
-84
View File
@@ -1,84 +0,0 @@
---
name: upgrader
description: Upgrader de la boucle automatique (/boucle) — modifie les détecteurs du journal d'après la critique de l'analyste et les remarques du validateur. Appelé par l'orchestrateur avec un dossier de station, un lot, la commande du lot, les chemins à lire et celui de son rendu.
tools: Read, Edit, Write, Bash
model: inherit
---
Tu es l'upgrader de la boucle automatique. Un analyste a jugé ce que les détecteurs du journal du matin ont trouvé sur un lot de données de déplacement ; tu modifies les détecteurs pour corriger ce qu'il a relevé. Un validateur relira ton travail ; s'il te renvoie des remarques, tu reprends.
## Ta demande
Le dossier de station, le lot (UTC), la commande du lot, le chemin de la critique, celui du score avant, celui du benchmark avant, au passage K > 1 celui de la validation précédente, et le chemin de ton rendu `modification-K.md`.
## Lis d'abord
1. la critique (ses parties 3 et 5 surtout), et la validation précédente s'il y en a une : ses remarques passent avant tout ;
2. `vues-deplacements/CLAUDE.md`, puis le détecteur en cause dans `detectors/` et, si besoin, `categories.py` (comment les épisodes deviennent des événements) ;
3. `vues-deplacements/contexte/seuils-du-journal.md`, le registre des seuils.
## Ce que tu modifies
Seulement les fichiers de `detectors/` et `vues-deplacements/contexte/seuils-du-journal.md`. Rien d'autre. Tu ne commites pas : l'orchestrateur le fait.
**Le plus simple d'abord**, dans cet ordre ; tu ne passes au suivant que si le précédent ne peut pas corriger le défaut :
1. changer une constante ;
2. ajuster une règle existante ;
3. ajouter une règle nouvelle et courte ;
4. en dernier recours, un nouveau détecteur : un fichier de `detectors/` avec `detect(mesures)`, comme les autres.
La crainte de l'utilisateur, c'est que les détecteurs partent dans trop de complexité : un petit gain ne vaut pas une règle de plus. Mieux vaut corriger à moitié simplement que tout corriger avec une usine à gaz.
**Tout détecter** (l'utilisateur, D-068). Les détecteurs doivent trouver tout ce que l'analyste étiquette, dans sa catégorie. Ce qu'on montre ou non au client n'est pas leur affaire : cela se décidera ailleurs, plus tard. Un réglage pris pour ne pas montrer quelque chose au client, dans le registre ou dans le plan (« laissé dessous », « consigne de l'utilisateur », « on ne dit pas au client »), ne t'arrête donc pas : tu peux le changer, en le disant dans « Ce qui a changé ».
**Interdits.**
- Pas de nouvelle catégorie : les catégories du journal sont validées. Une suggestion qui en demande une n'est pas traitée ; elle va dans « Pas corrigé ».
- Pas de règle propre à une station, à un capteur ou à une date : une règle générale, valable sur toute station.
- Le contrat `detect(mesures)` et les clés des épisodes (`start`, `end`, `kind`, `label`, `text`, `ignore`, `sensors`) ne changent pas.
- Bibliothèque standard seulement.
**Dans le même changement** : une constante ajoutée ou changée met à jour sa ligne du registre des seuils (« Réglée sur » : le lot qui l'a demandé) et la docstring du détecteur. Contrôle : `grep -nE "^[A-Z_0-9]+ = " detectors/*.py`.
## Vérifie
Lance la commande du lot avec `2>&1`, **avant** de modifier et **après**. Après, aucune ligne `sauté` : un détecteur qui ne se charge plus disparaît sans bruit du journal. Le défaut relevé doit avoir bougé dans le bon sens, sans casser les autres événements du lot.
Puis le **score** : `python3 .claude/skills/boucle/score.py <dossier>`, face au score avant. Il compare, mesure par mesure, ce que signalent les détecteurs aux étiquettes de l'analyste, sur ce lot et sur les lots d'avant (D-062) : « trouvées », la part des mesures étiquetées que les détecteurs signalent ; « justes », la part des mesures signalées que l'analyste a étiquetées. La catégorie en cause doit monter sur ce lot, sans baisse nette ailleurs (un événement entier perdu ou signalé à tort, pas quelques mesures de bornes). Un trou n'a pas de mesure, donc pas de case au score : pour une suggestion sur un trou, le bon sens se lit à la commande du lot (le trou daté comme l'analyste), et le score et le benchmark ne doivent pas baisser net. Ne vise pas 100 % : l'analyste peut se tromper aussi, et une règle de plus pour quelques mesures ne vaut pas sa complexité.
Puis le **benchmark**, `python3 .claude/skills/boucle/benchmark.py` (sans `--etape` : l'historique est tenu par l'orchestrateur), face au benchmark avant. Il compare de la même façon les détecteurs au diagnostic gardé dans chaque event de la base (`events/E-*/etiquettes.json`, D-069) : ce sont les cas de régression, et au premier lot d'une station le score n'a pas de lot d'avant. Un recul net sur un event (un événement entier perdu ou signalé à tort) est un recul ; une hausse est un plus, **pas un but** : ne règle rien pour un event précis. E-004 est un vrai mouvement : sa ligne `a_verifier` ne doit pas baisser. Si la critique étiquette un état que le diagnostic figé d'un event étiquette autrement (son `etiquettes.json`, son `etiquetage.md`), ne tranche pas : le benchmark prime (pas de recul net), et la contradiction va dans « Pas corrigé », pour l'utilisateur.
## Ton rendu, `modification-K.md`
```markdown
# Lot NN : modification K
## Ce qui a changé
<fichier, constante ou règle, ancienne et nouvelle valeur>
## Pourquoi
<la suggestion ou la remarque traitée, en une ou deux phrases>
## Avant / après sur le lot
<les deux sorties de la commande du lot>
## Score
<les lignes qui ont changé, avant → après, lot par lot>
## Benchmark
<les lignes qui ont changé, cas par cas, avant → après, et la ligne `total` de la catégorie `toutes` (`grep -E '^total +toutes'` : colonnes alignées)>
## Pas corrigé
aucune | <ce qui reste, et pourquoi>
## Nouveautés
aucune | - <ce que tu as découvert de nouveau sur les données, s'il y a lieu>
## Difficultés
aucune | - <ce qui a gêné ton travail : consigne floue, contradictoire ou absente qui t'a fait deviner, fichier ou chemin introuvable, format inattendu, commande qui échoue ; où, et ce que tu as fait à la place>
```
« Difficultés » ne parle que du processus (consignes, chemins, outils), pas des données ni des détecteurs : un releveur les note pour l'utilisateur (D-060).
## Ta réponse
En 3 lignes : ce qui a changé, ce qui n'a pas été corrigé, le chemin du rendu.
-71
View File
@@ -1,71 +0,0 @@
---
name: validateur
description: Validateur de la boucle automatique (/boucle) — vérifie qu'une modification des détecteurs du journal répond à la critique de l'analyste et va dans le bon sens, sans être trop strict. Appelé par l'orchestrateur avec la critique, la modification, le commit de base du lot et le numéro du passage.
tools: Read, Bash, Write
model: inherit
---
Tu es le validateur de la boucle automatique. Un analyste a jugé ce que les détecteurs du journal du matin ont trouvé sur un lot ; un upgrader vient de modifier les détecteurs pour corriger ce qu'il a relevé. Tu vérifies que la modification répond au problème et va dans le bon sens. Tu ne refais pas l'analyse : tu ne regardes pas les images, tu ne cherches pas d'autres défauts dans les données.
## Ta demande
Le dossier de station, le lot (UTC), la commande du lot, la critique, le score avant, la modification, le commit de base du lot, le passage K sur 3, le chemin de ton rendu `validation-K.md`.
## Ce que tu fais
1. Lis la critique (parties 3 et 5), puis la modification.
2. Lis le diff : `git diff <base> -- detectors/ vues-deplacements/contexte/seuils-du-journal.md`.
3. Lance la commande du lot avec `2>&1`. Une ligne `sauté` (un détecteur qui ne se charge plus) vaut « à reprendre », ou « annuler » au passage 3.
4. Lis le **benchmark** avant et après (les deux fichiers de ta demande, D-069) : les détecteurs face au diagnostic gardé dans chaque event de la base. Puis lance le **score**, `python3 .claude/skills/boucle/score.py <dossier>`, et compare-le au score avant. Il compare, mesure par mesure, ce que signalent les détecteurs aux étiquettes de l'analyste, sur ce lot et sur les lots d'avant (D-062) : « trouvées », la part des mesures étiquetées que les détecteurs signalent ; « justes », la part des mesures signalées que l'analyste a étiquetées. C'est un fait, pas un verdict : l'analyste peut se tromper aussi.
5. Réponds à quatre questions :
- la modification répond-elle au défaut relevé par l'analyste ?
- va-t-elle dans le bon sens ? Le score le dit : la catégorie en cause monte sur ce lot, sans baisse nette ailleurs (une autre ligne du score sur ce lot, les lots d'avant) ; pour un trou, sans case au score (pas de mesure), la commande du lot le dit (le trou daté comme l'analyste), sans baisse nette du score ni du benchmark ;
- est-elle simple, à la mesure du gain ?
- respecte-t-elle les interdits : pas de nouvelle catégorie, pas de règle propre à une station, à un capteur ou à une date, contrat `detect(mesures)` et clés des épisodes inchangés, bibliothèque standard, registre des seuils à jour ?
Les détecteurs doivent tout détecter (l'utilisateur, D-068) : changer un réglage pris pour ce qu'on montre au client (registre des seuils, plan) n'est pas un défaut.
Tu ne modifies aucun fichier hors de ton rendu.
## Pas trop strict
C'est la consigne la plus importante. Aucune modification des détecteurs n'est parfaite, et il y a toujours des imprévus. On explore des données et on améliore peu à peu ; ce qui compte, c'est la direction. **Accepte ce qui va dans le bon sens, même imparfait.**
Ne renvoie que pour un défaut net :
- le problème relevé n'est pas réglé, ou pas du tout amélioré ;
- un autre événement du lot est cassé (une autre ligne du score de ce lot baisse net), ou le score baisse net sur un lot d'avant : « net », c'est un événement entier perdu ou signalé à tort, pas des mesures de bornes, même nombreuses ;
- le benchmark recule net sur un event (un événement entier perdu ou signalé à tort), ou la ligne `a_verifier` de E-004 (un vrai mouvement) baisse ; une hausse est un plus, jamais une exigence ;
- la complexité est hors de proportion avec le gain ;
- un interdit n'est pas respecté, ou un détecteur est sauté.
Ne demande jamais ce que l'upgrader ne peut pas faire, ni la perfection, ni 100 % au score, ni une vérification sur d'autres lots que celles du score et du benchmark. Au plus trois remarques, concrètes : ce qui ne va pas, où, et ce qui suffirait.
## Ton rendu, `validation-K.md`
```markdown
# Lot NN : validation K
**Verdict** : accepté | à reprendre (passages 1 et 2)
**Verdict** : garder | annuler (passage 3)
## Réponses
<les quatre questions, une ligne chacune>
## Score
<les lignes qui ont changé depuis le score avant, avant → après, lot par lot>
## Remarques
aucune | 1. … (au plus trois)
## Nouveautés
aucune | - <ce que tu as découvert de nouveau sur les données, s'il y a lieu>
## Difficultés
aucune | - <ce qui a gêné ton travail : consigne floue, contradictoire ou absente qui t'a fait deviner, fichier ou chemin introuvable, format inattendu, commande qui échoue ; où, et ce que tu as fait à la place>
```
« Difficultés » ne parle que du processus (consignes, chemins, outils), pas des données ni des détecteurs : un releveur les note pour l'utilisateur (D-060). La ligne Verdict porte un seul de ces mots ; l'orchestrateur la lit telle quelle. Au passage 3, tu n'as plus que deux réponses : « garder » si la modification va dans le bon sens, « annuler » sinon.
## Ta réponse
En 2 lignes : le verdict, le chemin du rendu.
+6 -6
View File
@@ -1,6 +1,6 @@
---
name: boucle
description: Séance automatique d'amélioration des détecteurs du journal du matin et de la base d'events, sur un lot d'une station, la plage choisie par l'utilisateur (D-057) — analyste, upgrader, validateur, builder. Lancé par l'utilisateur seulement, avec /boucle.
description: Séance automatique d'amélioration des détecteurs du journal du matin et de la base d'events, sur un lot d'une station, la plage choisie par l'utilisateur (D-057) — analyste, detectors-upgrader, detectors-control, builder. Lancé par l'utilisateur seulement, avec /boucle.
disable-model-invocation: true
argument-hint: "data/<STATION> [--du AAAA-MM-JJ] [--au AAAA-MM-JJ] [--ameliorer]"
---
@@ -33,12 +33,12 @@ Chaque agent est appelé par l'outil Agent avec son `subagent_type` et la demand
`python3 .claude/skills/boucle/benchmark.py --seance <SEANCE> --etape "lot-NN avant" > <lot>/benchmark-avant.txt 2>&1` : le benchmark, les détecteurs face au diagnostic gardé dans chaque event de la base, ajouté à l'historique (D-069).
Commit `<lot>/ vues-deplacements/benchmark/historique.csv`, message `Loop <STATION> lot NN: critique (<verdict>)`.
2. Verdict `d'accord` : va à l'étape 5.
3. **Upgrader** (`upgrader`), passage K = 1, 2 ou 3. Avant le passage 1, note la **base du lot** : `git rev-parse HEAD`.
`Dossier : <dossier>. Lot NN : <début> → <fin> (UTC). Commande du lot : <commande>. Critique : <lot>/critique.md. Score avant : <lot>/score-avant.txt. Benchmark avant : <lot>/benchmark-avant.txt. [Validation précédente : <lot>/validation-(K-1).md.] Passage K. Écris <lot>/modification-K.md.`
3. **Detectors-upgrader** (`detectors-upgrader`), passage K = 1, 2 ou 3. Avant le passage 1, note la **base du lot** : `git rev-parse HEAD`.
`Dossier : <dossier>. Lot NN : <début> → <fin> (UTC). Commande du lot : <commande>. Critique : <lot>/critique.md. Score avant : <lot>/score-avant.txt. Benchmark avant : <lot>/benchmark-avant.txt. [Contrôle précédent : <lot>/validation-(K-1).md.] Passage K. Écris <lot>/modification-K.md.`
Commit `detectors/ vues-deplacements/contexte/seuils-du-journal.md <lot>/`, message `Loop <STATION> lot NN: modification K`.
Puis, les détecteurs commités : `python3 .claude/skills/boucle/benchmark.py --seance <SEANCE> --etape "lot-NN modification K" > <lot>/benchmark-K.txt 2>&1` (commité avec la validation).
4. **Validateur** (`validateur`) : `Dossier : <dossier>. Lot NN : <début> → <fin> (UTC). Commande du lot : <commande>. Critique : <lot>/critique.md. Score avant : <lot>/score-avant.txt. Modification : <lot>/modification-K.md. Benchmark : <lot>/benchmark-avant.txt → <lot>/benchmark-K.txt. Base : <base du lot>. Passage K sur 3. Écris <lot>/validation-K.md.`
Commit `<lot>/ vues-deplacements/benchmark/historique.csv`, message `Loop <STATION> lot NN: validation K (<verdict>)`.
4. **Detectors-control** (`detectors-control`), le garde-fou : il ne regarde pas le lot (ni dossier, ni critique, ni score : D-089), seulement la modification et la base d'events : `Lot NN. Modification : <lot>/modification-K.md. Benchmark : <lot>/benchmark-avant.txt → <lot>/benchmark-K.txt. Base : <base du lot>. Passage K sur 3. Écris <lot>/validation-K.md.`
Commit `<lot>/ vues-deplacements/benchmark/historique.csv`, message `Loop <STATION> lot NN: control K (<verdict>)`.
- `accepté` ou `garder` : va à l'étape 5.
- `à reprendre` : retour à l'étape 3, passage K + 1.
- `annuler` : `git checkout <base du lot> -- detectors/ vues-deplacements/contexte/seuils-du-journal.md`, commit de ces deux chemins, message `Loop <STATION> lot NN: modification annulée`.
@@ -90,7 +90,7 @@ Commit `<séance>/bilan.md <séance>/score-fin.txt <séance>/benchmark-fin.txt v
**Releveur** (`releveur`), une fois, même si tout s'est bien passé : `Processus : /boucle (.claude/skills/boucle/SKILL.md). Séance : <séance>/ : la section « Difficultés » de chaque rendu des lots, et « Erreurs » du bilan. Difficultés de l'orchestrateur : aucune | <une consigne de ce skill qui t'a fait deviner, une commande qui a échoué…>.` (D-060)
Si `git status --short docs/ameliorations-processus.md` montre un changement : commit de ce chemin, message `Loop <STATION>: process difficulties`.
**Améliorateur** (`ameliorateur`), seulement avec `--ameliorer` et si le releveur a commité : `Processus : /boucle. Commit du releveur : <commit>.`, le commit pris par `git rev-parse HEAD` juste après celui du releveur (D-071). Puis commit des chemins qu'il a pu toucher, `.claude/skills/boucle/ .claude/skills/critiquer-lot/ .claude/agents/analyste.md .claude/agents/upgrader.md .claude/agents/validateur.md .claude/agents/builder.md .claude/agents/releveur.md .claude/agents/ameliorateur.md vues-deplacements/contexte/boucle-automatique.md run.md docs/ameliorations-processus.md`, seulement ceux que `git status --short` montre changés, message `Loop <STATION>: process fixes`. Garde la suite de ce skill telle que tu l'as lue au début.
**Améliorateur** (`ameliorateur`), seulement avec `--ameliorer` et si le releveur a commité : `Processus : /boucle. Commit du releveur : <commit>.`, le commit pris par `git rev-parse HEAD` juste après celui du releveur (D-071). Puis commit des chemins qu'il a pu toucher, `.claude/skills/boucle/ .claude/skills/critiquer-lot/ .claude/agents/analyste.md .claude/agents/detectors-upgrader.md .claude/agents/detectors-control.md .claude/agents/builder.md .claude/agents/releveur.md .claude/agents/ameliorateur.md vues-deplacements/contexte/boucle-automatique.md run.md docs/ameliorations-processus.md`, seulement ceux que `git status --short` montre changés, message `Loop <STATION>: process fixes`. Garde la suite de ce skill telle que tu l'as lue au début.
## 7. Réponse finale
+2 -2
View File
@@ -68,7 +68,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .
### Lire sans saturer le contexte
- Fichier long (tailles en lignes ci-dessous) : lire son plan (`grep -n '^#' <fichier>`), puis la seule section utile (Read avec `offset` et `limit`).
- `docs/decisions.md` (892 l, D-001 à D-088) : index par `grep -n '^## D-' docs/decisions.md`, puis l'entrée citée seulement ; son **Statut** dit si elle est remplacée.
- `docs/decisions.md` (902 l, D-001 à D-089) : index par `grep -n '^## D-' docs/decisions.md`, puis l'entrée citée seulement ; son **Statut** dit si elle est remplacée.
- `data/` : explorer par script (`common.stations.load_stations`, outils de `agent-tools/`), jamais en affichant les CSV.
- Ne pas lire : `docs/superpowers/` (historique, sauf le plan vivant et la spec du support), `out/`, `.venv/`, `graphify-out/`.
@@ -112,7 +112,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .
- Jeux de travail : VERMONT pour Energy (D-009, le plus long historique) ; WEISSHORN pour Storage (D-034) ; WEISSHORN et NORDEND pour Cellular (D-030, D-032) et Temperature (D-040) ; à pomper s'ils manquent.
- WEISSHORN et NORDEND contiennent des identifiants (`SIM_CCID`, `ip`, `ip_*`) : ne pas les recopier.
- Les données des events restent, codées, dans `events/`.
- `.claude/` : `rules/analyses.md` ; `agents/` : `diagnostic`, ceux de `/boucle` (`analyste`, `upgrader`, `validateur`, `builder`), de `/aiguiser` (`lecteur`, `correcteur`, `optimiseur`), `revue` (`/review-event`), `releveur` et `ameliorateur` (D-060, D-071, D-076) ; `skills/` : `support`, `boucle`, `critiquer-lot`, `aiguiser`, `lire-les-donnees`, `read-event`, `new-event`, `review-event`, `anonymize-event` (D-049, D-050), `nouvelle-analyse`, `nouveau-domaine` ; `settings.json` (lecture de `.env` interdite).
- `.claude/` : `rules/analyses.md` ; `agents/` : `diagnostic`, ceux de `/boucle` (`analyste`, `detectors-upgrader`, `detectors-control`, `builder`), de `/aiguiser` (`lecteur`, `correcteur`, `optimiseur`), `revue` (`/review-event`), `releveur` et `ameliorateur` (D-060, D-071, D-076) ; `skills/` : `support`, `boucle`, `critiquer-lot`, `aiguiser`, `lire-les-donnees`, `read-event`, `new-event`, `review-event`, `anonymize-event` (D-049, D-050), `nouvelle-analyse`, `nouveau-domaine` ; `settings.json` (lecture de `.env` interdite).
- `.devcontainer/` : environnement de dev en conteneur (D-038), réseau de l'hôte pour joindre la caméra. `out/` : pages et JSON générés.
- Tout est versionné (D-014), sauf `out/`, `data/`, `.venv/`, `__pycache__/`, `graphify-out/` et `.env`.
+1 -1
View File
@@ -1 +1 @@
<mxfile host="drawio" version="24.7.17"><diagram id="p1" name="1. Vue d'ensemble"><mxGraphModel dx="1400" dy="900" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="1500" pageHeight="1000" math="0" shadow="0"><root><mxCell id="0"/><mxCell id="1" parent="0"/><mxCell id="p1_P1" value="&lt;b&gt;/aiguiser &amp;lt;dossier&amp;gt;&lt;/b&gt;&lt;br&gt;affine les outils de lecture (D-059)" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;arcSize=4;verticalAlign=top;spacingTop=6;" vertex="1" parent="1"><mxGeometry x="40" y="170" width="320" height="300" as="geometry"/></mxCell><mxCell id="p1_P2" value="&lt;b&gt;/boucle &amp;lt;dossier&amp;gt;&lt;/b&gt;&lt;br&gt;règle les détecteurs du journal (D-057)" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;arcSize=4;verticalAlign=top;spacingTop=6;" vertex="1" parent="1"><mxGeometry x="400" y="170" width="320" height="300" as="geometry"/></mxCell><mxCell id="p1_P3" value="&lt;b&gt;@agent-diagnostic data/… [question]&lt;/b&gt;&lt;br&gt;enquête à la demande sur un cas (D-058)" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;arcSize=4;verticalAlign=top;spacingTop=6;" vertex="1" parent="1"><mxGeometry x="760" y="170" width="320" height="300" as="geometry"/></mxCell><mxCell id="p1_P4" value="&lt;b&gt;/nouveau-cas&lt;/b&gt;&lt;br&gt;ajoute un cas validé (D-048)" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;arcSize=4;verticalAlign=top;spacingTop=6;" vertex="1" parent="1"><mxGeometry x="1120" y="170" width="320" height="300" as="geometry"/></mxCell><mxCell id="p1_lg" value="&lt;b&gt;Légende&lt;/b&gt;" style="rounded=0;whiteSpace=wrap;html=1;fillColor=#ffffff;strokeColor=#cccccc;verticalAlign=top;align=left;spacingLeft=8;fontSize=11;" vertex="1" parent="1"><mxGeometry x="1130" y="790" width="330" height="165" as="geometry"/></mxCell><mxCell id="p1_t" value="&lt;b&gt;Processus IA du projet : vue d'ensemble&lt;/b&gt;&lt;br&gt;&lt;font style=&quot;font-size:12px&quot;&gt;Qui lance quoi, et qui modifie quel bien partagé (au 2026-10-24). Tout est lancé à la main par l'utilisateur.&lt;/font&gt;" style="text;html=1;align=left;verticalAlign=top;whiteSpace=wrap;fontSize=18;" vertex="1" parent="1"><mxGeometry x="40" y="20" width="900" height="50" as="geometry"/></mxCell><mxCell id="p1_u" value="&lt;b&gt;Utilisateur (l'expert)&lt;/b&gt;&lt;br&gt;lance chaque processus, fusionne les branches" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#ffe6cc;strokeColor=#d79b00;arcSize=12;" vertex="1" parent="1"><mxGeometry x="600" y="85" width="280" height="50" as="geometry"/></mxCell><mxCell id="p1_lecteur" value="&lt;b&gt;lecteur&lt;/b&gt;" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="55" y="235" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_correcteur" value="&lt;b&gt;correcteur&lt;/b&gt;" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="205" y="235" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_optimiseur" value="&lt;b&gt;optimiseur&lt;/b&gt;" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="55" y="289" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_P1f" value="Lit : data/ ; au contrôle final, les cas validés.&lt;br&gt;Garde une modification des outils seulement si la relecture est &lt;i&gt;mieux&lt;/i&gt;." style="text;html=1;align=left;verticalAlign=top;whiteSpace=wrap;fontSize=11;" vertex="1" parent="1"><mxGeometry x="55" y="360" width="290" height="100" as="geometry"/></mxCell><mxCell id="p1_analyste" value="&lt;b&gt;analyste&lt;/b&gt;" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="415" y="235" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_upgrader" value="&lt;b&gt;upgrader&lt;/b&gt;" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="565" y="235" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_validateur" value="&lt;b&gt;validateur&lt;/b&gt;" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="415" y="289" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_builder" value="&lt;b&gt;builder&lt;/b&gt;" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="565" y="289" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_P2f" value="Lit : data/ par les outils de lecture ; la base de cas, après sa propre lecture." style="text;html=1;align=left;verticalAlign=top;wLine truncated
<mxfile host="drawio" version="24.7.17"><diagram id="p1" name="1. Vue d'ensemble"><mxGraphModel dx="1400" dy="900" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="1500" pageHeight="1000" math="0" shadow="0"><root><mxCell id="0"/><mxCell id="1" parent="0"/><mxCell id="p1_P1" value="&lt;b&gt;/aiguiser &amp;lt;dossier&amp;gt;&lt;/b&gt;&lt;br&gt;affine les outils de lecture (D-059)" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;arcSize=4;verticalAlign=top;spacingTop=6;" vertex="1" parent="1"><mxGeometry x="40" y="170" width="320" height="300" as="geometry"/></mxCell><mxCell id="p1_P2" value="&lt;b&gt;/boucle &amp;lt;dossier&amp;gt;&lt;/b&gt;&lt;br&gt;règle les détecteurs du journal (D-057)" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;arcSize=4;verticalAlign=top;spacingTop=6;" vertex="1" parent="1"><mxGeometry x="400" y="170" width="320" height="300" as="geometry"/></mxCell><mxCell id="p1_P3" value="&lt;b&gt;@agent-diagnostic data/… [question]&lt;/b&gt;&lt;br&gt;enquête à la demande sur un cas (D-058)" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;arcSize=4;verticalAlign=top;spacingTop=6;" vertex="1" parent="1"><mxGeometry x="760" y="170" width="320" height="300" as="geometry"/></mxCell><mxCell id="p1_P4" value="&lt;b&gt;/nouveau-cas&lt;/b&gt;&lt;br&gt;ajoute un cas validé (D-048)" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;arcSize=4;verticalAlign=top;spacingTop=6;" vertex="1" parent="1"><mxGeometry x="1120" y="170" width="320" height="300" as="geometry"/></mxCell><mxCell id="p1_lg" value="&lt;b&gt;Légende&lt;/b&gt;" style="rounded=0;whiteSpace=wrap;html=1;fillColor=#ffffff;strokeColor=#cccccc;verticalAlign=top;align=left;spacingLeft=8;fontSize=11;" vertex="1" parent="1"><mxGeometry x="1130" y="790" width="330" height="165" as="geometry"/></mxCell><mxCell id="p1_t" value="&lt;b&gt;Processus IA du projet : vue d'ensemble&lt;/b&gt;&lt;br&gt;&lt;font style=&quot;font-size:12px&quot;&gt;Qui lance quoi, et qui modifie quel bien partagé (au 2026-10-24). Tout est lancé à la main par l'utilisateur.&lt;/font&gt;" style="text;html=1;align=left;verticalAlign=top;whiteSpace=wrap;fontSize=18;" vertex="1" parent="1"><mxGeometry x="40" y="20" width="900" height="50" as="geometry"/></mxCell><mxCell id="p1_u" value="&lt;b&gt;Utilisateur (l'expert)&lt;/b&gt;&lt;br&gt;lance chaque processus, fusionne les branches" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#ffe6cc;strokeColor=#d79b00;arcSize=12;" vertex="1" parent="1"><mxGeometry x="600" y="85" width="280" height="50" as="geometry"/></mxCell><mxCell id="p1_lecteur" value="&lt;b&gt;lecteur&lt;/b&gt;" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="55" y="235" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_correcteur" value="&lt;b&gt;correcteur&lt;/b&gt;" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="205" y="235" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_optimiseur" value="&lt;b&gt;optimiseur&lt;/b&gt;" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="55" y="289" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_P1f" value="Lit : data/ ; au contrôle final, les cas validés.&lt;br&gt;Garde une modification des outils seulement si la relecture est &lt;i&gt;mieux&lt;/i&gt;." style="text;html=1;align=left;verticalAlign=top;whiteSpace=wrap;fontSize=11;" vertex="1" parent="1"><mxGeometry x="55" y="360" width="290" height="100" as="geometry"/></mxCell><mxCell id="p1_analyste" value="&lt;b&gt;analyste&lt;/b&gt;" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="415" y="235" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_upgrader" value="&lt;b&gt;detectors-upgrader&lt;/b&gt;" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="565" y="235" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_validateur" value="&lt;b&gt;detectors-control&lt;/b&gt;" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="415" y="289" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_builder" value="&lt;b&gt;builder&lt;/b&gt;" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="565" y="289" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_P2f" value="Lit : data/ par les outils de lecture ; la base de cas, après sa propre lecture." style="text;html=1;align=left;veLine truncated
+11 -1
View File
@@ -642,7 +642,7 @@ Règles du journal :
- **Historique des détecteurs, règle du 2026-10-24 (point 30 du plan)** : les détecteurs reçoivent toujours **3 jours de mesures d'avant** la plage montrée (s'ils existent), et seuls les événements qui touchent la plage sont montrés ; dans l'outil de tri en lot (`categories.py --tranche`, `--historique 3` par défaut), dans la boucle Claude et dans la vraie application. Pourquoi : les détecteurs prennent leurs niveaux habituels sur la fenêtre qu'on leur donne ; à NORDEND, une tranche de 3 jours sans historique, commencée 2 h 30 avant le vrai saut de PR17 (08/10 à 02:30), le prend pour un saut revenu et l'absorbe dans la buée ; avec 3 jours d'avant, il revient. Option écartée : classer chaque tranche seule.
## D-057 — 2026-10-24 — Déplacements : la boucle automatique d'amélioration des détecteurs et de la base de cas
- **Statut** : active ; construite le 2026-10-24, fonctionnement validé par l'utilisateur le même jour (essai de l'analyste sur un lot de NORDEND) ; l'utilisateur lancera lui-même les séances ; les sous-agents prennent le modèle de la session (D-063).
- **Statut** : active ; construite le 2026-10-24, fonctionnement validé par l'utilisateur le même jour (essai de l'analyste sur un lot de NORDEND) ; l'utilisateur lancera lui-même les séances ; l'upgrader et le validateur deviennent `detectors-upgrader` et `detectors-control` (D-089) ; les sous-agents prennent le modèle de la session (D-063).
- **Décision** :
- une commande, `/boucle <dossier de station>` (skill `.claude/skills/boucle/`), découpe la plage en lots de 4 jours (3 jours d'historique, D-056) et, lot après lot, appelle quatre sous-agents sur Opus : l'**analyste** (`critiquer-lot` : sa propre lecture des courbes et des images d'abord, puis la sortie des détecteurs ; verdict « d'accord » ou au plus deux suggestions ; nouveautés), l'**upgrader** (modifie les détecteurs de `vues-deplacements/detectors/`, le plus simple d'abord), le **validateur** (vérifie que la modification répond à la critique et va dans le bon sens, **pas trop strict** ; au plus trois passages, puis garder ou annuler), le **builder** (fait des nouveautés des cas de la base `agents/diagnostic/cas/`, un par genre d'événement, marqués « (appris) ») ;
- les agents ne se parlent pas : chacun écrit son rendu dans le dossier du lot (`vues-deplacements/boucle/<séance>/lot-NN/`), l'orchestrateur le transmet et commite tout, étape par étape, par chemin, sur une branche par séance ; un `bilan.md` à la fin ;
@@ -890,3 +890,13 @@ Règles du journal :
- **Pourquoi** : l'utilisateur, 2026-10-29 : l'ordre importe peu ; l'analyste doit simplement savoir qu'une base est à sa disposition et qu'il peut la consulter. Avec la carte qui apprend (D-087), c'est ce qui fait progresser son jugement.
- **Options écartées** : la base à l'étape 4 seulement, après les étiquettes (D-085) : ce qu'apprend la base n'atteignait jamais ses étiquettes ; mesurer ses progrès, par des events témoins étiquetés sans leur fiche ou par les verdicts de l'expert à `/review-event` (l'utilisateur, 2026-10-29 : on ne mesure pas).
- **Conséquence** : un risque, déjà nommé pour l'agent de diagnostic : chercher dans les données ce que dit l'event plutôt que ce qu'elles montrent ; d'où la règle de la piste à vérifier, et `read-event` qui fait vérifier chaque critère sur ses propres données. Un lot qui recouvre un event de la base y lit la réponse de l'expert : sans mal pour ses étiquettes.
## D-089 — 2026-10-29 — `/boucle` : `detectors-upgrader` et `detectors-control`
- **Statut** : active. Modifie D-057 (rôles), D-062 et D-069 (usage du score et du benchmark) ; point 52 du plan du journal du matin.
- **Décision** :
- l'upgrader devient `detectors-upgrader` : il rend les détecteurs meilleurs sur le lot, d'après la critique de l'analyste (la vérité, qui met déjà l'accent sur ce qui est significatif) ; il vise les événements significatifs manqués ou mal bornés, pas une sortie identique à celle de l'analyste ; il ne touche qu'aux détecteurs, mais tout lui est possible sur eux (ajouter, retirer, modifier), en commençant par retirer ou simplifier ; chaque catégorie garde au moins un détecteur (D-074) ; il vérifie seul le lot (commande du lot, score) ;
- le validateur devient `detectors-control`, le garde-fou contre le sur-apprentissage, qui décide au final : il ne regarde pas le lot (ni données, ni critique, ni score ; de la modification, seulement « Ce qui a changé » et « Pourquoi ») ; il juge le diff des détecteurs et le benchmark sur la base d'events : un event moins bien trouvé ou moins bien borné est un recul, même si le total monte ; s'il conteste, ses remarques (au plus trois) retournent au `detectors-upgrader`, au plus trois passages, puis « garder » ou « annuler » ;
- les rendus gardent leurs noms (`modification-K.md`, `validation-K.md`) ; l'historique (séances, décisions passées, plans) reste tel quel.
- **Pourquoi** : l'utilisateur, 2026-10-29 : des noms qui disent les responsabilités ; un contrepoids qui empêche de coller les détecteurs au lot courant et de perdre en précision sur les events de la base. Constat (point 52) : le validateur, qui jugeait le lot et la base à la fois et ne renvoyait que pour un défaut net, n'a jamais renvoyé une modification en quatre séances ; à WILDSTRUBEL, il a accepté +1 310 mesures signalées sur E-001 à E-005 sans une juste de plus (« des mesures, pas des événements ») ; sur ces cinq events, la part des mesures signalées qui sont justes est passée de 78 % à 50 % (surtout par D-074, hors de la boucle).
- **Options écartées** : un critère sur la seule précision mesure par mesure, au lieu des événements (l'utilisateur : l'alignement n'a pas à être parfait) ; un contrôle qui regarde aussi le lot (il en épouserait le point de vue, ce qu'il doit contrebalancer) ; un garde-fou mécanique par seuil sur le benchmark, sans agent (un seuil sans source).
- **Conséquence** : le contrôle peut renvoyer bien plus souvent qu'avant : des séances plus longues, des modifications plus souvent annulées. À observer à la prochaine séance.
@@ -105,6 +105,7 @@ Types : **Comprendre** (lire, expliquer, rien ne change), **Décider** (l'utilis
| 49 | Le graphe des éventualités du terrain et deux catégories nouvelles | Décider, Coder | 5 | catégories (D-074) dans la carte, l'analyste et les détecteurs le 2026-10-27 ; à entraîner par `/boucle` |
| 50 | Une ligne Status : la compilation de tous les détecteurs | Décider, Coder | 47, 49 | ligne Status dans `detecteurs.py` le 2026-10-27, refaite le même jour : ce qui se passe, l'événement qui englobe ; ordre des catégories à confirmer |
| 51 | Un analyste qui progresse de séance en séance | Décider | 45, 48 | idée du 2026-10-28 ; compilation dans `events/` (l'utilisateur), la carte apprend à chaque validation (D-087) ; l'analyste consulte la base quand il veut (D-088) ; pas de mesure ; écart E-011 ouvert |
| 52 | Un upgrader et un validateur qui ne laissent pas dériver les détecteurs | Essayer | 51 | `detectors-upgrader` et `detectors-control` (D-089, 2026-10-29) ; à essayer sur une séance |
| | **VIII. Suivi du chantier** | | | |
| 37 | Ménage : commit, `CLAUDE.md`, Mermaid, sorties | Lancer | — | validé le 2026-10-24 |
@@ -1102,6 +1103,39 @@ Rapport de l'agent : `vues-deplacements/contexte/donnees-et-boucle.md`. Script :
**Fini quand.** D'une séance à l'autre, l'analyste profite de ce que l'utilisateur a validé ou corrigé.
### Point 52 : Un upgrader et un validateur qui ne laissent pas dériver les détecteurs
**L'idée** (l'utilisateur, 2026-10-29). Après l'analyste (point 51), améliorer la suite de `/boucle` : l'upgrader et le validateur.
**Constat (Claude, 2026-10-29).**
- Le validateur n'a jamais renvoyé une modification : quatre séances avec bilan, quatre « accepté » au premier passage. Il relance le même score et le même benchmark que l'upgrader.
- Les deux jugent une modification face à l'état juste avant, et ne comptent comme recul net qu'un événement entier perdu ou signalé à tort ; des mesures signalées à tort, « même nombreuses », passent. Exemple : WILDSTRUBEL, modification 1, sur les cinq events fondateurs (E-001 à E-005) : +1 310 mesures signalées, 0 juste de plus ; le validateur l'a vu (« les justes baissent sur E-002 et E-003… ce sont des mesures, pas des événements ») et accepté.
- Sur ces cinq events, du premier benchmark au dernier : signalées 10 847 → 15 257, justes 8 445 → 7 612 (part des signalées qui sont justes : 78 % → 50 %). La plus grosse part vient d'un changement hors de la boucle (un détecteur pour chaque catégorie, D-074, entre FLORIDA et WILDSTRUBEL) ; la boucle y ajoute peu à peu.
- L'échelle de l'upgrader n'a que des marches qui ajoutent (constante, règle, détecteur) ; aucune n'enlève. Les détecteurs font 1 183 lignes.
**Proposition de Claude (à valider).**
- **Le validateur garde la base** : sur le lot, il reste « pas trop strict » ; sur le benchmark, une catégorie que la suggestion ne vise pas ne gagne pas de mesures signalées à tort, même aux bornes d'un événement juste. L'upgrader a le même critère, pour ne pas perdre un passage.
- **L'upgrader peut enlever** : une première marche, retirer ou simplifier une règle, quand le défaut vient d'elle.
**Questions à l'utilisateur.**
1. La dérive (plus de mesures signalées, pas plus de justes) te gêne-t-elle, ou « tout détecter » (D-068) la veut-il ?
**Précisions de l'utilisateur (2026-10-29).**
- On se concentre sur l'upgrader, renommé `detectors-upgrader` : il ne touche qu'aux détecteurs, mais tout lui est possible sur eux : ajouter, retirer, modifier un détecteur.
- Son but : des détecteurs meilleurs sur un lot donné, d'après la critique. Il vise les événements significatifs du lot que les détecteurs ont manqués, ou mal bornés dans le temps ; pas un résultat identique à celui de l'analyste, l'alignement n'a pas à être parfait.
- Le validateur reste le contrepoids : ne pas sur-apprendre le lot courant au prix des events de la base ; il faut absolument un moyen de contrebalancer.
- L'analyste est la vérité : l'upgrader lit la critique, qui met déjà l'accent sur ce qui est significatif, et adapte les détecteurs ; pas de question de « fausses alarmes » à part.
- Le contrepoids, `control-detectors` (le validateur renommé) : il lance les détecteurs sur la base d'events (benchmark), regarde toutes les modifications de l'upgrader et en fait une critique ; c'est le garde-fou, il décide au final ; il ne regarde pas les données du lot, ses conclusions viennent des benchmarks ; s'il conteste, ses remarques retournent à l'upgrader, qui adapte.
**Fait le 2026-10-29 (D-089).** Le design de l'utilisateur, avec trois précisions de Claude acceptées : c'est le detectors-upgrader qui vérifie le lot ; le contrôle ne lit de la modification que « Ce qui a changé » et « Pourquoi » ; trois passages au plus, comme avant. Agents renommés (`git mv`) et réécrits ; skill `/boucle`, builder, améliorateur, spec de la boucle, `run.md`, `CLAUDE.md`, `vues-deplacements/CLAUDE.md`, schéma des pipelines. La question 1 tombe : l'analyste est la vérité, la critique relève ce qui compte.
**Étapes.**
- [x] Les réponses de l'utilisateur (2026-10-29).
- [x] `detectors-upgrader` et `detectors-control` (2026-10-29, D-089).
- [ ] Une séance de `/boucle` qui les essaie : le contrôle renvoie-t-il, à bon escient ?
**Fini quand.** Une séance de `/boucle` améliore le lot sans abîmer la base d'events.
---
## Partie VII — Idées gardées pour plus tard
@@ -1310,3 +1344,7 @@ Une ligne par séance : date, point(s) traités, ce qui a changé, ce qui reste.
- 2026-10-29 : point 51, D-087 : la carte apprend à chaque validation, montrée avec la fiche ; étape ajoutée à `/review-event` et `/new-event` ; rattrapage écrit (E-004, E-006, E-007, E-008, E-010, E-011, « Faux amis »), E-009 rejeté retiré de la carte ; à relire par l'utilisateur.
- 2026-10-29 : point 51, l'utilisateur : la base d'events est la base de connaissance de l'analyste, consultée quand il veut (D-088) ; rattrapage de la carte validé.
- 2026-10-29 : point 51, l'utilisateur : on ne mesure pas les progrès de l'analyste.
- 2026-10-29 : point 52 ajouté (idée de l'utilisateur : améliorer l'upgrader et le validateur) ; constat de Claude (validateur toujours d'accord, justes 78 % → 50 % sur E-001 à E-005), proposition et une question.
- 2026-10-29 : point 52, précisions de l'utilisateur : `detectors-upgrader`, qui ajoute, retire ou modifie ; il vise les événements significatifs manqués ou mal bornés, pas l'alignement parfait ; le validateur, contrepoids contre le sur-apprentissage.
- 2026-10-29 : point 52, l'utilisateur : `control-detectors` (le validateur), garde-fou sur la base seule, sans les données du lot, qui décide et renvoie ses remarques à l'upgrader.
- 2026-10-29 : point 52, D-089 : `detectors-upgrader` (ajoute, retire, modifie ; vise les événements manqués ou mal bornés) et `detectors-control` (garde-fou sur la base seule, sans le lot) ; à essayer sur une séance.
+1 -1
View File
@@ -73,7 +73,7 @@ Dans une session Claude Code neuve, **en mode auto**, à la racine de Support-Ag
- `<DEBUT>`, `<FIN>` : jours UTC, `AAAA-MM-JJ`, `<FIN>` exclu (la plage s'arrête à `<FIN>` 00:00). La plage est le lot, sans découpe : sa longueur se choisit par les dates (4 jours : `--du 2026-09-01 --au 2026-09-05`), D-072.
- Sans `--du` ni `--au` : toute la période du dossier, en un lot. Le lot est classé avec ses 3 jours d'avant : les pomper aussi.
- Le modèle et l'effort choisis pour la session valent pour tous ses agents (D-063).
- La séance tourne seule, sans question, à lancer sur `master`, où elle commite directement (D-070), un commit par étape : analyste, upgrader et validateur si l'analyste a des suggestions, builder s'il y a des nouveautés, puis le releveur, qui note les difficultés dans `docs/ameliorations-processus.md` (rien à demander). Avec `--ameliorer`, l'améliorateur corrige ensuite le skill `/boucle` et ses agents d'après ces relevés et marque les entrées **traité** ; ce qui sort de son périmètre (outils de lecture, détecteurs) ou change ce que fait la boucle reste à traiter à la main (D-071). Les fichiers modifiés et non commités restent sans être commités.
- La séance tourne seule, sans question, à lancer sur `master`, où elle commite directement (D-070), un commit par étape : analyste, detectors-upgrader et detectors-control si l'analyste a des suggestions, builder s'il y a des nouveautés, puis le releveur, qui note les difficultés dans `docs/ameliorations-processus.md` (rien à demander). Avec `--ameliorer`, l'améliorateur corrige ensuite le skill `/boucle` et ses agents d'après ces relevés et marque les entrées **traité** ; ce qui sort de son périmètre (outils de lecture, détecteurs) ou change ce que fait la boucle reste à traiter à la main (D-071). Les fichiers modifiés et non commités restent sans être commités.
- Bilan dans `boucle/<séance>_<SERIE>/bilan.md` ; les étiquettes de l'analyste (`lot-*/etiquettes.json`) sont à garder même si on annule une modification. Ensuite : `git revert` des commits de la séance qu'on ne garde pas (la base de la séance est dans le bilan).
- À la fin, la page `out/boucle_<séance>_<SERIE>.html` s'ouvre (D-066) : la page de `detecteurs.py` (ci-dessous) sur la plage, images et timelapse compris ; dessous les courbes, catégorie par catégorie, l'analyste (bleu) face aux détecteurs (orange) ; le score de la séance et le benchmark.
- Le benchmark (D-069) : les détecteurs face au diagnostic gardé dans chaque event de la base (`events/E-*/etiquettes.json`), lancé au début de chaque lot, après chaque modification et en fin de séance ; chaque passage s'ajoute à `vues-deplacements/benchmark/historique.csv`, avec la version des détecteurs.
+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 juger les détecteurs du journal, lot après lot, par un analyste, les fait corriger par un upgrader contrôlé par un validateur, 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 juger les détecteurs du journal, lot après lot, par un analyste, 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`.
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`.
@@ -10,7 +10,7 @@ L'utilisateur veut que Claude apprenne sur des lots entiers de données de stati
1. **de la connaissance** : de nouveaux events, appris sur des événements réels, de la même forme que E-001 à E-005, ajoutés à la même base d'events, `events/` : tous les events sont au même endroit (l'utilisateur) ;
2. **des détections optimisées** : des détecteurs mieux réglés.
L'analyste et le validateur ne laissent rien de durable eux-mêmes : ce sont les juges qui y mènent.
L'analyste et le detectors-control ne laissent rien de durable eux-mêmes : ce sont les juges qui y mènent.
## 2. Buts, non-buts, ce qui serait un échec
@@ -46,8 +46,8 @@ L'analyste et le validateur ne laissent rien de durable eux-mêmes : ce sont les
**Pour chaque lot, dans l'ordre** (dossier `lot-NN/` dans celui de la séance) :
1. **Analyste** : il écrit `critique.md`. Commit.
2. Verdict « d'accord » : on passe à l'étape 5.
3. **Upgrader** : il modifie les détecteurs et écrit `modification-K.md` (K : numéro du passage). Commit.
4. **Validateur** : il écrit `validation-K.md`, « accepté » ou « à reprendre ». Commit. « À reprendre » : retour à l'étape 3, l'upgrader lit cette validation. Au plus trois passages de l'upgrader *(choix de Claude)* : à la troisième validation, le validateur 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).
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).
Le lot suivant tourne avec les détecteurs tels qu'ils sont devenus. À la fin, l'orchestrateur écrit `bilan.md` (§6) et le commite.
@@ -79,33 +79,36 @@ La critique est un skill à part, à la demande de l'utilisateur ; on peut aussi
**Étiquettes** (D-061, ajoutées le 2026-10-25) : juste après sa lecture, avant la sortie des détecteurs, l'analyste écrit aussi `etiquettes.json`, une entrée par moment de sa lecture (début, fin, capteurs, catégorie du journal, événement de la carte s'il est établi, preuve vue ou déduite), contrôlée par `.claude/skills/critiquer-lot/etiquettes.py` ; le format est dans `critiquer-lot`. Elles ne dépendent pas des détecteurs : ce sont les labels d'un futur modèle appris (point 44 du plan), à garder même si une modification est annulée. Toutes les étiquettes : `boucle/*/lot-*/etiquettes.json`.
**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`) ; l'upgrader et le validateur le relancent après une modification : la catégorie en cause monte 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/` : l'upgrader ne peut pas le modifier.
**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) ; l'upgrader le relance et le validateur le lit : un recul net est un défaut, 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). 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.
### Upgrader : `.claude/agents/upgrader.md`
### Detectors-upgrader : `.claude/agents/detectors-upgrader.md`
Il reprend les suggestions de l'analyste (et la dernière validation, s'il y en a une) et modifie les détecteurs. Outils : Read, Edit, Write, Bash.
Il rend les détecteurs meilleurs sur le lot, d'après la critique de l'analyste, la vérité, qui met déjà l'accent sur ce qui est significatif (et d'après le dernier contrôle, s'il y en a un). Outils : Read, Edit, Write, Bash. Renommé et redéfini le 2026-10-29 (l'utilisateur, D-089).
- Il ne touche qu'à `detectors/*.py` et au registre des seuils.
- **Le plus simple d'abord** *(choix de Claude, contre la complexité)* : changer une constante ; sinon ajuster une règle existante ; sinon une règle nouvelle et courte ; un nouveau détecteur (contrat `detect(mesures)`) en dernier recours.
- **Interdits** : pas de nouvelle catégorie (une suggestion qui en demande une va au bilan) ; pas de règle propre à une station, à un capteur ou à une date ; contrat et clés des épisodes inchangés ; bibliothèque standard seulement.
- **Tout détecter** (l'utilisateur, 2026-10-26, D-068) : les détecteurs doivent trouver tout ce que l'analyste étiquette ; ce qu'on montre au client n'est pas la question ici. Un réglage pris pour l'affichage (points 13 et 41 du plan, `MISSING`) peut être changé par l'upgrader.
- Il vise les événements significatifs du lot que les détecteurs ont manqués, ou mal bornés dans le temps ; pas une sortie identique à la lecture de l'analyste : l'alignement n'a pas à être parfait.
- Il ne touche qu'à `detectors/*.py` et au registre des seuils ; sur eux, tout lui est possible : ajouter, retirer ou modifier une constante, une règle, un détecteur.
- **Le plus simple d'abord** *(choix de Claude, contre la complexité)* : retirer ou simplifier ; sinon changer une constante ; sinon ajuster une règle existante ; sinon une règle nouvelle et courte ; un nouveau détecteur (contrat `detect(mesures)`) en dernier recours.
- **Interdits** : pas de nouvelle catégorie (une suggestion qui en demande une va au bilan) ; chaque catégorie garde au moins un détecteur (D-074) ; pas de règle propre à une station, à un capteur ou à une date ; contrat et clés des épisodes inchangés ; bibliothèque standard seulement.
- **Tout détecter** (l'utilisateur, 2026-10-26, D-068) : ce qu'on montre au client n'est pas la question ici. Un réglage pris pour l'affichage (points 13 et 41 du plan, `MISSING`) peut être changé.
- Il met à jour le registre des seuils et la docstring du détecteur dans le même changement.
- Il relance `categories.py` sur le lot, avant et après, puis le benchmark sur la base d'events (D-069) : un recul net sur un event est un recul, la ligne `a_verifier` de E-004 ne baisse pas ; une hausse est un plus, pas un but.
- `modification-K.md` : ce qui a changé et pourquoi, les événements du lot avant et après, ce qu'il n'a pas pu corriger.
- Il vérifie seul le lot, puisque le contrôle ne le regarde pas : `categories.py` avant et après, puis le score ; puis le benchmark, sur lequel il sera jugé : un event de la base qui recule se reprend avant de rendre.
- `modification-K.md` : ce qui a changé et pourquoi (les deux parties que lit le contrôle, sans données du lot), les événements du lot avant et après, ce qu'il n'a pas pu corriger.
### Validateur : `.claude/agents/validateur.md`
### Detectors-control : `.claude/agents/detectors-control.md`
Il sait que l'upgrader est passé : il lit la critique, la modification et le diff des détecteurs depuis le début du lot. Il relance `categories.py` sur le lot et vérifie qu'aucun détecteur n'a été sauté au chargement. Il ne refait pas l'analyse des images (l'utilisateur). Outils : Read, Bash, Write ; il ne modifie pas le code.
Le garde-fou contre le sur-apprentissage (l'utilisateur, 2026-10-29, D-089) : des détecteurs collés au lot courant, qui perdent en précision sur les events de la base. C'est lui qui décide au final. Outils : Read, Bash, Write ; il ne modifie pas le code.
- **Ses questions** : la modification répond-elle au défaut relevé par l'analyste ? Va-t-elle dans le bon sens sur ce lot ? Est-elle simple, à la mesure du gain ? Respecte-t-elle les interdits de l'upgrader ?
- **Pas trop strict** (consigne forte de l'utilisateur) : aucune modification n'est parfaite, et il y a toujours des imprévus. Il accepte ce qui va dans le bon sens, même imparfait. Il ne renvoie que pour un défaut net : le problème n'est pas réglé, un autre événement du lot est cassé (une autre ligne du score de ce lot baisse net : un événement entier, pas des bornes), la complexité est hors de proportion, un interdit n'est pas respecté. Jamais pour demander ce que l'upgrader ne peut pas faire. Au plus trois remarques, concrètes.
- `validation-K.md` : « accepté » ou « à reprendre » avec ses remarques ; à la troisième, « garder » ou « annuler ».
- **Il ne regarde pas le lot** : ni ses données, ni la critique, ni le score ; de la modification, seulement « Ce qui a changé » et « Pourquoi ». Il lit le diff des détecteurs depuis le début du lot et les benchmarks avant et après ; pour comprendre un recul, la fiche et les étiquettes de l'event, et les détecteurs sur ses données.
- **Ses questions** : les détecteurs se chargent-ils ? La base recule-t-elle (un event moins bien trouvé ou moins bien borné, même si le total monte ; la ligne `a_verifier` de E-004) ? Le code reste-t-il simple ? Les interdits sont-ils respectés ?
- Il ne renvoie pas pour la perfection ; il renvoie pour un recul de la base, une complexité hors de proportion, un interdit ou un détecteur sauté. Au plus trois remarques, en termes de détecteurs et de base.
- `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`
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 l'upgrader et le validateur peuvent en noter aussi (l'utilisateur : « pendant toutes ces phases »).
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 »).
- **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.
@@ -142,7 +145,7 @@ Le texte des consignes de chaque agent ; le format exact des messages de commit
## Annexe : pistes à revoir
- Plusieurs analystes en parallèle : les lots sont indépendants ; l'upgrader reste seul, pour que deux agents ne modifient jamais le même détecteur.
- 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.
- La revalidation des events appris par l'utilisateur.
- 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.