Detectors, loop and sharpening sessions moved to the repo root (D-084)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-28 17:19:51 +01:00
1 parent be8897e38e
commit 4d99585474
691 files changed
+122 -109

No files matched your search

@@ -54,7 +54,7 @@ Il ne contient ni catégorie, ni cas, ni hypothèse, ni verdict : c'est l'affair
**Lancement** : `/aiguiser <dossier de station> [--du AAAA-MM-JJ] [--au AAAA-MM-JJ] [--ameliorer]`, par l'utilisateur seul, d'après son expression « aiguiser la vision » (accepté). Séparé de `/boucle` (l'utilisateur : « un autre processus automatique »). **La plage est le lot**, sans découpe, comme pour `/boucle` (D-078, D-072) : une séance, un lot, de la longueur choisie par `--du` / `--au` (l'utilisateur).
**Mise en place** *(choix de Claude, calquée sur `/boucle`)* : sur `master`, sans changer de branche (ailleurs, l'orchestrateur le dit et s'arrête), la base de la séance notée au bilan (D-077) ; dossier de séance `vues-deplacements/aiguiser/<SEANCE>_<STATION>/`, hors de tout dossier de station ; un dossier `lot-01/`, le lot de la séance. L'agent de diagnostic ne lit pas `vues-deplacements/` : il ne verra pas les rendus de la séance.
**Mise en place** *(choix de Claude, calquée sur `/boucle`)* : sur `master`, sans changer de branche (ailleurs, l'orchestrateur le dit et s'arrête), la base de la séance notée au bilan (D-077) ; dossier de séance `aiguiser/<SEANCE>_<STATION>/`, hors de tout dossier de station ; un dossier `lot-01/`, le lot de la séance. L'agent de diagnostic ne lit pas `vues-deplacements/` : il ne verra pas les rendus de la séance.
**Le lot, dans l'ordre** (accepté) :
1. **Lecteur** : il lit le lot avec le skill, rien d'autre, et écrit `lecture-1.md`. Commit.
@@ -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. 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 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.
`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).
@@ -132,7 +132,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 (`vues-deplacements/detectors/`) ; bibliothèque standard, matplotlib pour les figures seulement.
- **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.
- `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.
@@ -144,7 +144,7 @@ Ordre de grandeur, à mesurer au premier essai : une lecture ≈ un passage de l
- Sur `master`, un commit par étape depuis la base de la séance notée au bilan ; il annule ce qu'il ne garde pas par `git revert`.
- `bilan.md` (§5), et dans le lot le corrigé, les lectures et les écarts, pour voir ce que la vision de Claude a gagné.
- Dans le lot, `outils/index.html` : ce que les outils, tels qu'ils sont devenus, rendent sur la plage du lot (texte imprimé et figures des cinq outils), avec la version des outils en tête. Le script `vues-deplacements/aiguiser/voir.py <dossier> --debut T --fin T` le produit aussi à la main, sur n'importe quelle plage (page dans `out/voir/<STATION>_<plage>_<version des outils>/`) : lancé à deux versions des outils, il donne deux pages à comparer. Sans agent ; les vignettes montrent les 3 capteurs qui s'écartent le plus de leur niveau habituel et le plus calme (*choix de Claude*).
- Dans le lot, `outils/index.html` : ce que les outils, tels qu'ils sont devenus, rendent sur la plage du lot (texte imprimé et figures des cinq outils), avec la version des outils en tête. Le script `aiguiser/voir.py <dossier> --debut T --fin T` le produit aussi à la main, sur n'importe quelle plage (page dans `out/voir/<STATION>_<plage>_<version des outils>/`) : lancé à deux versions des outils, il donne deux pages à comparer. Sans agent ; les vignettes montrent les 3 capteurs qui s'écartent le plus de leur niveau habituel et le plus calme (*choix de Claude*).
## 9. Essai et première séance
@@ -31,7 +31,7 @@ L'analyste et le validateur ne laissent rien de durable eux-mêmes : ce sont les
## 3. Ce qui existe et que la boucle réutilise
- Les détecteurs du journal : `vues-deplacements/detectors/*.py`, contrat `detect(mesures)`, classés en événements par `categories.py`. Le tri en lot existe (point 30, validé) : `python3 vues-deplacements/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 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.
@@ -41,7 +41,7 @@ L'analyste et le validateur ne laissent rien de durable eux-mêmes : ce sont les
**Lancement** : `/boucle data/<STATION> [--du AAAA-MM-JJ] [--au AAAA-MM-JJ] [--ameliorer]`, par l'utilisateur seul ; un nom de station seul désigne `data/<STATION>/` (D-065) ; `--au` est exclu (la plage s'arrête à `--au` 00:00Z). Sans dates, toute la période du dossier ; une date qui déborde cette période y est ramenée, et dite sous « Erreurs » du bilan. **L'utilisateur pilote les lots** (2026-10-24) : avec les données en masse, on ne traitera pas tout ; les lots se traitent indépendamment, il choisit lesquels (`--du` / `--au` sur la plage d'un lot pour un seul) ; la manière de les choisir reste à voir. **La plage est le lot** (D-072, 2026-10-26) : une séance traite un seul lot, sans découpe ; l'utilisateur en choisit la longueur par ses dates (d'abord des lots de 4 jours par défaut, `--lot`, retirés).
**Mise en place** *(choix de Claude)*. L'orchestrateur commite directement sur `master` (D-070 ; d'abord une branche par séance, abandonnée le 2026-10-26) et crée le dossier de la séance `vues-deplacements/boucle/<AAAA-MM-JJTHHMMZ>_<STATION>/` (deux séances le même jour ne se mêlent pas), hors de tout dossier de station (règle de `vues-deplacements/CLAUDE.md`). La plage est un seul lot, `lot-01/`, sa commande `categories.py <dossier> [--du …] [--au …]`, sans `--tranche`.
**Mise en place** *(choix de Claude)*. L'orchestrateur commite directement sur `master` (D-070 ; d'abord une branche par séance, abandonnée le 2026-10-26) et crée le dossier de la séance `boucle/<AAAA-MM-JJTHHMMZ>_<STATION>/` (deux séances le même jour ne se mêlent pas), hors de tout dossier de station (règle de `vues-deplacements/CLAUDE.md`). La plage est un seul lot, `lot-01/`, sa commande `categories.py <dossier> [--du …] [--au …]`, sans `--tranche`.
**Pour chaque lot, dans l'ordre** (dossier `lot-NN/` dans celui de la séance) :
1. **Analyste** : il écrit `critique.md`. Commit.
@@ -77,7 +77,7 @@ La critique est un skill à part, à la demande de l'utilisateur ; on peut aussi
`critique.md` reprend ces six parties ; ses figures sont dans le dossier du lot.
**É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 : `vues-deplacements/boucle/*/lot-*/etiquettes.json`.
**É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.
@@ -87,7 +87,7 @@ La critique est un skill à part, à la demande de l'utilisateur ; on peut aussi
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 ne touche qu'à `vues-deplacements/detectors/*.py` et au registre des seuils.
- 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.
@@ -43,7 +43,7 @@ Hors ligne, dans Support-Agent, à la main de l'utilisateur (pas de LLM à chaqu
1. **Liste** : l'utilisateur donne les stations et la plage totale (par exemple 3 stations, 60 jours) ; un fichier `extraction/plan.md` les range en tranches de 3 à 5 jours. Coût : zéro.
2. **Pompe** (utilisateur, dans le container) : `pomper.py` par lots ; copie dans `data/<STATION>/`. Pas de coût Claude ; reprenable.
3. **Tri sans image** : les détecteurs de `vues-deplacements/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.
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.
@@ -22,7 +22,7 @@ Notes de la conversation vocale du 2026-10-23 (utilisateur, après échange avec
## Les pistes, une par agent (toutes rendues le 2026-10-23)
Un orchestrateur (la conversation principale) et un agent par piste, qui rapporte à l'orchestrateur ; l'orchestrateur en discute avec l'utilisateur. Contrat commun des détecteurs : un fichier par détecteur dans `vues-deplacements/detectors/`, `detect(mesures)` rend des épisodes (`start`, `end`, `label`, `text`, `ignore`, `sensors`).
Un orchestrateur (la conversation principale) et un agent par piste, qui rapporte à l'orchestrateur ; l'orchestrateur en discute avec l'utilisateur. Contrat commun des détecteurs : un fichier par détecteur dans `detectors/`, `detect(mesures)` rend des épisodes (`start`, `end`, `label`, `text`, `ignore`, `sensors`).
| Piste | Ce que l'utilisateur en dit | Où |
|---|---|---|
@@ -1,6 +1,6 @@
# Seuils du journal du matin : le registre
Tous les seuils des détecteurs du journal (`vues-deplacements/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]+ = " vues-deplacements/detectors/*.py`.
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`.
Registre au 2026-10-24 (point 17 du plan), vérifié contre le code.
@@ -62,4 +62,4 @@ Les détecteurs doivent tout détecter (l'utilisateur, 2026-10-26, D-068) : un r
| | `TREND_SIZE` | 1 | dérive sur la période ≥ une amplitude journalière |
| | `TREND_STEADY` | 0,6 | tau de Kendall des niveaux journaliers |
Essais archivés (`vues-deplacements/detectors/archive/`) : la version simple de `visibilite` (`NIVEAU` 0,2, `CIBLE_MIN` 3, `CIBLE_ECART` 6 h), écartée au point 11 ; ses constantes ne sont pas en service.
Essais archivés (`detectors/archive/`) : la version simple de `visibilite` (`NIVEAU` 0,2, `CIBLE_MIN` 3, `CIBLE_ECART` 6 h), écartée au point 11 ; ses constantes ne sont pas en service.