Events: read-event skill to consult the base (D-085), cases renamed events E-xxx (D-086)

- read-event: map and index first, then the card of close events only,
  then their data with the reading tools; never all cards at once.
  Diagnostic agent, critiquer-lot and builder point to it; the index
  header too. Signature length: about 250 characters, a guideline.
- "Cas" becomes "event": events/E-xxx/event.md, skills new-event,
  review-event, anonymize-event.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-29 07:25:29 +01:00
1 parent 4d99585474
commit 446fde3192
1206 files changed
+2172 -2129

No files matched your search

+2 -2
View File
@@ -1,6 +1,6 @@
# Vues des déplacements
Chantier à part (D-052) : rendre les données de déplacement lisibles par un humain, client comme expert, et intégrer l'agent de diagnostic dans une maquette. Le but est de montrer à l'utilisateur ce que l'agent utilise pour diagnostiquer. On part de cas réels, apportés par l'utilisateur (l'expert) avec les pages de la plateforme qu'il a consultées, et on avance pas à pas.
Chantier à part (D-052) : rendre les données de déplacement lisibles par un humain, client comme expert, et intégrer l'agent de diagnostic dans une maquette. Le but est de montrer à l'utilisateur ce que l'agent utilise pour diagnostiquer. On part d'events réels, apportés par l'utilisateur (l'expert) avec les pages de la plateforme qu'il a consultées, et on avance pas à pas.
## Rangement
@@ -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 de cas 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 de cas (`.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 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`.
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`.
File diff suppressed because it is too large. Load diff
@@ -15,4 +15,4 @@ Démarche décrite par l'utilisateur en conversation le 2026-10-16, notée par C
| 9 | Les déplacements en mm, comme la page Time Series (onglet Diagnosis) | Les mm sont plus parlants pour l'utilisateur que les pixels de `corr_x` / `corr_y` | Export horaire : le 08/10, dans l'heure de 02:00 UTC, PR17 passe de +5,4 à −3,5 mm en vertical (environ −9 mm) et prend environ +5 mm en horizontal ; retour partiel le 12/10 vers 23:00. Sur NORDEND, vertical de PR17 = 55,5 × `corr_y` (r = 0,994) |
| 10 | Les sauts et les tendances détectés d'eux-mêmes (onglet Displacements de la maquette, D-055, construit après la séance) | PR17 saute nettement en vertical et en horizontal le 08/10, et revient à la normale fin du 12/10 ou le 13/10 ; « à part la PR17, les autres cibles n'ont pas l'air de bouger tant que ça » ; le client regarde les sauts et les tendances, pas les erreurs | Deux événements, PR17 seule : 08/10 01:00 → 04:00 UTC (−8,5 mm en vertical, +5,1 mm en horizontal) ; retour le 12/10 21:00 → 23:00 UTC (−4,9 mm en horizontal, +2,6 mm en vertical). Une tendance : PR06 en horizontal, +0,7 mm en 10 jours (`contexte/detection-d-anomalies.md`) |
**Verdict de l'expert (2026-10-16)** : le comportement de PR17 du 08/10 au 13/10 reste sans explication claire. Il en reste là pour ce cas. La séance a surtout produit la maquette Explore (onglets View et Diagnosis, D-054, `vues-deplacements/maquette/spec.md`).
**Verdict de l'expert (2026-10-16)** : le comportement de PR17 du 08/10 au 13/10 reste sans explication claire. Il en reste là pour cet event. La séance a surtout produit la maquette Explore (onglets View et Diagnosis, D-054, `vues-deplacements/maquette/spec.md`).
@@ -13,27 +13,27 @@ On veut donc un autre processus automatique, à part de `/boucle`, qui ne travai
**Buts.**
- Une commande lance une séance sur un dossier de station ; elle tourne seule jusqu'au bout ; tout est commité, étape par étape, directement sur `master`, comme `/boucle` (D-070 ; d'abord sur une branche à part, accepté le 2026-10-24, remplacée par D-077).
- À la fin, un skill de lecture meilleur (§4) : ses outils et son mode d'emploi. Il sert à l'analyste et à l'agent de diagnostic, donc chaque gain profite aux deux (accepté).
- Elle tourne sur n'importe quelles données, sans vérité connue : pas seulement sur les cinq cas validés (l'utilisateur).
- Elle tourne sur n'importe quelles données, sans vérité connue : pas seulement sur les cinq events validés (l'utilisateur).
**Non-buts.**
- Les détecteurs du journal : c'est `/boucle`.
- La base de cas : la séance n'ajoute aucun cas ; ce que le correcteur trouve de nouveau va au bilan, pour `/boucle` ou `/nouveau-cas` *(choix de Claude)*.
- Le raisonnement de diagnostic : classer, comparer aux cas, faire des hypothèses, conclure. Seule la lecture change.
- La base d'events : la séance n'ajoute aucun event ; ce que le correcteur trouve de nouveau va au bilan, pour `/boucle` ou `/new-event` *(choix de Claude)*.
- Le raisonnement de diagnostic : classer, comparer aux events, faire des hypothèses, conclure. Seule la lecture change.
- Récupérer les données (un dossier de station au format de `data/<STATION>/`, comme `/boucle`) ; les autres domaines.
- L'exhaustivité : pas de rejeu des lots déjà vus, comme `/boucle`.
**Ce qui serait un échec.**
- **Des outils qui jugent** : un seuil, une catégorie, « anomalie ici » dans ce que rend un outil. Ils deviendraient des détecteurs de plus, et l'analyste finirait par valider ce qu'il lit (accepté).
- **Des outils taillés pour les cas** : un outil qui « sait » où chercher la buée de C-001, une règle propre à une station, à un capteur ou à une date (accepté).
- **Des outils taillés pour les events** : un outil qui « sait » où chercher la buée de E-001, une règle propre à une station, à un capteur ou à une date (accepté).
- **La complexité** : des outils qui se multiplient et un mode d'emploi qui s'allonge pour un petit gain (même crainte que pour `/boucle`, accepté).
- Casser une commande citée par une fiche de cas : les fiches C-001 à C-005 citent des commandes de `resume.py`, `inventaire.py` et `vignettes.py` avec leurs options, et les cas existants ne se modifient jamais *(constaté dans les fiches)*.
- Casser une commande citée par une fiche d'events : les fiches E-001 à E-005 citent des commandes de `resume.py`, `inventaire.py` et `vignettes.py` avec leurs options, et les events existants ne se modifient jamais *(constaté dans les fiches)*.
- Un lecteur qui voit le corrigé, ou un correcteur qui lit avec les outils qu'on améliore : la mesure ne vaudrait plus rien.
## 3. Ce qui existe
- **Les outils de lecture**, `agent-tools/` (419 lignes) : `donnees.py` (lecture commune des exports), `inventaire.py`, `resume.py`, `graphique.py` (PNG des séries), `vignettes.py` (gros plans des capteurs sur les images). Bibliothèque standard, matplotlib par `.venv` pour les figures. Ils rendent des valeurs, jamais des verdicts.
- **Leur mode d'emploi est recopié à deux endroits** : le tableau « Tes outils » et l'étape 1 de `.claude/skills/critiquer-lot/SKILL.md` (l'analyste), le §3 et une partie du §4 (étapes 1, 2 et 4) de `agent-diagnostic/instructions.md` (l'agent de diagnostic).
- **Les cinq cas validés**, `events/C-001/` à `C-005/` : données (`displacement/`, `images/`), fiche `cas.md` (signature en critères, avec leurs commandes) et figures, dans le même dossier.
- **Les cinq events validés**, `events/E-001/` à `E-005/` : données (`displacement/`, `images/`), fiche `event.md` (signature en critères, avec leurs commandes) et figures, dans le même dossier.
- **Le modèle de `/boucle`** (D-057, `vues-deplacements/contexte/boucle-automatique.md`, skill `.claude/skills/boucle/SKILL.md`) : un skill orchestrateur dans la conversation principale, des sous-agents qui ne se parlent pas et écrivent chacun un rendu, une ligne `**Verdict** :` lue par `grep`, des commits par chemin, une branche par séance, un `bilan.md`. Un passage de l'analyste coûte environ 250 000 jetons et 8 min 30 (essai du 2026-10-24).
## 4. Ce qu'on optimise : le skill `lire-les-donnees`
@@ -44,7 +44,7 @@ Un skill, `.claude/skills/lire-les-donnees/SKILL.md`, devient la seule source du
- la méthode de lecture d'un lot : inventaire ; large puis zoom ; chaque capteur face à son propre niveau habituel ; vignettes espacées, plus serrées là où les courbes bougent, avec un capteur témoin ; images entières pour la scène ;
- ce que la lecture rend : une ligne par moment (début, fin, capteurs, colonnes, ce qu'on voit, ce que montrent les images).
Il ne contient ni catégorie, ni cas, ni hypothèse, ni verdict : c'est l'affaire de celui qui l'appelle.
Il ne contient ni catégorie, ni event, ni hypothèse, ni verdict : c'est l'affaire de celui qui l'appelle.
**Ceux qui l'utilisent** : l'analyste (« Tes outils » et l'étape 1 de `critiquer-lot` renvoient au skill ; l'étape 1 garde la catégorie de la carte, ajoutée après la lecture), l'agent de diagnostic (le §3 de ses instructions renvoie au skill et garde la ligne `categories.py` et la remarque sur `--sortie` ; ses étapes de diagnostic ne changent pas) et le lecteur (§6). Les sous-agents le lisent par Read, comme l'analyste lit `critiquer-lot` *(choix de Claude)*.
@@ -69,9 +69,9 @@ Il ne contient ni catégorie, ni cas, ni hypothèse, ni verdict : c'est l'affair
La séance suivante tourne avec le skill tel qu'il est devenu.
**Commandes des fiches, une fois, en fin de séance** : l'orchestrateur lance les commandes que citent les fiches de la base de cas (pas d'agent) ; les échecs vont au bilan. Rien n'est annulé d'office : le bilan le dit et l'utilisateur décide. Il n'y a plus de contrôle de lecture sur les cinq cas validés (D-064) : l'utilisateur a validé les diagnostics de ces cas, pas les outils qui les lisent.
**Commandes des fiches, une fois, en fin de séance** : l'orchestrateur lance les commandes que citent les fiches de la base d'events (pas d'agent) ; les échecs vont au bilan. Rien n'est annulé d'office : le bilan le dit et l'utilisateur décide. Il n'y a plus de contrôle de lecture sur les cinq events validés (D-064) : l'utilisateur a validé les diagnostics de ces events, pas les outils qui les lisent.
**Bilan** : `bilan.md`, une ligne pour le lot (verdict du premier écart ; passages gardés, annulés ; verdict du dernier écart), les commandes des fiches en échec, les manques imputés au lecteur (que le skill ne pouvait pas corriger), les nouveautés vues par le correcteur (pour `/boucle` ou `/nouveau-cas`), les erreurs. Commit.
**Bilan** : `bilan.md`, une ligne pour le lot (verdict du premier écart ; passages gardés, annulés ; verdict du dernier écart), les commandes des fiches en échec, les manques imputés au lecteur (que le skill ne pouvait pas corriger), les nouveautés vues par le correcteur (pour `/boucle` ou `/new-event`), les erreurs. Commit.
**Difficultés** : le releveur note celles de la séance (D-060) ; avec `--ameliorer`, l'améliorateur (`.claude/agents/ameliorateur.md`, le même que pour `/boucle`) corrige ensuite le skill `/aiguiser`, ses agents, `voir.py`, cette spec et `run.md` d'après ces relevés, et marque les entrées **traité** ; les outils de lecture et `lire-les-donnees` restent à l'optimiseur (D-076). Commit `Sharpen <STATION>: process fixes`.
@@ -87,7 +87,7 @@ Lancé par l'utilisateur seulement (`disable-model-invocation: true`). Il dérou
### Lecteur : `.claude/agents/lecteur.md`
Il teste le skill : il lit `lire-les-donnees/SKILL.md` et le suit, rien d'autre. Outils : Read, Bash, Write. Il lit le dossier de station par les outils du skill, les images par Read, et les deux notes de `docs/domaine/` que le skill cite. **Il ne lit pas** : les détecteurs ni leur sortie, la base de cas, la carte des événements, les rendus de la séance (ni le corrigé, ni les écarts, ni les modifications), `CLAUDE.md`, `docs/decisions.md`, `vues-deplacements/` hors du dossier de station, les autres séances de `aiguiser/` et `boucle/`. Il n'écrit aucun script.
Il teste le skill : il lit `lire-les-donnees/SKILL.md` et le suit, rien d'autre. Outils : Read, Bash, Write. Il lit le dossier de station par les outils du skill, les images par Read, et les deux notes de `docs/domaine/` que le skill cite. **Il ne lit pas** : les détecteurs ni leur sortie, la base d'events, la carte des événements, les rendus de la séance (ni le corrigé, ni les écarts, ni les modifications), `CLAUDE.md`, `docs/decisions.md`, `vues-deplacements/` hors du dossier de station, les autres séances de `aiguiser/` et `boucle/`. Il n'écrit aucun script.
`lecture-K.md` : le tableau des moments (début, fin, capteurs, colonnes, ce que je vois, ce que montrent les images) ; **ce qui m'a manqué** : où il a peiné, ce qu'il aurait voulu pouvoir regarder ; les sources lues. Ses figures dans `lot-NN/lecture-K/`, une lecture par dossier, pour qu'une lecture n'écrase pas les figures d'une autre (même nom de PNG).
@@ -95,7 +95,7 @@ Il teste le skill : il lit `lire-les-donnees/SKILL.md` et le suit, rien d'autre.
C'est le validateur des outils de lecture ; « correcteur » parce qu'il compare une copie à un corrigé (accepté). Outils : Read, Bash, Write. Deux demandes :
- **Lecture lente** : il lit le lot sans limite, avec **ses propres scripts** (bibliothèque standard, matplotlib par `.venv`), rangés avec ses figures dans `lot-NN/corrige/`, sur les exports bruts, et autant d'images qu'il le juge utile. Il peut lire `docs/domaine/` et la carte des événements. **Il n'utilise pas** `agent-tools/`, pas même `donnees.py` (une erreur de lecture commune passerait inaperçue) *(choix de Claude)*, ne lit pas `lire-les-donnees/SKILL.md`, ni les détecteurs, ni la base de cas, et il écrit `corrige.md` **avant** d'ouvrir la lecture. `corrige.md` a le même tableau que la lecture, pour comparer ligne à ligne *(choix de Claude)*. Puis il écrit l'écart (ci-dessous).
- **Lecture lente** : il lit le lot sans limite, avec **ses propres scripts** (bibliothèque standard, matplotlib par `.venv`), rangés avec ses figures dans `lot-NN/corrige/`, sur les exports bruts, et autant d'images qu'il le juge utile. Il peut lire `docs/domaine/` et la carte des événements. **Il n'utilise pas** `agent-tools/`, pas même `donnees.py` (une erreur de lecture commune passerait inaperçue) *(choix de Claude)*, ne lit pas `lire-les-donnees/SKILL.md`, ni les détecteurs, ni la base d'events, et il écrit `corrige.md` **avant** d'ouvrir la lecture. `corrige.md` a le même tableau que la lecture, pour comparer ligne à ligne *(choix de Claude)*. Puis il écrit l'écart (ci-dessous).
- **Écart seul** : `corrige.md`, la nouvelle lecture et le dernier écart ; il peut revenir aux données pour trancher (le lecteur a pu voir juste là où le corrigé s'est trompé : alors il corrige le corrigé et le dit).
`ecart-K.md` :
@@ -133,7 +133,7 @@ Il reprend les défauts du dernier écart (et la modification annulée, s'il y e
- Il ne touche qu'à `agent-tools/` et à `lire-les-donnees/SKILL.md` (§4).
- **Le plus simple d'abord** (accepté) : une phrase du mode d'emploi ou un réglage par défaut ; sinon une option d'un outil existant ; un nouvel outil en dernier recours.
- **Interdits** (accepté) : aucun jugement dans ce que rend un outil (ni seuil, ni catégorie, ni « anomalie ») ; rien de propre à une station, à un capteur ou à une date ; aucun import des détecteurs (`detectors/`) ; bibliothèque standard, matplotlib pour les figures seulement.
- **Ne rien casser** : les options et les sorties existantes restent ; une commande citée par une fiche de cas marche toujours *(constaté dans les fiches)*. Il relance l'outil modifié sur le lot, et une commande d'une fiche qui l'emploie.
- **Ne rien casser** : les options et les sorties existantes restent ; une commande citée par une fiche d'events marche toujours *(constaté dans les fiches)*. Il relance l'outil modifié sur le lot, et une commande d'une fiche qui l'emploie.
- `modification-K.md` : le défaut traité, ce qui a changé et pourquoi, la commande de l'essai et ce qu'elle rend, ce qu'il n'a pas pu faire.
## 7. Coût
@@ -160,7 +160,7 @@ Ordre de grandeur, à mesurer au premier essai : une lecture ≈ un passage de l
## 10. Laissé au constructeur
Le texte des consignes de chaque agent ; le format exact des messages de commit ; le lot (la plage donnée, sans découpe, D-078) ; comment le lecteur lit un cas sans voir sa fiche ni ses figures au contrôle (proposition : un dossier de liens vers `displacement/` et `images/`, hors du dépôt) ; ce qui reste du §3 et du §4 des instructions de l'agent de diagnostic une fois le mode d'emploi passé dans le skill, sans changer son raisonnement ; le mode de permission qui laisse une séance tourner sans demander d'accord (le correcteur écrit et lance des scripts).
Le texte des consignes de chaque agent ; le format exact des messages de commit ; le lot (la plage donnée, sans découpe, D-078) ; comment le lecteur lit un event sans voir sa fiche ni ses figures au contrôle (proposition : un dossier de liens vers `displacement/` et `images/`, hors du dépôt) ; ce qui reste du §3 et du §4 des instructions de l'agent de diagnostic une fois le mode d'emploi passé dans le skill, sans changer son raisonnement ; le mode de permission qui laisse une séance tourner sans demander d'accord (le correcteur écrit et lance des scripts).
À faire avec la construction : une entrée D-059 dans `docs/decisions.md` (le skill de lecture, seule source du mode d'emploi ; `/aiguiser` ; ce qui reste de « ses outils propres » de D-058) ; une ligne dans `CLAUDE.md` et dans `vues-deplacements/CLAUDE.md` ; dans `boucle-automatique.md` (§3), les outils ne sont plus « utilisés tels quels » mais évoluent par `/aiguiser` ; la spec de l'agent de diagnostic, `docs/agents/agent-diagnostic.md`, pour le renvoi au skill.
@@ -4,10 +4,10 @@ Point 31 du plan `docs/superpowers/plans/2026-10-23-journal-du-matin.md`, brains
## 1. Pourquoi
L'utilisateur veut que Claude apprenne sur des lots entiers de données de stations, sans lui : passer les détecteurs du journal du matin sur un lot, juger leurs résultats comme le ferait un expert, en regardant lui-même les courbes et les images, corriger les détecteurs, et garder sous forme de cas tout ce qui est nouveau. Puis passer au lot suivant.
L'utilisateur veut que Claude apprenne sur des lots entiers de données de stations, sans lui : passer les détecteurs du journal du matin sur un lot, juger leurs résultats comme le ferait un expert, en regardant lui-même les courbes et les images, corriger les détecteurs, et garder sous forme d'events tout ce qui est nouveau. Puis passer au lot suivant.
À la fin d'une séance, il reste deux choses durables (l'utilisateur) :
1. **de la connaissance** : de nouveaux cas, appris sur des événements réels, de la même forme que C-001 à C-005, ajoutés à la même base de cas, `events/` : tous les cas sont au même endroit (l'utilisateur) ;
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.
@@ -19,14 +19,14 @@ L'analyste et le validateur ne laissent rien de durable eux-mêmes : ce sont les
**Non-buts.**
- Récupérer les données : la boucle prend un dossier de station tel quel, au format de `data/<STATION>/` (export « advanced » dans `displacement/`, images dans `images/`), qu'il vienne du pompage (`extraction/pomper.py`, point 27) ou de CSV et d'images téléchargés à la main.
- Les autres domaines (Energy, Storage, Cellular, Temperature) : les déplacements seulement.
- **L'agent de diagnostic** (`diagnostic`, D-046) : il n'entre pas en jeu ici, à aucun moment il n'a de travail dans la boucle (l'utilisateur, 2026-10-24). Il sert au diagnostic pour l'utilisateur ; on le traitera dans une autre conversation, y compris ce que les cas appris changent pour lui. La boucle ne touche pas à ses consignes ; elle ne fait que compléter la base de cas.
- **L'agent de diagnostic** (`diagnostic`, D-046) : il n'entre pas en jeu ici, à aucun moment il n'a de travail dans la boucle (l'utilisateur, 2026-10-24). Il sert au diagnostic pour l'utilisateur ; on le traitera dans une autre conversation, y compris ce que les events appris changent pour lui. La boucle ne touche pas à ses consignes ; elle ne fait que compléter la base d'events.
- L'exhaustivité : **pas de rejeu** des lots déjà vus par l'analyste, pas de revalidation générale après chaque modification ; on explore des données et on améliore peu à peu (l'utilisateur). Le score (D-062, §5) rejoue les lots d'avant sans regard de Claude, sur leurs étiquettes.
- Revalider les cas appris : peut-être plus tard, à la main, pas maintenant (l'utilisateur).
- Revalider les events appris : peut-être plus tard, à la main, pas maintenant (l'utilisateur).
- Plusieurs analystes en parallèle : plus tard (annexe).
**Ce qui serait un échec.**
- **La complexité** : des détecteurs qui gonflent de règles et de cas particuliers pour un petit gain (la crainte de l'utilisateur).
- Toucher aux cas validés C-001 à C-005, ou aux catégories du journal, validées au point 5 du plan *(choix de Claude)*.
- Toucher aux events validés E-001 à E-005, ou aux catégories du journal, validées au point 5 du plan *(choix de Claude)*.
- Un détecteur cassé qui disparaît sans bruit : le chargeur de `categories.py` saute, avec un simple message, un fichier qui ne se charge pas *(constaté dans le code)*.
## 3. Ce qui existe et que la boucle réutilise
@@ -34,7 +34,7 @@ L'analyste et le validateur ne laissent rien de durable eux-mêmes : ce sont les
- Les détecteurs du journal : `detectors/*.py`, contrat `detect(mesures)`, classés en événements par `categories.py`. Le tri en lot existe (point 30, validé) : `python3 detectors/categories.py <dossier> --du AAAA-MM-JJ --au AAAA-MM-JJ --tranche 4 --historique 3`. Chaque lot est classé avec les 3 jours d'avant : c'est la règle pour la boucle (D-056).
- Les outils de lecture des données, `agent-tools/` : `inventaire.py`, `resume.py`, `graphique.py` (PNG des séries), `vignettes.py` (gros plans des cibles sur les images) ; leur mode d'emploi est le skill `.claude/skills/lire-les-donnees/`, que suit l'analyste ; ils évoluent par `/aiguiser` (D-059, `aiguiser-la-lecture.md`), pas par la boucle. Seuls les outils servent : l'agent de diagnostic, lui, n'est pas appelé.
- La carte des événements, `events/carte-des-evenements.md` : ce qui peut arriver, en familles, et les catégories du journal (section 4).
- La base de cas, `events/` : l'index `INDEX.md`, le modèle de fiche (§11.3 de `docs/agents/agent-diagnostic.md`), le skill `anonymiser-cas` (données copiées dans le dossier du cas, noms codés, D-049, D-050). Les cas existants ne se modifient jamais ; la boucle en ajoute.
- La base d'events, `events/` : l'index `INDEX.md`, le modèle de fiche (§11.3 de `docs/agents/agent-diagnostic.md`), le skill `anonymize-event` (données copiées dans le dossier de l'event, noms codés, D-049, D-050). Les events existants ne se modifient jamais ; la boucle en ajoute.
- Le registre des seuils, `vues-deplacements/contexte/seuils-du-journal.md` : une constante changée le met à jour dans le même changement.
## 4. Une séance
@@ -48,11 +48,11 @@ L'analyste et le validateur ne laissent rien de durable eux-mêmes : ce sont les
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).
5. **Builder** : s'il y a des nouveautés dans les rendus du lot, il ajoute les cas à la base, `events/`, et écrit `builder.md`. Un commit pour les cas du lot (ils partagent la ligne d'index).
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.
**Comment les agents communiquent** *(choix de Claude, accepté le 2026-10-24)*. Ils ne se parlent pas. Chacun reçoit de l'orchestrateur un prompt court : le dossier de station, les dates du lot, les chemins des fichiers à lire. Il écrit son rendu dans le dossier du lot et répond en quelques lignes (verdict, chemins). L'orchestrateur est le seul à commiter ; il commite par chemin, pour ne rien emporter d'autre (message `Loop <STATION> lot NN: <rôle> …`), et vérifie avant chaque commit que la branche est encore `master` (une autre session a pu en changer : il ne commite plus et le dit au bilan) ; un fichier qu'une autre session a déjà modifié sur les chemins de la séance (détecteurs, seuils, base de cas, registre) n'est ni commité ni annulé, et va au bilan sous « Erreurs ». Les agents prennent le modèle et l'effort de la session qui lance `/boucle` (`model: inherit`, sans `effort`, l'utilisateur, 2026-10-26, D-063 ; d'abord sur Opus).
**Comment les agents communiquent** *(choix de Claude, accepté le 2026-10-24)*. Ils ne se parlent pas. Chacun reçoit de l'orchestrateur un prompt court : le dossier de station, les dates du lot, les chemins des fichiers à lire. Il écrit son rendu dans le dossier du lot et répond en quelques lignes (verdict, chemins). L'orchestrateur est le seul à commiter ; il commite par chemin, pour ne rien emporter d'autre (message `Loop <STATION> lot NN: <rôle> …`), et vérifie avant chaque commit que la branche est encore `master` (une autre session a pu en changer : il ne commite plus et le dit au bilan) ; un fichier qu'une autre session a déjà modifié sur les chemins de la séance (détecteurs, seuils, base d'events, registre) n'est ni commité ni annulé, et va au bilan sous « Erreurs ». Les agents prennent le modèle et l'effort de la session qui lance `/boucle` (`model: inherit`, sans `effort`, l'utilisateur, 2026-10-26, D-063 ; d'abord sur Opus).
**Sans question** : la séance tourne seule jusqu'au bout. Si un agent ne rend pas son fichier, l'orchestrateur le note dans le bilan et passe au lot suivant *(choix de Claude)*.
@@ -62,7 +62,7 @@ Chaque rôle est un sous-agent de Claude Code, défini dans `.claude/agents/<rô
### Orchestrateur : skill `.claude/skills/boucle/SKILL.md`
Lancé par l'utilisateur seulement (comme `/nouveau-cas`). Il déroule le §4 et ne juge rien lui-même.
Lancé par l'utilisateur seulement (comme `/new-event`). Il déroule le §4 et ne juge rien lui-même.
### Analyste : `.claude/agents/analyste.md`, avec le skill `critiquer-lot`
@@ -71,7 +71,7 @@ La critique est un skill à part, à la demande de l'utilisateur ; on peut aussi
1. **Sa propre lecture d'abord, sans la sortie des détecteurs** *(choix de Claude)* : sinon il ne trouverait jamais ce que les détecteurs ratent. Inventaire, courbes du lot avec `graphique.py`, vignettes espacées (une toutes les 2 à 3 h) et plus serrées là où les courbes bougent, images entières pour la scène. 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. **Puis** la sortie de `categories.py` pour le lot.
3. **Comparaison**, événement par événement : juste ; catégorie fausse ; en trop ; bornes fausses (en retard, trop large) ; manquant.
4. **Puis les cas**, après les faits (sinon il chercherait ce que dit un cas au lieu de ce que montrent les données) : l'index `events/INDEX.md`, avec les cas appris aux lots et aux séances d'avant.
4. **Puis les events**, après les faits (sinon il chercherait ce que dit un event au lieu de ce que montrent les données) : l'index `events/INDEX.md`, avec les events appris aux lots et aux séances d'avant.
5. **Verdict** : « d'accord » (rien d'important à corriger), ou des **suggestions, au plus deux**, les plus importantes *(choix de Claude, contre la complexité)* : le défaut, l'exemple (moment, capteurs), le détecteur en cause, ce qu'il faudrait, en mots et non en code.
6. **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.
@@ -81,7 +81,7 @@ La critique est un skill à part, à la demande de l'utilisateur ; on peut aussi
**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.
**Benchmark** (D-069, point 48 du plan, ajouté le 2026-10-26 à la demande de l'utilisateur) : chaque cas 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 cas 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 de cas, les détecteurs se régleraient sur eux, choix de l'utilisateur). Le builder donne ses étiquettes à chaque cas créé (`anonymiser.py --etiquettes`) ; C-001 à C-005 ont reçu les leurs d'un passage unique de l'analyste, corrigé par leur fiche (leur `etiquetage.md`). Limite : un cas 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) ; 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.
### Upgrader : `.claude/agents/upgrader.md`
@@ -92,7 +92,7 @@ Il reprend les suggestions de l'analyste (et la dernière validation, s'il y en
- **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 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 de cas (D-069) : un recul net sur un cas est un recul, la ligne `a_verifier` de C-004 ne baisse pas ; une hausse est un plus, pas un but.
- 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.
### Validateur : `.claude/agents/validateur.md`
@@ -107,11 +107,11 @@ Il sait que l'upgrader est passé : il lit la critique, la modification et le di
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 »).
- **Une seule base** (l'utilisateur) : `events/`, à côté de C-001 à C-005 ; numéro suivant de l'index (`C-006`…), comme `/nouveau-cas`.
- **Un cas par genre d'événement, pas par occurrence** *(choix de Claude)* : si un cas 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 cas est « déjà connue », la contradiction dite pour l'utilisateur.
- Sinon, un cas de la même forme que C-001 à C-005 : données de la fenêtre de l'événement, avec une marge, copiées et codées par `anonymiser-cas` (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.
- **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 cas existants. Il ne passe pas par `/nouveau-cas` (ni passage à l'aveugle, ni validation) : les cas appris s'ajoutent sans attendre (l'utilisateur : « ça ne peut pas vraiment faire de mal »).
- 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 »).
### Releveur : `.claude/agents/releveur.md` (D-060)
@@ -124,7 +124,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 ; cas 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 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.
- `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.
@@ -136,14 +136,14 @@ Ajouté le 2026-10-26 à la demande de l'utilisateur, seulement si `/boucle` est
## 8. Laissé au constructeur
Le texte des consignes de chaque agent ; le format exact des messages de commit ; la découpe des lots (en lisant l'en-tête de `categories.py` ou en la calculant) ; les colonnes des courbes de l'analyste ; la marge autour d'un événement pour les données d'un cas (proposition : 6 h ; seulement la fenêtre, pas tout le lot, pour ne pas commiter des centaines d'images par cas) ; une option de fenêtre dans `anonymiser.py` si elle manque (vérifiée par son `--test`) ; le mode de permission qui laisse une séance tourner sans demander d'accord.
Le texte des consignes de chaque agent ; le format exact des messages de commit ; la découpe des lots (en lisant l'en-tête de `categories.py` ou en la calculant) ; les colonnes des courbes de l'analyste ; la marge autour d'un événement pour les données d'un event (proposition : 6 h ; seulement la fenêtre, pas tout le lot, pour ne pas commiter des centaines d'images par cas) ; une option de fenêtre dans `anonymiser.py` si elle manque (vérifiée par son `--test`) ; le mode de permission qui laisse une séance tourner sans demander d'accord.
À faire avec la construction : une entrée D-057 dans `docs/decisions.md` (la boucle ; la base de cas s'enrichit aussi par le builder, sans `/nouveau-cas`, ce qui complète D-048 ; l'agent de diagnostic hors de la boucle), une ligne dans `CLAUDE.md` et dans `vues-deplacements/CLAUDE.md`.
À faire avec la construction : une entrée D-057 dans `docs/decisions.md` (la boucle ; la base d'events s'enrichit aussi par le builder, sans `/new-event`, ce qui complète D-048 ; l'agent de diagnostic hors de la boucle), une ligne dans `CLAUDE.md` et dans `vues-deplacements/CLAUDE.md`.
## 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.
- La revalidation des cas appris par l'utilisateur.
- 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.
- Plusieurs stations par séance.
@@ -46,7 +46,7 @@ Hors ligne, dans Support-Agent, à la main de l'utilisateur (pas de LLM à chaqu
3. **Tri sans image** : les détecteurs de `detectors/` tournent sur la tranche et sortent une table d'épisodes (début, fin, étiquette, capteurs). Coût : ordinateur seul, et c'est ce qui décide la suite.
4. **Regard de Claude, choisi** : Claude ne regarde que les tranches où les détecteurs voient quelque chose ou **ne voient rien malgré un signal fort** (saut ou tendance de `detection-d-anomalies.md`), et seulement les courbes et 4 à 8 vignettes par épisode, pas toutes les images. C'est l'étape chère : un plafond de tranches regardées par séance, fixé à l'avance.
5. **Critique** : par épisode, Claude dit s'il est d'accord (étiquette juste), en retard ou en trop (faux positif), ou s'il manque un épisode ; il écrit son verdict dans un fichier de revue de la tranche, hors de la vue de l'agent (règle de `vues-deplacements/CLAUDE.md`).
6. **Proposition** : au plus deux sorties, soit un réglage chiffré d'un détecteur (seuil, durée) avec les épisodes qui changent, soit un cas candidat. Les cas n'entrent dans la base que sur demande de l'utilisateur (`/nouveau-cas`) ; Claude propose, ne crée pas.
6. **Proposition** : au plus deux sorties, soit un réglage chiffré d'un détecteur (seuil, durée) avec les épisodes qui changent, soit un event candidat. Les events n'entrent dans la base que sur demande de l'utilisateur (`/new-event`) ; Claude propose, ne crée pas.
7. **Rejeu** : le détecteur modifié est relancé sur **toutes** les tranches déjà vues (gratuit, étape 3) pour vérifier qu'il ne casse rien ; seulement alors on passe à la tranche suivante.
8. **Arrêt** : à la fin du plafond de la séance, ou quand deux tranches de suite ne donnent plus rien à corriger. Les données déjà regardées ne sont pas relues ; le fichier de revue sert de mémoire.
+10 -10
View File
@@ -7,7 +7,7 @@ Notes de la conversation vocale du 2026-10-23 (utilisateur, après échange avec
- Le projet s'est éparpillé : beaucoup d'analyses fines (sauts, tendances, compensation, agent de diagnostic) ; important, mais on s'y perd.
- Revenir à du simple, terre à terre, côté **support** : des analyses élémentaires, qui **discréditent** certaines zones plutôt qu'elles ne mesurent des variations.
- Changement de regard sur l'anomalie : ce n'est pas d'abord un vrai déplacement de l'ouvrage, ce sont surtout des « trucs nuls » : un train qui passe, de la neige ou une toile d'araignée sur une cible, la pluie, la buée, le soleil, la turbulence, plus assez de références (alors tout bouge un peu). **Une anomalie = un moment où il ne faut pas prendre les données en compte.**
- **Précision de l'utilisateur (2026-10-24)** : une anomalie, c'est **tout ce qui sort de la norme**, tout ce qui fait que les courbes ne sont pas plates alors que rien ne bouge. Dans l'écrasante majorité des cas, ce n'est absolument pas grave (perte de visibilité et toutes les catégories de la carte) ; mais parfois c'est grave, d'un autre type : à Barcelone, la voûte du pont s'affaisse vraiment.
- **Précision de l'utilisateur (2026-10-24)** : une anomalie, c'est **tout ce qui sort de la norme**, tout ce qui fait que les courbes ne sont pas plates alors que rien ne bouge. Dans l'écrasante majorité des events, ce n'est absolument pas grave (perte de visibilité et toutes les catégories de la carte) ; mais parfois c'est grave, d'un autre type : à Barcelone, la voûte du pont s'affaisse vraiment.
## L'idée : le journal du matin
@@ -16,7 +16,7 @@ Notes de la conversation vocale du 2026-10-23 (utilisateur, après échange avec
- Les courbes de déplacement, **toutes les données gardées** ; dessous, des **barres étiquetées** (une bande colorée : « mauvaise météo », « mauvaise visibilité », « effet thermique », la catégorie trouvée) ; les zones à ignorer **grisées** sur les courbes, sans retirer les points.
- Deux familles de ce qui peut se passer : des conditions qui gâtent la mesure (météo, visibilité, turbulence, cycle thermique) et, plus rarement, un vrai mouvement.
- Courbes en **pixels** (suggestion du supérieur) plutôt qu'en mm : on y voit les mêmes choses ; premier essai en px (`corr_x`, `corr_y` de l'export « advanced », à la cadence native).
- Une visualisation **très simple**, « bateau », comme les cas de la base (pluie, toile d'araignée, train…).
- Une visualisation **très simple**, « bateau », comme les events de la base (pluie, toile d'araignée, train…).
- Garder les **images** et la technique des petits **GIF** (vignettes animées) : on voit tout de suite qu'on a perdu les cibles. Pas dans la v0.
- Objectif de contrôle : si on donnait les mêmes données à Claude, il devrait voir de lui-même les mêmes catégories ; notre solution doit dire ce que Claude dirait.
@@ -30,7 +30,7 @@ Un orchestrateur (la conversation principale) et un agent par piste, qui rapport
| Taux d'erreur | entre 2 h et 3 h, d'un coup beaucoup de perturbations : un flag « grand taux d'erreur des cibles », moyenne sur les cibles | `detectors/visibilite.py` |
| Cycle thermique | chaque jour de grosses vagues : tout chauffe, bouge un peu, puis refroidit à la tombée de la nuit, très prévisible ; vu seul ça paraît bizarre, vu chaque jour c'est normal | `detectors/thermique.py` |
| Turbulence atmosphérique | des petites vagues, du bruit, à expliquer au client | `detectors/turbulence.py` |
| Cartographie des cas | il n'y a pas 36 000 options : un diagramme (Mermaid) de tous les cas rencontrés, branchés (mauvais temps, train, obstruction…), à partir des catégories déjà dans le projet | `events/carte-des-evenements.md` |
| Cartographie des events | il n'y a pas 36 000 options : un diagramme (Mermaid) de tous les events rencontrés, branchés (mauvais temps, train, obstruction…), à partir des catégories déjà dans le projet | `events/carte-des-evenements.md` |
| Page | une page dans Explore : les courbes, les barres dessous, les zones grisées | onglet `Journal` de `vues-deplacements/maquette/` |
| Volet 2 : lissage | le premier volet ne touche pas aux données et les interprète ; un second les lisse ; peur que ce soit trop complexe : un agent dit ce qui existe et ce qui est possible | `vues-deplacements/contexte/lissage.md` |
| Données et boucle | récupérer les données pour travailler hors de l'application, puis boucler Claude dessus | `vues-deplacements/contexte/donnees-et-boucle.md` |
@@ -42,7 +42,7 @@ Un orchestrateur (la conversation principale) et un agent par piste, qui rapport
- **A**, préférée pour l'instant : un dossier de scripts **dédié, séparé de tout le reste**, que l'utilisateur lance dans le dev container pour pomper les données de nombreuses stations sur de grandes plages (déplacements, images, images différentielles), par lots ; quelques centaines de Go acceptables ;
- **B** : un petit client qui interroge directement la base avec le même protocole d'authentification que l'application (identifiants de l'utilisateur), et un site HTML / JS local qui fait le même travail ; avantage : ne récupérer que le nécessaire ;
- **C** : demander au collègue l'infrastructure qui manque.
- La boucle, idée « super puissante » à faire intelligemment (elle consomme) : Claude prend une plage, lance les scripts de diagnostic, regarde lui-même les données et les images, critique les scripts, les améliore, crée un cas si besoin, passe à la plage suivante, et épluche ainsi toutes les données.
- La boucle, idée « super puissante » à faire intelligemment (elle consomme) : Claude prend une plage, lance les scripts de diagnostic, regarde lui-même les données et les images, critique les scripts, les améliore, crée un event si besoin, passe à la plage suivante, et épluche ainsi toutes les données.
- Calcul à la volée : aujourd'hui, le site calcule les analyses quand le client charge la page ; faire tourner un LLM à ce moment-là n'est pas raisonnable. Claude sert donc à **régler** les scripts hors ligne, pas à répondre en direct.
## Où l'on travaille
@@ -60,11 +60,11 @@ Un orchestrateur (la conversation principale) et un agent par piste, qui rapport
- Images différentielles (`OPTICAL_SHIFT-DIFF`) : pas « ce qui a changé » entre deux instants, mais l'image des réflecteurs, contraste renforcé, celle que mesure l'algorithme (`docs/domaine/images-de-la-camera.md`) ; jugées peu utiles pour `/boucle` et `/aiguiser` (utilisateur, 2026-10-26) ; point 28 du plan.
- D'autres métriques existent sur certains projets : un agent pourrait les passer en revue quand les données seront récupérées en masse.
- Effet périodique étiqueté comme tel (« periodic effect »), jugé encore poussé.
- Un cas de la base pour chaque catégorie de la carte, quand l'utilisateur les apporte.
- Un event de la base pour chaque catégorie de la carte, quand l'utilisateur les apporte.
## Retour de l'utilisateur sur la v0 (2026-10-23, le soir)
- « Pas trop mal », mais il veut **encore plus simple**, et surtout un diagnostic **catégorique et complet**, comme celui des cas étudiés par l'agent de diagnostic (`events/`) : pas de « most likely a measurement artefact » ni de « probably rain ».
- « Pas trop mal », mais il veut **encore plus simple**, et surtout un diagnostic **catégorique et complet**, comme celui des events étudiés par l'agent de diagnostic (`events/`) : pas de « most likely a measurement artefact » ni de « probably rain ».
- Exemple : sur NORDEND, le 14/10 vers 05:15, un immense saut monte puis redescend en quelques heures. Ce comportement se voit tout le temps ; il a plusieurs causes possibles, mais on veut clairement **invalider la zone**. Ici il n'y a pas d'ambiguïté : les cibles étaient perdues (intempéries, plein jour, aube…), et les images le montrent.
- **Cas par cas, isoler les scénarios** : un gros saut → trouver sa **catégorie** (celle de la carte des événements, d'où la demande d'un agent cartographe) → **exécuter le processus de la catégorie**. Pour la perte de visibilité, le processus est de **montrer les images** : le client voit le gros saut, lit la catégorie, voit qu'on ne distingue pas les cibles, comprend que ce n'est qu'une perte de visibilité et passe à la suite sans s'alarmer.
- Sous les courbes, le label dit **ce qui s'est passé** (la catégorie), pas le nom du détecteur.
@@ -84,7 +84,7 @@ Un orchestrateur (la conversation principale) et un agent par piste, qui rapport
## Carte des événements (point 3 du plan, 2026-10-24)
- La carte n'a pas à s'appuyer sur des cas vus dans les données (peu de données passées dans le projet) : elle doit **englober toutes les possibilités**, un ouvrier qui abîme une cible, « tout et n'importe quoi », rangées en **familles**. On part de la base et on complète au fur et à mesure : `events/carte-des-evenements.md` (33 événements, six familles).
- La carte n'a pas à s'appuyer sur des events vus dans les données (peu de données passées dans le projet) : elle doit **englober toutes les possibilités**, un ouvrier qui abîme une cible, « tout et n'importe quoi », rangées en **familles**. On part de la base et on complète au fur et à mesure : `events/carte-des-evenements.md` (33 événements, six familles).
## Page Journal simplifiée (point 8 du plan, 2026-10-24)
- Frise d'une seule ligne « What happened » et journal en cartes : validé, mais l'utilisateur n'est « pas entièrement satisfait » ; on pourrait **déplier** au lieu de tout mettre sur une même ligne (point 40 du plan).
@@ -95,7 +95,7 @@ Un orchestrateur (la conversation principale) et un agent par piste, qui rapport
## La boucle automatique (point 31 du plan, 2026-10-24)
- Idée de l'utilisateur : une boucle dans Claude Code, un orchestrateur et quatre rôles (analyste juge, upgrader des détecteurs, validateur pas trop strict, builder de cas), lot après lot ; détail au point 31 du plan.
- Idée de l'utilisateur : une boucle dans Claude Code, un orchestrateur et quatre rôles (analyste juge, upgrader des détecteurs, validateur pas trop strict, builder d'events), lot après lot ; détail au point 31 du plan.
- Idée de l'utilisateur (2026-10-26) : préparer les lots de NORDEND de septembre, en cours de pompage, pour la boucle ; les lots se découpent seuls, restent l'historique, les images et le choix des lots (point 31 du plan).
## Aiguiser la lecture (point 42 du plan, 2026-10-24)
@@ -123,9 +123,9 @@ Un orchestrateur (la conversation principale) et un agent par piste, qui rapport
- Consigne de l'utilisateur : les détecteurs doivent tout détecter ; ce qu'on montre au client ou pas n'est pas la question ici (D-068). Les réglages pris pour l'affichage (points 13 et 41, `MISSING`) n'arrêtent plus la boucle ; la couche d'affichage viendra plus tard.
## Benchmark sur la base de cas (point 48 du plan, 2026-10-26)
## Benchmark sur la base d'events (point 48 du plan, 2026-10-26)
- Idée de l'utilisateur : une étape benchmark dans `/boucle`, les détecteurs face au diagnostic gardé dans chaque cas, purement analytique, versionnée, le score quantifié à chaque passage et pris en compte par l'upgrader. Proposition de Claude et questions dans le plan.
- Idée de l'utilisateur : une étape benchmark dans `/boucle`, les détecteurs face au diagnostic gardé dans chaque event, purement analytique, versionnée, le score quantifié à chaque passage et pris en compte par l'upgrader. Proposition de Claude et questions dans le plan.
## Le graphe des éventualités (point 49 du plan, 2026-10-27)
+23 -23
View File
@@ -1,6 +1,6 @@
# Seuils du journal du matin : le registre
Tous les seuils des détecteurs du journal (`detectors/`) sont **provisoires** : réglés sur les six jeux des cas C-001 à C-005 et de NORDEND d'octobre. Quand les données en masse arriveront (partie VI du plan `docs/superpowers/plans/2026-10-23-journal-du-matin.md`), c'est la liste à revoir. Une constante ajoutée ou changée met à jour ce fichier dans le même changement. Contrôle : `grep -nE "^[A-Z_0-9]+ = " detectors/*.py`.
Tous les seuils des détecteurs du journal (`detectors/`) sont **provisoires** : réglés sur les six jeux des events E-001 à E-005 et de NORDEND d'octobre. Quand les données en masse arriveront (partie VI du plan `docs/superpowers/plans/2026-10-23-journal-du-matin.md`), c'est la liste à revoir. Une constante ajoutée ou changée met à jour ce fichier dans le même changement. Contrôle : `grep -nE "^[A-Z_0-9]+ = " detectors/*.py`.
Registre au 2026-10-24 (point 17 du plan), vérifié contre le code.
@@ -8,31 +8,31 @@ Les détecteurs doivent tout détecter (l'utilisateur, 2026-10-26, D-068) : un r
| Détecteur | Constante | Valeur | Réglée sur |
|---|---|---|---|
| `visibilite` | `K_MAD` | 10 | C-001 (buée 11 à 57 MAD), C-005 (10 à 70 MAD) |
| | `FACTEUR` | 2 | écarte les capteurs à MAD quasi nulle (C-004, C-005) |
| | `SUITE_MIN` | 3 | C-001, pluie de C-005 |
| | `BREF_MIN` | 3 | trains de C-005 (5 à 17 capteurs) |
| | `SAILLIE` | 3 | trains (5 à 17) contre toile de C-002 (2 à 9) |
| `visibilite` | `K_MAD` | 10 | E-001 (buée 11 à 57 MAD), E-005 (10 à 70 MAD) |
| | `FACTEUR` | 2 | écarte les capteurs à MAD quasi nulle (E-004, E-005) |
| | `SUITE_MIN` | 3 | E-001, pluie de E-005 |
| | `BREF_MIN` | 3 | trains de E-005 (5 à 17 capteurs) |
| | `SAILLIE` | 3 | trains (5 à 17) contre toile de E-002 (2 à 9) |
| | `FRAC` | 0,15 | queues de PR09 et CTR01 (NORDEND octobre) |
| | `COUPURE` | 2 h | NORDEND octobre, nuit du 13 au 14 |
| | `K_CIBLE` | 5 | feuilles de C-005 (6 à 25 MAD) |
| | `K_CIBLE` | 5 | feuilles de E-005 (6 à 25 MAD) |
| | `CIBLE_MIN` | 3 | — |
| | `CIBLE_ECART` | 6 h | feuilles de C-005 (7 rejets en 12 h) |
| | `CIBLE_ECART` | 6 h | feuilles de E-005 (7 rejets en 12 h) |
| | `ECART` | 2,5 pas | gigue des horodatages |
| | `FACTEUR_REJET` | 1,2 | boucle FLORIDA, lot 01 : un rejet à 10 MAD est haut sans doubler (cibles au niveau 0,6) ; écarte C24 de C-009 (0,68, rejetée à ×1,04) |
| | `MOITIE` | 0,5 | niveau « none » (point 38) : NORDEND 09/10 23:00 (68 % rejetées) contre pluie de C-005 (24 à 33 %) |
| `sauts` | `K` | 20 bruits | C-001 (à 15, deux cibles saines grisées) ; ne pas baisser pour les trains, vus par `visibilite` (point 12) |
| | `FACTEUR_REJET` | 1,2 | boucle FLORIDA, lot 01 : un rejet à 10 MAD est haut sans doubler (cibles au niveau 0,6) ; écarte C24 de E-009 (0,68, rejetée à ×1,04) |
| | `MOITIE` | 0,5 | niveau « none » (point 38) : NORDEND 09/10 23:00 (68 % rejetées) contre pluie de E-005 (24 à 33 %) |
| `sauts` | `K` | 20 bruits | E-001 (à 15, deux cibles saines grisées) ; ne pas baisser pour les trains, vus par `visibilite` (point 12) |
| | `K_DURABLE` | 7 bruits | saut sous K qui reste (point 8 de `sauts.py`) : boucle NIEDERHORN, lot 01 (e09, corr_y −0,19 px d'un coup, 8 bruits, resté 5 jours) |
| | `PALIER` | 8 variations ordinaires | même point : écart des médianes du jour d'après et du jour d'avant, en variations ordinaires du niveau d'un jour au suivant ; boucle NIEDERHORN, lot 01 (e09 : 13 ; C-001, cibles saines : 6 au plus) |
| | `PALIER` | 8 variations ordinaires | même point : écart des médianes du jour d'après et du jour d'avant, en variations ordinaires du niveau d'un jour au suivant ; boucle NIEDERHORN, lot 01 (e09 : 13 ; E-001, cibles saines : 6 au plus) |
| | `K_PIC` | 6 bruits | pic d'un pas commun à plusieurs cibles : boucle NORDEND, lot 01 (secousses de toute l'image, 6 à 11 bruits) |
| | `PIC_MIN` | 3 cibles | boucle NORDEND, lot 01 (3 à 5 cibles par secousse) |
| | `BASE` | 4 mesures | 1 h à 15 min |
| | `GAP` | 1 h | — |
| | `BACK_H` | 24 h | C-002 (paliers jusqu'à 11 h 30) |
| | `BACK_H` | 24 h | E-002 (paliers jusqu'à 11 h 30) |
| | `REPET` | 5 sauts revenus | boucle CLARIDEN, lot 01 : PR_BG bascule 28 fois en 2,5 jours, les autres cibles 3 au plus (matin du mouvement) |
| | `BASCULE` | 6 h | cible défaillante (D-074) : PR_BG de CLARIDEN bascule 2,5 jours ; C8 et C13 de C-009, 5 bascules en 1 h 20 au matin du mouvement, restent des sauts brefs |
| | `SEULES` | 2 cibles | cible défaillante : FLORIDA, les deux cibles collées ; C-002, toile sur les références, 15 cibles basculent à la fois |
| | `GROS` | 0,5 | gros saut (« Large shift », D-074) : C-004 et CLARIDEN, 18 cibles le matin du mouvement |
| | `BASCULE` | 6 h | cible défaillante (D-074) : PR_BG de CLARIDEN bascule 2,5 jours ; C8 et C13 de E-009, 5 bascules en 1 h 20 au matin du mouvement, restent des sauts brefs |
| | `SEULES` | 2 cibles | cible défaillante : FLORIDA, les deux cibles collées ; E-002, toile sur les références, 15 cibles basculent à la fois |
| | `GROS` | 0,5 | gros saut (« Large shift », D-074) : E-004 et CLARIDEN, 18 cibles le matin du mouvement |
| `thermique` | `HEURES_MIN` | 20 h | — |
| | `REPRO` | 0,6 | bruit pur ≈ 0 |
| | `PART` | 0,5 | NORDEND octobre juste dessous (9/19), laissé dessous (point 13) |
@@ -40,19 +40,19 @@ Les détecteurs doivent tout détecter (l'utilisateur, 2026-10-26, D-068) : un r
| | `JOUR` | 0,5 | — |
| | `NUIT` | 8 h | — |
| | `R2_MIN` | 0,3 | sinusoïde de 24 h (point 41) : PS des Coudres 14 axes sur 22 au-dessus, CLARIDEN 0 sur 48 ; plus demandée pour la caméra (positions brutes) depuis la boucle WILDSTRUBEL, lot 01 (1 cible sur 7, les pointés faux écrasent l'ajustement) |
| | `CHAUDES_MIN` | 2 h | boucle WILDSTRUBEL, lot 01 : une seule heure chaude n'est pas un cycle (NIEDERHORN, C-005 : midi, trains et trous) |
| `turbulence` | `RATIO` | 1,5 | C-003 (×1,7 à ×3 la nuit) |
| | `CHAUDES_MIN` | 2 h | boucle WILDSTRUBEL, lot 01 : une seule heure chaude n'est pas un cycle (NIEDERHORN, E-005 : midi, trains et trous) |
| `turbulence` | `RATIO` | 1,5 | E-003 (×1,7 à ×3 la nuit) |
| | `PART` | 0,5 | — |
| | `RATIO_ERR` | 1,5 | C-003 (×1,7 à ×3,2) |
| | `REJET_MAX` | 15 % | C-003 ≤ 7 % ; toile et pluie ≥ 18 % |
| | `FORT` | 2× | C-003 (×2,3 à ×2,6) |
| | `DUREE_MIN` | 3 h | C-003 (10-11 h) contre matin de C-004 (2 h) ; le classement écarte aussi ce matin, quelle que soit la durée (point 14) |
| | `RATIO_ERR` | 1,5 | E-003 (×1,7 à ×3,2) |
| | `REJET_MAX` | 15 % | E-003 ≤ 7 % ; toile et pluie ≥ 18 % |
| | `FORT` | 2× | E-003 (×2,3 à ×2,6) |
| | `DUREE_MIN` | 3 h | E-003 (10-11 h) contre matin de E-004 (2 h) ; le classement écarte aussi ce matin, quelle que soit la durée (point 14) |
| `trous` | `MISSING` | 2 pas | consigne de l'utilisateur, 2026-10-23 ; appliqué aussi entre la dernière mesure et la fin de la fenêtre lue (boucle CLARIDEN, lot 01) |
| `degradee` | `CALME` | 0,25 | (détecteur ajouté le 2026-10-27, voir son en-tête) |
| | `PART` | 0,5 | — |
| | `MIN_INSTANTS` | 12 | 3 h à 15 min |
| | `MIN_JOURS` | 2 jours | NORDEND : jours isolés sur 16 capteurs |
| | `COLLE` | 0,05 | cible collée (D-074) : C-011, C2 et C3 à 0,006 et 0,016 du bruit des autres ; NORDEND, C-001 : 0,7 au plus bas |
| | `COLLE` | 0,05 | cible collée (D-074) : E-011, C2 et C3 à 0,006 et 0,016 du bruit des autres ; NORDEND, E-001 : 0,7 au plus bas |
| `derive` | `HEURES` | 20 h | comme `TREND_DAYS` de D-055 (ci-dessous) |
| | `JOURS` | 5 jours | `TREND_DAYS` |
| | `TAILLE` | 1 | `TREND_SIZE` ; amplitude du jour : déciles 9 et 1 de `corr` |
+2 -2
View File
@@ -155,8 +155,8 @@ Pas de tests automatisés (D-008). Lancer `python3 vues-deplacements/maquette/ex
- **Vérifié** par des captures Chrome headless (adresse avec `#tab=…&t=…&open=…`, `#img=…&cmp=…&also=…`) : les points ci-dessus.
- **Pas encore vérifié** : les clics et les réglages (glisseur, film, clavier, boutons, zoom des courbes et de la grille, `Analyze by AI`, passage d'un onglet à l'autre), à essayer par l'utilisateur.
- **Cas NORDEND** : laissé là le 2026-10-16 ; la démarche et le verdict de l'expert sont dans `cas/2026-10_NORDEND/parcours.md`.
- **Suite**, à la demande de l'utilisateur : son retour sur l'onglet Displacements (il l'essaie, retour dans une prochaine conversation) ; la sortie de l'agent dans la page, les annotations d'épisodes par l'expert (à croiser avec le diagnostic de l'agent), d'autres cas.
- **Suite**, à la demande de l'utilisateur : son retour sur l'onglet Displacements (il l'essaie, retour dans une prochaine conversation) ; la sortie de l'agent dans la page, les annotations d'épisodes par l'expert (à croiser avec le diagnostic de l'agent), d'autres events.
## Hors maquette pour l'instant
Lancement de l'agent depuis la page et affichage de son rapport, annotations d'épisodes, vue client, autres cas, données de la base de la plateforme (pan, tilt, roll), export horaire en mm : plus tard, à la demande de l'utilisateur.
Lancement de l'agent depuis la page et affichage de son rapport, annotations d'épisodes, vue client, autres events, données de la base de la plateforme (pan, tilt, roll), export horaire en mm : plus tard, à la demande de l'utilisateur.