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

@@ -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.