Events-learner: the analyst writes its own tools, a tool-builder brings them into agent-tools; /aiguiser retired (D-097)
- inventaire.py: what each source contains on the window (filled or empty columns, metric names, images), names and counts only - analyser-lot: step 0 on the data, own scripts in <lot>/outils/, section 3 "Outils" - tool-builder (the optimiser, rewritten): after the analyst, optimises or adds reading tools, never removes; no control yet - /aiguiser skill, reader, corrector and voir.py removed; its sessions and spec stay as history - docs: D-097, specs, CLAUDE.md, run.md, README, plan point 56; the shared files also carry another session's pending edits (D-096 entry, plan points 57 to 67) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
52de2becbf
commit
7fb176cf0a
24 files changed
+555
-513
No files matched your search
@@ -1 +1 @@
|
||||
<mxfile host="drawio" version="24.7.17"><diagram id="p1" name="1. Vue d'ensemble"><mxGraphModel dx="1400" dy="900" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="1500" pageHeight="1000" math="0" shadow="0"><root><mxCell id="0"/><mxCell id="1" parent="0"/><mxCell id="p1_P1" value="<b>/aiguiser &lt;dossier&gt;</b><br>affine les outils de lecture (D-059)" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;arcSize=4;verticalAlign=top;spacingTop=6;" vertex="1" parent="1"><mxGeometry x="40" y="170" width="320" height="300" as="geometry"/></mxCell><mxCell id="p1_P2" value="<b>/events-learner &lt;dossier&gt;</b><br>règle les détecteurs du journal (D-057)" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;arcSize=4;verticalAlign=top;spacingTop=6;" vertex="1" parent="1"><mxGeometry x="400" y="170" width="320" height="300" as="geometry"/></mxCell><mxCell id="p1_P3" value="<b>@agent-diagnostic data/… [question]</b><br>enquête à la demande sur un cas (D-058)" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;arcSize=4;verticalAlign=top;spacingTop=6;" vertex="1" parent="1"><mxGeometry x="760" y="170" width="320" height="300" as="geometry"/></mxCell><mxCell id="p1_P4" value="<b>/nouveau-cas</b><br>ajoute un cas validé (D-048)" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;arcSize=4;verticalAlign=top;spacingTop=6;" vertex="1" parent="1"><mxGeometry x="1120" y="170" width="320" height="300" as="geometry"/></mxCell><mxCell id="p1_lg" value="<b>Légende</b>" style="rounded=0;whiteSpace=wrap;html=1;fillColor=#ffffff;strokeColor=#cccccc;verticalAlign=top;align=left;spacingLeft=8;fontSize=11;" vertex="1" parent="1"><mxGeometry x="1130" y="790" width="330" height="165" as="geometry"/></mxCell><mxCell id="p1_t" value="<b>Processus IA du projet : vue d'ensemble</b><br><font style="font-size:12px">Qui lance quoi, et qui modifie quel bien partagé (au 2026-10-24). Tout est lancé à la main par l'utilisateur.</font>" style="text;html=1;align=left;verticalAlign=top;whiteSpace=wrap;fontSize=18;" vertex="1" parent="1"><mxGeometry x="40" y="20" width="900" height="50" as="geometry"/></mxCell><mxCell id="p1_u" value="<b>Utilisateur (l'expert)</b><br>lance chaque processus, fusionne les branches" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#ffe6cc;strokeColor=#d79b00;arcSize=12;" vertex="1" parent="1"><mxGeometry x="600" y="85" width="280" height="50" as="geometry"/></mxCell><mxCell id="p1_lecteur" value="<b>lecteur</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="55" y="235" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_correcteur" value="<b>correcteur</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="205" y="235" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_optimiseur" value="<b>optimiseur</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="55" y="289" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_P1f" value="Lit : data/ ; au contrôle final, les cas validés.<br>Garde une modification des outils seulement si la relecture est <i>mieux</i>." style="text;html=1;align=left;verticalAlign=top;whiteSpace=wrap;fontSize=11;" vertex="1" parent="1"><mxGeometry x="55" y="360" width="290" height="100" as="geometry"/></mxCell><mxCell id="p1_analyste" value="<b>analyste</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="415" y="235" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_upgrader" value="<b>detectors-upgrader</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="565" y="235" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_validateur" value="<b>detectors-control</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="415" y="289" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_builder" value="<b>builder</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="565" y="289" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_P2f" value="Lit : data/ par les outils de lecture ; la base de cas, après sa propre lecture." style="text;html=1;alignLine truncated
|
||||
<mxfile host="drawio" version="24.7.17"><diagram id="p1" name="1. Vue d'ensemble"><mxGraphModel dx="1400" dy="900" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="1500" pageHeight="1000" math="0" shadow="0"><root><mxCell id="0"/><mxCell id="1" parent="0"/><mxCell id="p1_P1" value="<b>/aiguiser &lt;dossier&gt;</b><br>retiré le 2026-10-29 (D-097) : le tool-builder de /events-learner tient les outils de lecture" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;arcSize=4;verticalAlign=top;spacingTop=6;" vertex="1" parent="1"><mxGeometry x="40" y="170" width="320" height="300" as="geometry"/></mxCell><mxCell id="p1_P2" value="<b>/events-learner &lt;dossier&gt;</b><br>règle les détecteurs du journal (D-057)" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;arcSize=4;verticalAlign=top;spacingTop=6;" vertex="1" parent="1"><mxGeometry x="400" y="170" width="320" height="300" as="geometry"/></mxCell><mxCell id="p1_P3" value="<b>@agent-diagnostic data/… [question]</b><br>enquête à la demande sur un cas (D-058)" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;arcSize=4;verticalAlign=top;spacingTop=6;" vertex="1" parent="1"><mxGeometry x="760" y="170" width="320" height="300" as="geometry"/></mxCell><mxCell id="p1_P4" value="<b>/nouveau-cas</b><br>ajoute un cas validé (D-048)" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;arcSize=4;verticalAlign=top;spacingTop=6;" vertex="1" parent="1"><mxGeometry x="1120" y="170" width="320" height="300" as="geometry"/></mxCell><mxCell id="p1_lg" value="<b>Légende</b>" style="rounded=0;whiteSpace=wrap;html=1;fillColor=#ffffff;strokeColor=#cccccc;verticalAlign=top;align=left;spacingLeft=8;fontSize=11;" vertex="1" parent="1"><mxGeometry x="1130" y="790" width="330" height="165" as="geometry"/></mxCell><mxCell id="p1_t" value="<b>Processus IA du projet : vue d'ensemble</b><br><font style="font-size:12px">Qui lance quoi, et qui modifie quel bien partagé (au 2026-10-24). Tout est lancé à la main par l'utilisateur.</font>" style="text;html=1;align=left;verticalAlign=top;whiteSpace=wrap;fontSize=18;" vertex="1" parent="1"><mxGeometry x="40" y="20" width="900" height="50" as="geometry"/></mxCell><mxCell id="p1_u" value="<b>Utilisateur (l'expert)</b><br>lance chaque processus, fusionne les branches" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#ffe6cc;strokeColor=#d79b00;arcSize=12;" vertex="1" parent="1"><mxGeometry x="600" y="85" width="280" height="50" as="geometry"/></mxCell><mxCell id="p1_lecteur" value="<b>lecteur</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="55" y="235" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_correcteur" value="<b>correcteur</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="205" y="235" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_optimiseur" value="<b>optimiseur</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="55" y="289" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_P1f" value="Lit : data/ ; au contrôle final, les cas validés.<br>Garde une modification des outils seulement si la relecture est <i>mieux</i>." style="text;html=1;align=left;verticalAlign=top;whiteSpace=wrap;fontSize=11;" vertex="1" parent="1"><mxGeometry x="55" y="360" width="290" height="100" as="geometry"/></mxCell><mxCell id="p1_analyste" value="<b>analyste</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="415" y="235" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_upgrader" value="<b>detectors-upgrader</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="565" y="235" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_validateur" value="<b>detectors-control</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="415" y="289" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_builder" value="<b>builder</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="565" y="289" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_P2f" value="Lit : data/ par les outils de lecture ; la base dLine truncated
|
||||
+25
-5
@@ -665,7 +665,7 @@ Règles du journal :
|
||||
- **Conséquence** : ses outils propres, pour plus de précision, restent à faire (autre conversation) ; vérification proposée, non lancée : CLARIDEN repassé sans C-004 ni `incident-de-barcelone.md`. Spec : `docs/agents/agent-diagnostic.md`.
|
||||
|
||||
## D-059 — 2026-10-24 — Déplacements : aiguiser la lecture de Claude
|
||||
- **Statut** : active ; construite le 2026-10-24 ; l'utilisateur lancera lui-même les séances ; les sous-agents prennent le modèle de la session (D-063) ; le contrôle de lecture sur les cas validés est retiré (D-064).
|
||||
- **Statut** : remplacée par D-097 (`/aiguiser` retiré ; le skill `lire-les-donnees` reste la seule source du mode d'emploi de lecture) ; construite le 2026-10-24 ; l'utilisateur lancera lui-même les séances ; les sous-agents prennent le modèle de la session (D-063) ; le contrôle de lecture sur les cas validés est retiré (D-064).
|
||||
- **Décision** :
|
||||
- un skill de lecture, `lire-les-donnees` (`.claude/skills/lire-les-donnees/`), devient la seule source du mode d'emploi des outils de `agents/diagnostic/outils/` : ce qu'ils rendent, leurs conventions, la façon de lire un lot et ce que la lecture rend (un tableau des moments) ; l'analyste (`critiquer-lot`) et l'agent de diagnostic y renvoient, leur raisonnement ne change pas ;
|
||||
- une commande, `/aiguiser <dossier de station>` (skill `.claude/skills/aiguiser/`), améliore ce skill lot après lot, avec trois sous-agents sur Opus : le **lecteur** lit le lot avec le skill seul ; le **correcteur** lit le lot à fond avec ses propres scripts, sans les outils de lecture, et cette lecture lente sert de corrigé, puis il mesure l'écart (trouvé, manqué, de travers, en trop ; faute de l'outil, du mode d'emploi ou du lecteur ; au plus deux défauts) ; l'**optimiseur** modifie les outils et le skill, le plus simple d'abord ; un nouveau lecteur relit, le correcteur compare : un changement sans gain (`pareil` ou `moins bien`) est annulé ; au plus trois passages par lot ;
|
||||
@@ -715,7 +715,7 @@ Règles du journal :
|
||||
- **Conséquence** : le correcteur de `/aiguiser`, dont le corrigé sert de référence, et l'analyste de `/boucle` tournent sur le modèle de la session, Sonnet compris ; un rendu moins bon se lit dans le bilan. La variable `CLAUDE_CODE_SUBAGENT_MODEL` n'a pas d'effet (`inherit` passe avant), `CLAUDE_CODE_EFFORT_LEVEL` si, s'il est posé.
|
||||
|
||||
## D-064 — 2026-10-26 — /aiguiser : plus de contrôle de lecture sur les cas validés
|
||||
- **Statut** : active ; complète D-059 (retire le contrôle des cas validés en fin de séance).
|
||||
- **Statut** : sans objet depuis D-097 (`/aiguiser` retiré) ; complète D-059 (retire le contrôle des cas validés en fin de séance).
|
||||
- **Décision** : la séance ne fait plus lire les cinq cas validés (C-001 à C-005) par un lecteur ni juger par un correcteur face à la fiche ; la demande « Contrôle » du correcteur et le dossier `controle/` disparaissent. Les commandes que citent les fiches sont toujours lancées en fin de séance (un script, sans agent), leurs échecs vont au bilan.
|
||||
- **Pourquoi** : l'utilisateur a validé les diagnostics de ces cas, pas les outils qui les lisent ; les critères des fiches ne sont donc pas un corrigé de lecture des données brutes. `/aiguiser` améliore la lecture, pas le diagnostic. Sur NORDEND (séance du 2026-10-26), le contrôle a donné « manqué » aux cinq cas (C-001 : 4 critères sur 5 retrouvés) sans qu'on sache si les modifications y étaient pour quelque chose.
|
||||
- **Options écartées** : garder le contrôle en le comparant aux outils d'avant la séance (coûte cinq lectures de plus pour juger des critères que l'utilisateur n'a pas validés).
|
||||
@@ -800,14 +800,14 @@ Règles du journal :
|
||||
- **Conséquence** : le builder garde la phrase exacte `non revalidé par l'expert`, que `/revue-cas` cherche.
|
||||
|
||||
## D-076 — 2026-10-27 — Aiguiser : `--ameliorer`, comme pour la boucle
|
||||
- **Statut** : active ; étend D-071 à `/aiguiser` (D-059).
|
||||
- **Statut** : sans objet depuis D-097 (`/aiguiser` retiré) ; étend D-071 à `/aiguiser` (D-059).
|
||||
- **Décision** : `/aiguiser … --ameliorer` appelle, après le commit du releveur, le même agent `ameliorateur`, avec `Processus : /aiguiser. Commit du releveur : <commit>.` (l'appel de `/boucle` nomme aussi son processus). Il corrige au plus simple le skill `/aiguiser`, les agents `lecteur`, `correcteur`, `optimiseur`, `releveur`, `ameliorateur`, `vues-deplacements/aiguiser/voir.py`, la spec `aiguiser-la-lecture.md` et `run.md` ; l'orchestrateur commite par chemin (`Sharpen <STATION>: process fixes`), sur la branche de la séance.
|
||||
- **Pourquoi** : demande de l'utilisateur.
|
||||
- **Options écartées** : un second améliorateur propre à `/aiguiser` (même rôle, seul le périmètre change) ; laisser l'améliorateur toucher aux outils de lecture et à `lire-les-donnees` (c'est le travail de l'optimiseur, jugé par les écarts du correcteur).
|
||||
- **Conséquence** : sans le flag, rien ne change.
|
||||
|
||||
## D-077 — 2026-10-27 — Aiguiser : la séance commite directement sur `master`
|
||||
- **Statut** : active ; remplace la branche par séance de D-059.
|
||||
- **Statut** : sans objet depuis D-097 (`/aiguiser` retiré) ; remplace la branche par séance de D-059.
|
||||
- **Décision** : `/aiguiser` se lance sur `master` et y commite chaque étape, par chemin, comme `/boucle` (D-070) ; ailleurs, l'orchestrateur le dit et s'arrête (pas de `git switch`). Il note la base de la séance (`git rev-parse HEAD`) dans `bilan.md` ; rien n'est poussé. `/boucle` le faisait déjà, rien n'y change.
|
||||
- **Pourquoi** : demande de l'utilisateur : rester sur la branche principale, comme pour la boucle.
|
||||
- **Options écartées** : basculer seul sur `master` en début de séance (dérangerait une autre session dans le même dépôt, comme pour D-070).
|
||||
@@ -815,7 +815,7 @@ Règles du journal :
|
||||
|
||||
|
||||
## D-078 — 2026-10-27 — Aiguiser : la plage est le lot, sans découpe
|
||||
- **Statut** : active ; remplace la découpe en lots de 4 jours de D-059, comme D-072 pour `/boucle`.
|
||||
- **Statut** : sans objet depuis D-097 (`/aiguiser` retiré) ; remplace la découpe en lots de 4 jours de D-059, comme D-072 pour `/boucle`.
|
||||
- **Décision** : une séance `/aiguiser` traite un seul lot, `lot-01`, de `--du` 00:00Z à `--au` 00:00Z (`--au` exclu ; sans eux, toute la période) ; plus d'option `--lot` (ignorée si donnée, notée sous « Erreurs »).
|
||||
- **Pourquoi** : demande de l'utilisateur : « tout comme pour /boucle, il n'y a pas de lots de 4 jours. Le lot est simplement la plage que je donne. »
|
||||
- **Options écartées** : garder la découpe avec 4 jours par défaut (séance trop longue : jusqu'à 11 agents par lot).
|
||||
@@ -951,3 +951,23 @@ Règles du journal :
|
||||
- **Pourquoi** : des status qui se chevauchent disent souvent la même chose ; le plus fort suffit, et la rangée des étiquettes reste lisible.
|
||||
- **Options écartées** : choisir le gagnant entre les deux phases thermiques (l'utilisateur les regroupe) ; occulter sans regarder les capteurs (sur NIEDERHORN, une Faulty target de toute la plage aurait caché 7 Target hidden sur d'autres capteurs).
|
||||
- **Conséquence** : `status.py` transcrit le document (`FUSION`, `OCCULTE`) ; il ne change que l'affichage, pas les détecteurs ni `detecteurs.py`.
|
||||
|
||||
## D-096 — 2026-10-29 — Pompage des stations suivies, jusqu'à maintenant
|
||||
- **Statut** : active. Complète D-065.
|
||||
- **Décision** : `extraction/stations.txt` liste les stations suivies (au départ, les 8 de `data/`). `pomper.py` lancé sans station ni dates, à la main dans le dev container, les met toutes à jour jusqu'à maintenant : chaque station repart de son dernier jour de déplacements pompé, qui est remplacé ; une station sans déplacements pompés reçoit les 30 derniers jours. Le jour en cours est pompé tel qu'il est, ses métriques jusqu'à la dernière heure terminée. La commande avec `--du` et `--au` reste pour une plage choisie (historique, jour en échec).
|
||||
- **Pourquoi** : sans cela, il fallait attendre le lendemain pour analyser une nuit ou une matinée, et retaper la commande station par station.
|
||||
- **Options écartées** : un pompage planifié (cron dans WSL, container éphémère toutes les 15 min), une règle de jour final à 6 h après sa fin, une écriture atomique : jugés beaucoup trop compliqués par l'utilisateur ; un script à part (le mode sans argument de `pomper.py` suffit).
|
||||
- **Conséquence** : un jour pompé en cours de journée reste incomplet jusqu'au lancement suivant sans `--du`. Un trou plus ancien que le dernier jour pompé n'est pas comblé : commande avec `--du`.
|
||||
|
||||
## D-097 — 2026-10-29 — `/aiguiser` retiré : l'analyste crée ses outils, un `tool-builder` les fait entrer dans `agent-tools/`
|
||||
- **Statut** : active. Remplace D-059 (et avec lui D-064, D-076, D-077, D-078) ; modifie D-090 (l'analyste) et D-092 (le déroulé de `/events-learner`) ; point 56 du plan du journal du matin.
|
||||
- **Décision** :
|
||||
- l'analyste voit ses données : `inventaire.py` dit, sur la fenêtre, ce que contient chaque source (colonnes de l'export, de la pose et de `quality/`, remplies ou vides ; noms des métriques système de `metrics/` ; images et images différentielles ; des noms et des comptes, jamais de valeurs) ; `analyser-lot` gagne une étape 0, « Tes données », avant la lecture ;
|
||||
- il peut écrire ses propres scripts (`<dossier de sortie>/outils/`, bibliothèque standard, matplotlib par `.venv`), sur les CSV bruts ou par `donnees.py`, à son choix ; son analyse gagne une section « 3. Outils » : chaque outil dont il s'est servi, existant ou à lui, à quoi il a servi, ce qu'il a montré, ce qui a manqué ou encombré ;
|
||||
- un agent `tool-builder` (l'optimiseur de `/aiguiser`, renommé et réécrit), appelé à chaque lot de `/events-learner` juste après l'analyste, lit cette section et décide seul d'optimiser ou d'ajouter des outils de lecture (`agent-tools/`, `lire-les-donnees`) ; il **ne retire rien** : un seul lot ne suffit pas pour nettoyer la liste des outils (l'utilisateur) ; il garde les interdits de l'optimiseur (aucun jugement dans ce que rend un outil, rien de propre à une station, aucun import des détecteurs) et les commandes des fiches qui marchent ; il ne touche `donnees.py` que pour une erreur de lecture montrée par l'analyste ;
|
||||
- score et benchmark se calculent après le `tool-builder` : les détecteurs lisent par `donnees.py`, et toutes les mesures d'une séance portent ainsi sur la même lecture ;
|
||||
- pas de contrôle du `tool-builder` pour l'instant : on regarde comment ça tourne (l'utilisateur) ;
|
||||
- `/aiguiser` se retire : son skill, le lecteur, le correcteur et `aiguiser/voir.py` ; ses séances (`aiguiser/`) et sa spec (`vues-deplacements/contexte/aiguiser-la-lecture.md`) restent, comme historique ; `/new-event` appelle l'analyste sans `tool-builder`.
|
||||
- **Pourquoi** : l'utilisateur, 2026-10-29 : le lecteur de `/aiguiser` extrait des informations sans savoir ce qui est pertinent, et refait le même travail à chaque séance sans être guidé ; celui qui profite des outils, c'est l'analyste, qui apprend par la base d'events. Constat : la vérité de `/aiguiser` comptait tout écart comme un moment, si bien que « mieux » voulait dire « voir plus » (neuf modifications sur neuf gardées en quatre séances ; outils de 419 à 1 423 lignes, skill de 4,8 à 20,9 Ko) ; et l'inventaire cachait des données : six colonnes de qualité d'image remplies sur LENZSPITZE et NADELHORN, 31 métriques système, qu'aucun outil ni aucune doc ne citait.
|
||||
- **Options écartées** : revoir `/aiguiser` comme `/events-learner` (un `reading-critic`, un `reading-upgrader`, un `reading-control` ; première proposition de Claude) : le lecteur restait sans notion de pertinence ; un `tool-builder` qui retire des outils (l'utilisateur) ; un contrôle du `tool-builder` sur le diff (l'utilisateur ne sait pas encore comment le faire) ; un nouveau script pour l'inventaire des données (`inventaire.py` étendu suffit).
|
||||
- **Conséquence** : une séance de `/events-learner` appelle six agents ; l'analyste, qui peut écrire des scripts, coûtera sans doute plus. Lire en brut garde une part de ce qu'apportait le correcteur, qui a trouvé la seule erreur de lecture commune (rejets des références, WILDSTRUBEL, 2026-10-27). Un changement de `donnees.py` se voit d'une séance à l'autre dans l'historique du benchmark. Sans retrait ni contrôle, les outils peuvent encore grossir : à observer.
|
||||
@@ -17,6 +17,7 @@ Deux autres formats, observés sur les données (pas documentés dans la FAQ) :
|
||||
- `x` / `y` ne sont pas le centroïde de la tache dans l'image (NORDEND, 2026-10-16) : de jour (12:30 UTC, sept jours), centroïde − (`x`, `y`) est constant par capteur et diffère d'un capteur à l'autre (PR17 −2,5 / −0,5 px, PR18 −3,1 / +1,6, PR16 −5,8 / −0,1, CTR02 −1,4 / −2,4, CTR04 −1,0 / −1,4). Centroïde pondéré au-dessus de la médiane d'un cadre de ±20 px, sur une fenêtre de ±8 px. De nuit, la tache est saturée et l'écart change (PR17 −0,7 à −1,3 px en x). Hypothèse : `x`, `y` désignent la position du motif de référence (manuel de la station), pas la tache elle-même.
|
||||
- `relative_x` / `relative_y` (vraisemblablement `rx` / `ry`), `corr_x` / `corr_y` (vraisemblablement `rch` / `rcv`, mais pas en mm, voir plus bas) ;
|
||||
- `reproj_err` et `inlier` : références seulement ; `sigma0` : une valeur par mesure, répétée sur chaque ligne ; pas de `camera_pan|tilt|rotation|scale`.
|
||||
- `peak`, `flux`, `sharpness`, `fwhm`, `dominance`, `snr` : la qualité d'image de chaque cible, calculée par le GPU des caméras récentes (`run.md`) ; « Empty for most devices today » (handoff G, `docs/aimsight/AIMsight_handoff_G_site_health.md`). Remplies sur LENZSPITZE et NADELHORN, vides ailleurs (pompage d'octobre 2026) ; `inventaire.py` dit, sur un lot, quelles colonnes portent des valeurs. Pour les anciennes caméras, `~/optical_emulator` les recalcule à partir des images DIFF dans `quality/` (`run.md`), avec `stacking`, `exposition`, `gain`, `rotation` et `flag` de l'image, à joindre sur `time_utc` et `sensor_name`. Flux, SNR et netteté relèvent de l'observabilité d'une cible dans l'image, à séparer de la santé du réseau de références (`AIMsight_agentic_support_project_context.md`, §5.5 et §5.6).
|
||||
- Une mesure rejetée (`error_value` > `error_threshold`) garde sa ligne et son `error_value` ; `corr_x` / `corr_y` sont vides, pas interpolés. « Rejetée » est un jugement d'AIMsight, pas un tri de la caméra : la caméra livre toutes ses mesures, et la plateforme d'un client qui intègre les données les reçoit et peut les afficher (l'utilisateur, 2026-10-28).
|
||||
- **Mouvements de la caméra** (`camera/<Station>_camera_<AAAAMMJJ>.csv`, pompage seulement, absent des exports reçus) : la pose de la caméra à chaque recalage, `time_utc` en UTC, `median_|min_|max_` de `pan`, `tilt`, `rotation` [deg], `scale`, `sigma0` à la minute ; une ligne par mesure (min = max), aux instants des déplacements. Un instant de mesure sans ligne : la caméra n'a pas été recalée (NORDEND : 101 instants sur 6 071, dont 49 les 29 et 30/07). Ordres de grandeur : `pan`, `tilt` de quelques centièmes de degré, `scale` à 10⁻³ près de 1 ; des écarts de plusieurs degrés sur NORDEND (`pan` jusqu'à 3,1°, `tilt` −2,8 à 4,0°), non expliqués. Lus par `ensemble.py` et `inventaire.py` (D-073).
|
||||
- **Horaire** (`<Station>_<début>_to_<fin>_1hour.csv`) : une ligne par heure, cibles seulement. Par cible : `horizontal_displacement`, `vertical_displacement`, leurs `_min` / `_max`, `_error`, `_count_val`.
|
||||
|
||||
@@ -15,5 +15,5 @@ La plateforme garde deux types d'images par mesure (type de mesure), que le pomp
|
||||
|
||||
- NORDEND a des images DIFF, une par heure au pompage (~160 Mo par jour). LENZSPITZE n'en a aucune en base les 26 et 27/10 (pompage du 2026-10-28), seulement des IRON, une par heure : mode d'acquisition sans DIFF, sans doute (non vérifié). Les autres stations : inconnu.
|
||||
- Le 29/07 à NORDEND (E-002, toile d'araignée selon l'expert), l'image DIFF montre de longues traînées claires sur tout le champ et les cibles en points, là où l'image IRON ne montre que de faibles bandes sombres. Ce qui est tout près de l'objectif y ressort peut-être mieux : à confirmer (point 28 du plan du journal du matin).
|
||||
- Les outils de lecture (`agent-tools/donnees.py`), donc `/aiguiser` et `/events-learner`, ne regardent que les images IRON et écartent `images_diff/`.
|
||||
- Les outils de lecture (`agent-tools/donnees.py`), donc `/events-learner`, ne regardent que les images IRON et écartent `images_diff/` ; `inventaire.py` les compte, et l'analyste peut les lire par ses propres scripts (D-097).
|
||||
- Piste, non vérifiée : si `x`, `y` sont mesurés sur l'image DIFF, un centroïde pris sur l'image IRON peut s'en écarter (écart constant par capteur vu sur NORDEND, `colonnes-des-deplacements.md`).
|
||||
@@ -44,7 +44,7 @@
|
||||
|
||||
## Index
|
||||
|
||||
Types : **Comprendre** (lire, expliquer, rien ne change), **Décider** (l'utilisateur tranche), **Coder**, **Lancer** (l'utilisateur lance quelque chose chez lui). Statuts : à faire, en cours, en attente, **validé le <date>** (par l'utilisateur seul, voir l'en-tête). Mis à jour le 2026-10-25.
|
||||
Types : **Comprendre** (lire, expliquer, rien ne change), **Décider** (l'utilisateur tranche), **Coder**, **Lancer** (l'utilisateur lance quelque chose chez lui). Statuts : à faire, en cours, en attente, **validé le <date>** (par l'utilisateur seul, voir l'en-tête). Mis à jour le 2026-10-29.
|
||||
|
||||
| N° | Point | Type | Dépend de | Statut |
|
||||
|---|---|---|---|---|
|
||||
@@ -109,8 +109,21 @@ Types : **Comprendre** (lire, expliquer, rien ne change), **Décider** (l'utilis
|
||||
| 53 | Un agent, une responsabilité : l'analyste lit, un autre critique les détecteurs | Essayer | 51, 52 | `analyser-lot` et `detectors-critic` (D-090, 2026-10-29) ; à essayer sur une séance |
|
||||
| 54 | Le builder devient `event-builder` | Essayer | 53 | appelé à chaque lot, décide seul ce qui est nouveau, bornes de l'événement (D-091) ; à essayer sur une séance |
|
||||
| 55 | `/boucle` devient `events-learner` ; l'orchestrateur | Essayer | 54 | renommé, benchmark de fin sur les mêmes events, spec réduite (D-092) ; première séance à faire |
|
||||
| 56 | `/aiguiser` fondu dans `/events-learner` : l'analyste crée ses outils, un `tool-builder` les fait entrer | Essayer | 52, 53, 55 | `/aiguiser` retiré, `tool-builder` sans retrait ni contrôle (D-097, 2026-10-29) ; à essayer sur une séance |
|
||||
| | **VIII. Suivi du chantier** | | | |
|
||||
| 37 | Ménage : commit, `CLAUDE.md`, Mermaid, sorties | Lancer | — | validé le 2026-10-24 |
|
||||
| | **IX. Dire la cause : l'analyste d'abord, les détecteurs ensuite** | | | |
|
||||
| 57 | La cause plutôt que l'événement : l'ordre du chantier | Décider | — | idée du 2026-10-29 ; déroulé proposé, à valider |
|
||||
| 58 | Les trois effets thermiques et leurs temps de chauffe | Décider | 57 | savoir de l'utilisateur noté ici ; trois questions |
|
||||
| 59 | Les températures de la station dans les outils de lecture, par `/aiguiser` | Décider, Coder, Lancer | 58 (56 ?) | trois questions |
|
||||
| 60 | Des cas thermiques construits et validés | Lancer, Décider | 58, 59 | à faire |
|
||||
| 61 | Heat haze : quand il y en a, quand il n'y en a pas | Décider | 58 | à faire |
|
||||
| 62 | Visibilité réduite ou cible masquée | Décider | 63 | deux voies ; recommandation : regrouper sans qualité |
|
||||
| 63 | Les métriques de qualité : quelles stations, et la qualité recalculée | Décider | — | choix de l'utilisateur attendu |
|
||||
| 64 | Les sauts : dire pourquoi | Décider, Coder | 57 | à faire |
|
||||
| 65 | Un saut marqué dès son début | Coder | — | à faire (détail) |
|
||||
| 66 | Client et spécialiste : la complexité sur demande | Décider | 58, 62, 64 | idée gardée |
|
||||
| 67 | Le savoir métier de l'analyste : le mécanisme, sans plus de pages | Décider | 57 | idée du 2026-10-29 ; trois questions |
|
||||
|
||||
Chemins conseillés : le plus simple et le plus parlant d'abord, **11 (visibilité simple), 38 (ses statuts : bonne, moyenne, nulle) puis 7 (bouton `Images`)**, qui marchent sans le classement ; le cœur du retour, c'est **5 → 6 → 7 → 8 → 9 → 10** ; les points 1 à 4 se lisent avant si l'on veut d'abord tout comprendre ; le point 27 se lance en parallèle (il n'attend rien).
|
||||
|
||||
@@ -1211,6 +1224,110 @@ Rapport de l'agent : `vues-deplacements/contexte/donnees-et-boucle.md`. Script :
|
||||
- [x] Le renommage et l'orchestrateur (2026-10-29, D-092).
|
||||
- [ ] La première séance de `/events-learner` avec les rôles revus (points 52 à 54).
|
||||
|
||||
### Point 56 : `/aiguiser` fondu dans `/events-learner`
|
||||
|
||||
**L'idée** (l'utilisateur, 2026-10-29). Optimiser `/aiguiser` de la même manière que `/events-learner` (points 51 à 55).
|
||||
|
||||
**Constat (Claude, 2026-10-29).**
|
||||
- **Le garde-fou n'a jamais renvoyé** : quatre séances (NORDEND deux fois, CLARIDEN, WILDSTRUBEL, 26 et 27/10), neuf modifications, neuf « mieux », aucune annulée. C'est le symptôme du validateur de `/boucle` (point 52).
|
||||
- **Rien ne regarde hors du lot** : une modification n'est jugée que sur une relecture du même lot, face au corrigé du même correcteur. Depuis D-064, le seul contrôle hors du lot, ce sont les commandes des fiches : elles disent qu'un outil marche encore, pas qu'il n'est pas taillé pour le lot.
|
||||
- **La complexité, échec nommé par la spec, est là** : les outils sont passés de 419 lignes (spec, §3) à 1 423 (`ensemble.py` 446 l ; `plages.py` et `jours.py`, nouveaux ; `gif.py` vient de `/support`) ; le skill `lire-les-donnees`, de 4,8 Ko à 20,9 Ko. L'échelle de l'optimiseur n'a que des marches qui ajoutent (phrase, option, outil), comme celle de l'upgrader avant D-089.
|
||||
- **Le correcteur porte trois responsabilités** : la vérité (le corrigé), la critique (l'écart, les fautes, les défauts) et la décision de garder (« mieux, pareil, moins bien »), plus des « Nouveautés » pour le bilan. C'est l'analyste d'avant D-090.
|
||||
- **Un risque concret, relevé le 2026-10-26 et jamais traité** (`docs/ameliorations-processus.md`, « Annuler un passage efface… ») : l'annulation (`git restore --source=<BASE> -- agent-tools/ …`) efface les changements non commités de l'utilisateur dans les outils, et le commit de l'optimiseur (`git add agent-tools/`) les emporte. `/events-learner` le prévoit (§1), pas `/aiguiser`. Aujourd'hui, `agent-tools/gif.py` est modifié et non commité.
|
||||
- **La spec** (`vues-deplacements/contexte/aiguiser-la-lecture.md`, 173 l) redit le skill et les agents (§5, §6), comme celle de `/boucle` avant D-092.
|
||||
|
||||
**Transposition (Claude), à valider.**
|
||||
|
||||
| `/events-learner` | `/aiguiser` aujourd'hui | Proposition |
|
||||
|---|---|---|
|
||||
| `analyste` : la vérité (D-090) | correcteur, lecture lente | le correcteur ne fait plus que le corrigé ; il garde son nom, comme l'analyste |
|
||||
| `detectors-critic` : quoi et où, au plus deux suggestions, sans les données (D-090) | correcteur, écart | `reading-critic` : la lecture face au corrigé (trouvé, manqué, de travers, en trop), la faute, au plus deux défauts, le verdict, et « mieux, pareil, moins bien » face à la lecture précédente ; sans les données |
|
||||
| `detectors-upgrader` : ajoute, retire, modifie, en commençant par retirer ou simplifier (D-089) | optimiseur | `reading-upgrader` : la même échelle, avec une première marche qui retire ou simplifie |
|
||||
| `detectors-control` : ne voit pas le lot, juge le diff et la base, décide, renvoie au plus trois fois (D-089) | aucun | `reading-control` : ne voit pas le lot ; juge le diff des outils et du skill (les interdits : un jugement dans ce que rend un outil, du propre à une station, un import des détecteurs ; la complexité ajoutée face au défaut traité ; ce qui casse) et les commandes des fiches ; `garder`, `à reprendre` (remarques à l'upgrader, au plus trois passages) ou `annuler` |
|
||||
| `event-builder` décide ce qui est nouveau (D-091) | « Nouveautés » du correcteur, au bilan | les retirer : la base d'events n'est pas l'affaire de `/aiguiser` (non-but de la spec) ; c'est l'`event-builder` qui décide |
|
||||
| la base d'events, mémoire de l'analyste (D-087, D-088) | le lecteur ne lit ni la base ni la carte | rien : le lecteur mesure le skill seul, la base fausserait la mesure |
|
||||
| nom, orchestrateur, spec réduite (D-092) | — | le nom (à choisir) ; §1 repris de `/events-learner` (fichiers déjà modifiés de l'utilisateur, branche vérifiée avant chaque commit) ; spec réduite au pourquoi |
|
||||
|
||||
**Le passage K, proposé.** `reading-upgrader` → commandes des fiches (l'orchestrateur, `commandes-K.txt`, au lieu d'une fois en fin de séance) → `reading-control` (`à reprendre` : retour à l'upgrader) → s'il garde : lecteur → `reading-critic` (`pareil` ou `moins bien` : l'orchestrateur annule, comme aujourd'hui). Le contrôle passe **avant** la relecture : il ne coûte que le diff, et une modification qu'il annule épargne une lecture (~200 000 jetons). Deux portes, chacune une question : la lecture du lot est-elle meilleure (le critic), la modification reste-t-elle générale et simple (le contrôle) ?
|
||||
|
||||
**Le prix.** Un appel d'agent de plus par séance (la lecture lente et le premier écart, aujourd'hui une seule demande au correcteur, deviennent deux appels) ; les écarts suivants passent du correcteur au critic, sans les données, donc moins chers. Le critic ne revient plus aux données : le corrigé est la vérité ; un moment juste de la lecture, absent du corrigé, compte « en trop » (il ne fait jamais un défaut, puisqu'un défaut vient d'un moment manqué ou lu de travers). Avec un contrôle qui renvoie, des séances plus longues et des modifications plus souvent annulées, comme pour D-089.
|
||||
|
||||
**Écarté par Claude.** Rejouer une lecture sur les events validés comme « benchmark » de la lecture : c'est le contrôle retiré par D-064 (l'utilisateur a validé leurs diagnostics, pas une lecture des données brutes).
|
||||
|
||||
**Questions à l'utilisateur.**
|
||||
1. Le `reading-control`, garde-fou sans le lot, avant la relecture ?
|
||||
2. Le correcteur scindé : le corrigé seul, et un `reading-critic` sans les données pour les écarts ?
|
||||
3. Les noms : `reading-critic`, `reading-upgrader` (l'optimiseur), `reading-control` ; le lecteur et le correcteur gardent les leurs ; et le processus : `/aiguiser` garde son nom, ou devient `/reading-learner` ?
|
||||
4. Le reste : « Nouveautés » retirées, les fichiers non commités de l'utilisateur protégés, les commandes des fiches à chaque modification, la spec réduite au pourquoi ?
|
||||
|
||||
**Réponse de l'utilisateur (2026-10-29).** Les propositions lui semblent bonnes ; avancer étape par étape du déroulé, en commençant par la première, pour s'assurer que tout est bon.
|
||||
|
||||
**Étape 1 : le lecteur (Claude, 2026-10-29), à valider.** Le déroulé d'une séance : mise en place (l'orchestrateur), lecteur (`lecture-1.md`), correcteur (corrigé et premier écart), passages (optimiseur, lecteur, correcteur), commandes des fiches, bilan, releveur. La mise en place n'est que de la tuyauterie : elle se revoit avec l'orchestrateur, en dernier, comme au point 55 (dont les fichiers non commités de l'utilisateur). La première étape de fond est le lecteur. Sur ses 13 lectures (quatre séances) :
|
||||
- **Son rôle est déjà unique** : lire le lot avec le seul skill `lire-les-donnees`, dire ce qu'il voit et où le skill lui a manqué ; aveugle au corrigé, aux écarts, aux modifications, à la base d'events ; pas de script. Rien à scinder.
|
||||
- **Ses manques font grossir les outils** : presque chaque modification répond à un souhait de « Ce qui m'a manqué » (`inventaire.py --debut/--fin`, `resume.py --niveau fenetre`, `vignettes.py --contraste`, `jours.py` pour superposer les jours, `plages.py --min-mesures`). Il ne demande jamais moins.
|
||||
- **Le trop, il le dit, mais au mauvais endroit** : 13 lectures sur 13 se plaignent de sorties trop longues pour être lues d'un coup (`ensemble.py` 642 à 947 lignes, `plages.py` 54 Ko, `jours.py` 40 Ko, `inventaire.py` 72 Ko), et plusieurs de figures écrasées par un capteur aberrant ; mais dans « Difficultés », qui va au releveur, que personne ne transforme en correction. Le correcteur juge les moments, pas l'effort ; l'optimiseur ne lit que « Ce qui m'a manqué ».
|
||||
- **Une consigne du skill que tous enfreignent** : « Bash ne sert qu'à lancer ces outils, `ls`, `grep` et `date` » (`lire-les-donnees`, Conventions) ; presque tous les lecteurs ont dû rediriger une sortie vers un fichier, puis `head`, `tail`, `sed`. Relevée le 2026-10-26, jamais corrigée : l'améliorateur ne touche pas à `lire-les-donnees` (D-076), et le correcteur n'en fait pas un défaut de lecture. De même « pas natif de 15 min » (méthode, étape 5), quand CLARIDEN est à 10 min (ses 3 lectures).
|
||||
- **Déjà réglé** : le `vues-deplacements/CLAUDE.md` injecté dans presque toutes les lectures venait des séances rangées sous `vues-deplacements/aiguiser/` ; elles sont à la racine depuis D-084.
|
||||
|
||||
Propositions :
|
||||
1. Le lecteur garde son rôle, son nom et son aveuglement.
|
||||
2. Une section « Ce qui m'a encombré », après « Ce qui m'a manqué » : sortie trop longue pour être lue d'un coup, figure illisible ou jamais regardée, option ou consigne suivie sans profit ; l'outil et la commande. Ces plaintes quittent « Difficultés », qui ne garde que le processus de la séance. Elles nourrissent la marche qui retire ou simplifie du `reading-upgrader` (et le `reading-critic`, qui les lit avec « Ce qui m'a manqué »).
|
||||
3. Les deux consignes du skill, corrigées à la main une fois : Bash permet aussi de ranger une sortie longue dans un fichier du dossier de la lecture et de la lire par `grep`, `head`, `tail`, `sed -n` ; le pas natif est celui que donne l'inventaire (15 min le plus souvent). Elles valent aussi pour l'analyste et l'agent de diagnostic, qui suivent le skill. Qui les tiendra ensuite (l'améliorateur, D-076 ?) : avec le releveur et l'améliorateur, dans l'autre conversation.
|
||||
|
||||
**Remise en cause par l'utilisateur (2026-10-29).** Ce processus est-il nécessaire ? Le lecteur extrait des informations sans savoir ce qui est pertinent : parmi une multitude de métriques, il ne peut pas savoir ce qui est intéressant ; même sur beaucoup de données, il n'est pas guidé et refait bêtement le même travail. Celui qui profite des outils, c'est l'analyste, qui évolue par la base d'events ; le lecteur, non. Sans l'analyste, l'utilisateur ne voit pas comment le système peut marcher : combiner `/aiguiser` avec `/events-learner`.
|
||||
|
||||
**Avis de Claude (2026-10-29) : l'utilisateur a raison sur le fond.**
|
||||
- **La vérité de `/aiguiser` ignore la pertinence** : un moment du corrigé, c'est « un capteur ou un groupe qui sort de son niveau habituel », tous égaux (`correcteur.md`). « Mieux » veut donc dire « voir plus d'écarts » : neuf « mieux » sur neuf, jusqu'à 23 moments par lecture, des sorties jusqu'à 947 lignes. La croissance des outils vient de la mesure elle-même, pas d'un réglage.
|
||||
- **Le lecteur ne peut pas apprendre la pertinence** : il est aveugle à la carte et à la base par construction (pour mesurer le skill seul).
|
||||
- **L'analyste lit déjà chaque lot de `/events-learner` avec ces outils**, guidé par la carte et la base, pour un but réel (catégories, events) ; `/aiguiser` relit des lots du même genre quatre fois, avec un lecteur moins informé. La raison de la séparation (spec, §1 : un analyste qui lit avec les détecteurs serait biaisé) est tombée avec D-090 : il s'en sert, comme d'une piste.
|
||||
- **Ce qu'on perdrait** : le correcteur, qui lit sans les outils, a trouvé la seule erreur commune de lecture : à WILDSTRUBEL, 0 rejet compté pour R3 au lieu de 147 (`donnees.py`, modification 1 du 2026-10-27). Un analyste qui lit par les mêmes outils ne peut pas la voir ; les détecteurs non plus (ils lisent par `donnees.py`). C'est la vraie valeur d'un lecteur indépendant, mais elle demande un audit de temps en temps, pas une boucle de quatre lectures. Et la mesure « mieux, pareil, moins bien », qui ne tranchait pas.
|
||||
|
||||
**Proposition de Claude, à valider.**
|
||||
- Dans `/events-learner`, l'analyste ajoute à `analyse.md` ce qui lui a manqué ou l'a encombré dans la lecture, pour son analyse (dater, catégoriser, reconnaître un event) ; il ne touche pas aux outils (un agent, une responsabilité).
|
||||
- Un agent `reading-upgrader` (l'optimiseur), appelé quand cette section n'est pas vide : il modifie `agent-tools/` et `lire-les-donnees`, en commençant par retirer ou simplifier, vérifie sur le lot et lance les commandes des fiches ; le gain se voit à la séance suivante, comme la carte pour l'analyste.
|
||||
- Contre la croissance : un `reading-control` qui ne juge que le diff (à décider).
|
||||
- `/aiguiser` se retire (lecteur, correcteur ; l'historique reste dans `aiguiser/`) ; l'audit indépendant (le correcteur, sans les outils) reste une piste, pour un changement de `donnees.py` ou de nouveaux champs de données.
|
||||
- À régler : les détecteurs lisent par `agent-tools/donnees.py` ; une modification de la lecture commune change leur entrée, donc le benchmark. Le `reading-upgrader` passe après le `detectors-control`, et un changement de `donnees.py` se mesure (benchmark) ou attend l'utilisateur.
|
||||
|
||||
**Proposition de l'utilisateur (2026-10-29) : c'est l'analyste qui change.**
|
||||
- Un script (ou autre moyen) lui montre les données à sa disposition.
|
||||
- Il accède aux données et aux outils, et il peut aussi créer ses propres outils.
|
||||
- Une fois les données bien comprises, il fait son analyse.
|
||||
- Dans son rapport final, une section « Tools » : les outils dont il s'est servi pour son analyse, existants ou créés pour l'occasion.
|
||||
- Puis un `tool-builder` lit ce rapport et adapte, modifie, retire ou crée des outils de lecture.
|
||||
- Le reste de `/events-learner` ne change pas.
|
||||
|
||||
**Constat (Claude, 2026-10-29) : l'analyste ne sait pas ce qu'il a.**
|
||||
- `inventaire.py` liste des fichiers, pas des données : sur NIEDERHORN, « Autres fichiers : 1178 » cache 31 métriques système (`metrics/` : températures de la carte, alimentation, réseau…) ; il ne dit pas quelles colonnes de l'export portent des valeurs.
|
||||
- L'export « advanced » a 20 colonnes, dont six de qualité d'image par cible (`peak`, `flux`, `sharpness`, `fwhm`, `dominance`, `snr`), remplies à LENZSPITZE et NADELHORN, vides ailleurs (le handoff le dit : « Empty for most devices today ») ; aucun outil, ni le skill, ni `colonnes-des-deplacements.md` ne les cite. Un lecteur de `/aiguiser` voulait justement « une mesure d'éclat ou de largeur de la tache (flux, taille, contraste) » : quatre séances ne l'ont pas trouvée.
|
||||
- Aujourd'hui, `analyser-lot` lui interdit tout script (« N'écris aucun autre script »), et `lire-les-donnees` limite Bash aux outils, `ls`, `grep` et `date`.
|
||||
|
||||
**Précisions de Claude (à valider).**
|
||||
- **Voir ses données** : `inventaire.py` gagne une section par source, avec ce qu'elle contient sur la fenêtre : colonnes de l'export (remplies ou vides), poses de la caméra, noms des métriques de `metrics/`, images, images différentielles, `quality/` ; des noms et des comptes, jamais de valeurs (`SIM_CCID`, `ip_*` sont des identifiants). Un outil existant étendu plutôt qu'un script de plus. Le sens des colonnes reste à `colonnes-des-deplacements.md`, qui ne dira des six colonnes de qualité que ce qu'en disent les documents AIMsight.
|
||||
- **Ses outils à lui** : des scripts dans le dossier de son analyse (`<lot>/outils/`), bibliothèque standard, matplotlib par `.venv` ; ils lisent les CSV bruts ou passent par `donnees.py`, à son choix (lire en brut est ce qui a trouvé l'erreur des rejets à WILDSTRUBEL). Commités avec le lot ; seul le `tool-builder` les fait entrer dans `agent-tools/`.
|
||||
- **Le déroulé d'`analyser-lot`** : 0. les données (l'inventaire, puis ce qu'il faut pour les comprendre) ; 1. la lecture ; 2. les étiquettes ; 3. les events connus ; 4. **Outils** : chaque outil dont il s'est servi, existant ou à lui, à quoi il a servi, ce qu'il a montré, ce qui a manqué ou encombré ; pour un script à lui, son chemin, ce qu'il calcule, pourquoi les outils existants ne suffisaient pas. Le fichier garde son nom, `analyse.md` (lu par `comparaison.py`, la page de `/review-event`, l'`event-builder`), et la section s'écrit en français, comme les autres.
|
||||
- **Le `tool-builder`** : l'optimiseur renommé et réécrit ; appelé à chaque lot, juste après l'analyste, il décide seul (comme l'`event-builder`) ; il touche `agent-tools/` et `lire-les-donnees`, rien d'autre ; il commence par retirer ou simplifier ; il garde les interdits de l'optimiseur (aucun jugement dans ce que rend un outil, rien de propre à une station, aucun import des détecteurs, bibliothèque standard) et les commandes des fiches qui marchent ; il essaie sur le lot, sans relecture. Pour retirer un outil, il peut lire la section Outils des analyses des séances d'avant : un seul lot ne dit pas qu'un outil ne sert à rien.
|
||||
- **L'ordre** : analyste → `tool-builder` → étiquettes, score et benchmark → la suite inchangée. Les détecteurs lisent par `donnees.py` : calculés après le `tool-builder`, score et benchmark de la séance portent tous sur la même lecture ; un changement de `donnees.py` se voit d'une séance à l'autre dans l'historique du benchmark, et le bilan le dit.
|
||||
- **Pas de contrôle** du `tool-builder` dans ce premier temps (le design de l'utilisateur) : la pertinence vient de l'analyste ; le `reading-control` reste une piste, si les outils grossissent encore.
|
||||
- **`/aiguiser` se retire** : son skill, le lecteur et le correcteur ; `aiguiser/voir.py` part avec lui ; les séances de `aiguiser/` restent, comme historique ; la spec `aiguiser-la-lecture.md` aussi, marquée remplacée. Une décision (D-097) ; l'améliorateur et le releveur perdent `/aiguiser` de leur périmètre ; `CLAUDE.md`, `run.md`, `vues-deplacements/CLAUDE.md`, la spec d'`events-learner`, le schéma des pipelines.
|
||||
- **`/new-event`**, qui appelle l'analyste pour les étiquettes d'un event : pas de `tool-builder` ; ses scripts éventuels restent dans le dossier de sortie.
|
||||
|
||||
**Réponse de l'utilisateur (2026-10-29).** D'accord sur l'inventaire, les scripts de l'analyste, la section Outils, l'ordre et le retrait de `/aiguiser` ; le `tool-builder` optimise ou ajoute des outils, il **n'en retire pas** : un seul lot ne suffit pas pour nettoyer la liste ; pas de contrôle pour l'instant, on regarde comment ça tourne et ce que ça donne.
|
||||
|
||||
**Fait le 2026-10-29 (D-097).** `inventaire.py` : une section « Ce que contiennent les données » (colonnes remplies ou vides de l'export, de la pose et de `quality/`, noms des métriques, images, images différentielles) ; `analyser-lot` : étape 0 « Tes données », ses scripts dans `<dossier de sortie>/outils/`, section « 3. Outils » ; agent `tool-builder` (l'optimiseur, `git mv`, réécrit) ; `/events-learner` : étape 2 entre l'analyste et le score, colonne Outils au bilan ; `/aiguiser` retiré (skill, lecteur, correcteur, `voir.py`) ; `colonnes-des-deplacements.md` (les six colonnes de qualité), `lire-les-donnees`, `/new-event`, améliorateur, spec d'`events-learner` (spec d'`aiguiser` marquée remplacée), `run.md`, `README.md`, `CLAUDE.md`, `vues-deplacements/CLAUDE.md`, schéma des pipelines (retouché).
|
||||
|
||||
**Étapes.**
|
||||
- [x] Les réponses de l'utilisateur : étape par étape (2026-10-29).
|
||||
- [x] Étape 1, le lecteur : sans objet, `/aiguiser` remis en cause.
|
||||
- [x] Combiner `/aiguiser` avec `/events-learner` : la proposition de l'utilisateur (2026-10-29).
|
||||
- [x] Les précisions de Claude : acceptées, sauf le retrait d'outils (2026-10-29).
|
||||
- [x] Construit (2026-10-29, D-097).
|
||||
- [ ] Une séance de `/events-learner` qui l'essaie : la section Outils guide-t-elle le `tool-builder`, les outils grossissent-ils sans servir ?
|
||||
- [ ] Les agents, le skill, la spec, une décision ; `CLAUDE.md`, `run.md`, `vues-deplacements/CLAUDE.md`, le schéma des pipelines.
|
||||
- [ ] Une séance de `/aiguiser` qui les essaie : le contrôle renvoie-t-il, à bon escient ?
|
||||
|
||||
**Fini quand.** Une séance de `/events-learner` améliore les outils dont l'analyste se sert, sans les faire grossir pour un lot seul.
|
||||
|
||||
---
|
||||
|
||||
## Partie VII — Idées gardées pour plus tard
|
||||
@@ -1263,6 +1380,179 @@ Demande de l'utilisateur (2026-10-27) : un graphe simple, sans le détail des do
|
||||
|
||||
---
|
||||
|
||||
## Partie IX — Dire la cause : l'analyste d'abord, les détecteurs ensuite
|
||||
|
||||
Retour de l'utilisateur du 2026-10-29 (vocal), après des exemples des détecteurs sur les données : « globalement c'est assez bon », la couverture est bonne, mais des catégories sont incomplètes ou peu précises. **L'ordre qu'il donne** : rendre l'analyste plus savant (savoir métier, températures, métriques de qualité, cas validés) pour qu'il étiquette mieux ; ensuite c'est lui, par `/events-learner`, qui fait progresser les détecteurs, de « il s'est passé quelque chose » vers « voici la cause ». À sa demande, rien n'est documenté hors de ce plan avant qu'il prenne le point : chaque point dit où son savoir ira.
|
||||
|
||||
### Point 57 : La cause plutôt que l'événement : l'ordre du chantier
|
||||
|
||||
**L'idée** (l'utilisateur, 2026-10-29). Détecter l'événement était la première chose ; il faut maintenant dire **pourquoi** : la cause d'un saut, l'effet thermique en jeu, une visibilité réduite ou une cible cachée. Ne pas avoir peur de la complexité de ces données ; l'interface la cachera par défaut (point 66).
|
||||
|
||||
**Le déroulé proposé (Claude).**
|
||||
1. Le savoir : les effets thermiques (58), le heat haze (61), visibilité contre occultation (62), la cause des sauts (64). L'utilisateur valide le texte, qui va dans `docs/displacement/domaine/` et la carte des événements.
|
||||
2. Les données qui le prouvent : les températures (59) et les métriques de qualité (63) dans les outils de lecture, aiguisés par `/aiguiser`.
|
||||
3. Les cas : des events construits par `/new-event` et validés par l'utilisateur, une cause chacun (60, et ceux des points 62 et 64).
|
||||
4. L'analyste : `analyser-lot` et la carte reçoivent le tout ; il consulte la base quand il veut (D-088).
|
||||
5. Les détecteurs : des séances de `/events-learner` sur des lots qui montrent ces causes ; les catégories nouvelles dans `categories.py` et la hiérarchie des status (D-095).
|
||||
6. Les détails de détection (65) se font quand on veut, sans attendre.
|
||||
|
||||
**Question.** Ce déroulé, et par où commencer : les effets thermiques (58, puis 59), recommandé, puisque toutes les stations ont déjà une température ?
|
||||
|
||||
- [ ] L'utilisateur valide l'ordre.
|
||||
|
||||
### Point 58 : Les trois effets thermiques et leurs temps de chauffe
|
||||
|
||||
**Ce qu'en dit l'utilisateur (l'expert, 2026-10-29).** Trois effets thermiques, qui se distinguent par leur **temporalité** : chacun a son propre temps de chauffe et de refroidissement.
|
||||
1. **L'objectif se déforme** : le soleil sur la station chauffe l'optique ; l'image se déforme.
|
||||
2. **Le support de la caméra bouge** : la fixation se dilate, la caméra bouge et compense mal ce mouvement, qui passe dans les mouvements des cibles.
|
||||
3. **L'ouvrage surveillé se dilate** : il lui faut beaucoup plus de temps pour chauffer et refroidir. Les refroidissements très tardifs et les chauffes longues vus ce jour sur les données des détecteurs en sont le cas type.
|
||||
|
||||
Les cas se croisent : une caméra posée sur un pont a deux ouvrages, celui qui la porte (effet 2) et celui qu'elle surveille (effet 3). Et encore :
|
||||
- les vagues de dilatation et de contraction des détecteurs sont justes (un pont se contracte et se détend par vagues) : à garder ;
|
||||
- le déplacement est souvent plus fort en Y (ça monte, ça descend) qu'en X, mais cela dépend de l'orientation : pas toujours ;
|
||||
- JUNGFRAU (PS des Coudres, sous un pont) : les effets thermiques sont centrés sur les points d'inflexion du mouvement de la caméra ; ce n'est pas faux, et c'est l'effet 1 ou 2.
|
||||
|
||||
**Ce que le projet en sait déjà.** `docs/displacement/domaine/cycle-thermique.md` (point 13) : une vague de 24 h dans les positions brutes presque partout (la caméra), dans les courbes corrigées seulement à PS des Coudres. Catégories `dilatation_thermique` et `contraction_thermique` (D-074), qui mêlent l'ouvrage et le support de la caméra ; `thermique` « Camera thermal … » (point 49) ; le regroupement Thermal movements, suspendu dans `status.py` (D-095).
|
||||
|
||||
**Signatures, hypothèses de Claude à valider.**
|
||||
|
||||
| Effet | Où il se voit | Temps | Témoin |
|
||||
|---|---|---|---|
|
||||
| Objectif | toute l'image : positions brutes de toutes les cibles, références comprises (plus fort au bord de l'image ?) | le plus court : suit le soleil sur la station | température de la station |
|
||||
| Support | positions brutes en mode commun (le mouvement de la caméra) ; reste dans `corr` quand la compensation est imparfaite, aux inflexions du mouvement de la caméra | intermédiaire | température de la station, mouvement de la caméra |
|
||||
| Ouvrage | `corr`, amplitude propre à chaque cible, références stables | le plus long : chauffe lente, refroidissement tardif, en retard sur l'air | température de l'air, absente (sauf peut-être `temperature_deg_c`, point 59) |
|
||||
|
||||
**Questions à l'utilisateur.**
|
||||
1. Les catégories : trois (objectif, support, ouvrage), chacune en dilatation et en contraction ; ou un seul « effet thermique » pour le client, la cause pour le spécialiste (point 66) ?
|
||||
2. L'objectif et le support se séparent-ils sur les courbes, ou seulement par leur temps ?
|
||||
3. Les signatures ci-dessus : justes, à corriger ?
|
||||
|
||||
- [ ] Les réponses de l'utilisateur.
|
||||
- [ ] Le savoir validé : `docs/displacement/domaine/cycle-thermique.md` réécrit (les trois effets, leurs temps, les cas croisés, X et Y) ; la carte des événements (sections 1 et 4) et le graphe des éventualités.
|
||||
- [ ] Les catégories décidées : entrée dans `docs/decisions.md`, `categories.py`, hiérarchie des status (D-095).
|
||||
|
||||
### Point 59 : Les températures de la station dans les outils de lecture, par `/aiguiser`
|
||||
|
||||
**L'idée** (l'utilisateur, 2026-10-29). Se servir de `/aiguiser` pour que les outils de lecture lisent aussi les métriques système, d'abord les températures, et que l'analyste les regarde pour séparer les trois effets thermiques.
|
||||
|
||||
**Ce qui existe (Claude, 2026-10-29).**
|
||||
- Toutes les stations de `data/` ont les cinq zones de la carte de calcul (`sensor_A0`, `CPU`, `GPU`, `PLL`, `thermal_deg_c`), en moyennes horaires : la température **dans** la station, chauffée par le soleil et par le calcul, ni celle de l'air ni celle de l'ouvrage. Les zones sont redondantes (`docs/temperature/domaine/point-de-depart.md`) : une seule suffit. Elle témoigne pour l'objectif et le support (effets 1 et 2), mal pour l'ouvrage.
|
||||
- LENZSPITZE et NADELHORN ont en plus `temperature_deg_c` (capteur inconnu : l'air ?), sur 5 à 12 jours.
|
||||
- Une moyenne horaire, face à des mesures de 10 ou 15 min, date une chauffe à l'heure près, pas mieux.
|
||||
- Aucun outil de lecture ne lit `metrics/` (`agent-tools/donnees.py`) ; le lecteur, le correcteur et l'analyste n'en savent rien.
|
||||
|
||||
**Proposition (Claude).** Le plus simple d'abord : lire une température (`sensor_thermal_deg_c`, la seule commune à toutes les versions du collecteur) dans `donnees.py` et la tracer sous les courbes dans `graphique.py` ; puis une séance de `/aiguiser` sur un lot thermique (JUNGFRAU), où le correcteur fait son corrigé avec les températures et où l'optimiseur ajoute ce qui manque au lecteur. Sans ce premier pas, le lecteur ne demandera jamais une température qu'il ne sait pas exister.
|
||||
|
||||
**Questions à l'utilisateur.**
|
||||
1. Le premier pas codé à la main, puis `/aiguiser` ; ou `/aiguiser` seul, en disant au lecteur et au correcteur que `metrics/` existe ?
|
||||
2. Avant ou après la refonte de `/aiguiser` (point 56, étape 1 en cours) ?
|
||||
3. `temperature_deg_c` : quel capteur ?
|
||||
|
||||
- [ ] Les réponses de l'utilisateur.
|
||||
- [ ] La température dans les outils (selon la réponse 1) ; le skill `lire-les-donnees` dit qu'elle existe.
|
||||
- [ ] Une séance de `/aiguiser` sur un lot thermique (l'utilisateur la lance, `run.md`).
|
||||
- [ ] `analyser-lot` : l'analyste regarde la température devant tout effet thermique.
|
||||
|
||||
**À revoir (2026-10-29).** `/events-learner` a maintenant un `tool-builder`, et l'analyste écrit ses propres scripts (D-097, autre conversation) : les températures peuvent arriver par là plutôt que par `/aiguiser`.
|
||||
|
||||
### Point 60 : Des cas thermiques construits et validés
|
||||
|
||||
**L'idée** (l'utilisateur, 2026-10-29). Construire des cas concrets de chacun des trois effets, dans leurs différentes circonstances (caméra sur un pont, ouvrage seul, les deux), les documenter et qu'il les valide : l'analyste les apprend par la base d'events.
|
||||
|
||||
**Proposition (Claude).** Chercher dans `data/` une période candidate par effet (JUNGFRAU pour la caméra ; pour l'ouvrage, la station aux refroidissements tardifs vue ce jour), température tracée (point 59) ; les montrer à l'utilisateur ; il choisit et lance `/new-event` sur chacune. La carte apprend de chaque event validé (D-087).
|
||||
|
||||
- [ ] L'utilisateur dit sur quelle station il a vu les refroidissements tardifs.
|
||||
- [ ] Après les points 58 et 59 : les périodes candidates, présentées à l'utilisateur.
|
||||
- [ ] `/new-event` par l'utilisateur, un cas par effet ; sa validation.
|
||||
|
||||
### Point 61 : Heat haze : quand il y en a, quand il n'y en a pas
|
||||
|
||||
**Ce qu'en dit l'utilisateur (2026-10-29).** Le heat haze (catégorie `turbulence`) est un effet thermique à part, une forme de bruit, qui n'apparaît que quand il fait vraiment chaud sur l'ouvrage ; sous un pont, comme à JUNGFRAU, il n'y en a pas. On ne sait pas encore comment le capter.
|
||||
|
||||
**À trancher.** Ce qui le distingue des autres bruits (vent fort, mât qui vibre, visibilité moyenne). La carte (section 1) dit déjà : de jour, toutes les cibles, surtout les lointaines, `error_value` 1,5 à 3 fois celle de la nuit ; la température et la qualité (flux, netteté) pourraient le confirmer.
|
||||
|
||||
- [ ] L'utilisateur dit les conditions du heat haze (chaleur sur l'ouvrage, soleil, distance des cibles) ; le savoir dans `docs/displacement/domaine/` et la carte.
|
||||
- [ ] Un cas avec, un cas sans (JUNGFRAU), au point 60.
|
||||
|
||||
### Point 62 : Visibilité réduite ou cible masquée
|
||||
|
||||
**Ce qu'a vu l'utilisateur (2026-10-29).** À JUNGFRAU (PS des Coudres), du brouillard rangé par les détecteurs en `cible_masquee` (Target hidden) : c'est une visibilité réduite. La distinction compte : une **réduction de visibilité** est une baisse du flux, homogène ; une **occultation**, un objet devant la cible. Un détecteur qui ne lit que les courbes de mouvement les sépare mal ; les métriques de qualité le devraient (flux, pic, netteté, dominance).
|
||||
|
||||
**Les deux voies.**
|
||||
- A. Tout regrouper sous « visibilité réduite », avec les cibles touchées : simple, sans les métriques de qualité.
|
||||
- B. Deux catégories, avec un critère robuste d'occultation tiré des métriques de qualité (par exemple : le flux d'une ou de quelques cibles voisines tombe d'un coup, les autres gardent le leur ; contre un flux qui baisse partout, plus sur les lointaines). L'utilisateur ne veut pas lâcher cette voie.
|
||||
|
||||
**Recommandation (Claude).** A tant qu'une station n'a pas les métriques de qualité, B dès qu'elle les a ; la décision suit le point 63.
|
||||
|
||||
- [ ] La décision de l'utilisateur ; entrée dans `docs/decisions.md`, carte (section 4), `categories.py`.
|
||||
- [ ] Si B : un cas de brouillard (JUNGFRAU) et un cas d'occultation, validés.
|
||||
|
||||
### Point 63 : Les métriques de qualité : quelles stations, et la qualité recalculée
|
||||
|
||||
**L'idée** (l'utilisateur, 2026-10-29). Sans les métriques de qualité, un diagnostic précis est difficile ; les courbes de mouvement seules ne suffisent pas. Mais peu de stations les ont. Deux choix : ne traiter désormais que les stations qui les ont, ou les recalculer après coup avec l'émulateur (`~/optical_emulator`, travail en cours dans le projet optique).
|
||||
|
||||
**Ce qui existe (Claude, 2026-10-29).** Dans `data/`, seul NADELHORN a `quality/` (du 25 au 27/10) : par capteur et par image, `peak`, `flux`, `sharpness`, `fwhm`, `dominance`, `snr`. `donnees.py` reconnaît ces fichiers sans les lire ; `run.md` a déjà les métriques de qualité par l'émulateur. Pas de quoi entraîner un détecteur aujourd'hui.
|
||||
|
||||
**Questions à l'utilisateur.** Le choix : stations avec qualité seulement, qualité recalculée, ou selon la station ; quelles stations suivies l'auront, et quand.
|
||||
|
||||
- [ ] La décision de l'utilisateur.
|
||||
- [ ] Les métriques de qualité dans les outils de lecture et le skill (même chemin qu'au point 59 : un premier pas, puis `/aiguiser`).
|
||||
- [ ] L'analyste s'en sert (`analyser-lot`).
|
||||
|
||||
### Point 64 : Les sauts : dire pourquoi
|
||||
|
||||
**L'idée** (l'utilisateur, 2026-10-29). Un saut bref revient toujours à la normale, c'est ce qui le rend bénin ; dire « saut » ne suffit pas, il faut dire ce qui l'a causé. Assez souvent, une **référence** est cachée ou moins bien vue : la reprojection décale d'un coup des points, souvent groupés dans une partie de l'image ; au retour de la référence, la recalibration les ramène. Chaque cas est particulier.
|
||||
|
||||
**Ce qui existe.** La carte a les éventualités « Références masquées » (`error_value` haut sur une partie des références, `sigma0` qui monte, puis les `corr` qui se décalent) et « Une référence a bougé » ; aucun détecteur ne regarde les références.
|
||||
|
||||
**Garde-fou** (`CLAUDE.md`, Règles non négociables). Rien sur `inlier` binaire ni sur `sigma0` seul : poids continus, résidus, `N_eff`, influence ; des références cohérentes ne sont pas forcément fixes.
|
||||
|
||||
- [ ] L'utilisateur précise les causes de saut qu'il connaît (référence cachée, perdue, autre) et comment il les voit.
|
||||
- [ ] Des cas validés (`/new-event`), dont une référence cachée.
|
||||
- [ ] L'analyste cherche la cause de chaque saut (références, zone de l'image) ; puis `/events-learner`.
|
||||
|
||||
### Point 65 : Un saut marqué dès son début
|
||||
|
||||
**Ce qu'a vu l'utilisateur (2026-10-29).** `sauts` marque le saut un peu après son début ; l'événement doit englober tout le saut. Un détail : le journal se calcule après coup, on peut reculer le début jusqu'au départ du mouvement.
|
||||
|
||||
- [ ] Reculer le début de l'épisode dans `detectors/sauts.py` jusqu'à la dernière mesure au niveau d'avant ; vérifier par la page des détecteurs (NIEDERHORN, du 2026-09-25 au 2026-10-08) et le benchmark.
|
||||
|
||||
### Point 66 : Client et spécialiste : la complexité sur demande
|
||||
|
||||
**L'idée** (l'utilisateur, 2026-10-29). Les catégories nouvelles (trois effets thermiques, causes des sauts…) ajoutent beaucoup de complexité ; il faut des niveaux d'abstraction : le client voit l'essentiel, le spécialiste déplie le détail sur demande. La page Status (`detectors-view/status.py`) en est une bonne base visuelle. Lié au point 23 (deux couches : client et support) et à la hiérarchie des status (D-095).
|
||||
|
||||
- [ ] Quand les catégories des points 58, 62 et 64 sont décidées : pour chacune, le niveau client et le niveau spécialiste.
|
||||
|
||||
### Point 67 : Le savoir métier de l'analyste : le mécanisme, sans plus de pages
|
||||
|
||||
**L'idée** (l'utilisateur, 2026-10-29). L'analyste a besoin du savoir métier pour faire au mieux son travail ; les documents qu'on lui donne suffisent-ils ? On ne veut pas l'alourdir. Le savoir technique que l'utilisateur dit dans ses vocaux lui serait utile.
|
||||
|
||||
**Ce qu'il lit aujourd'hui (Claude, 2026-10-29).** `analyser-lot` (9,5 Ko), `lire-les-donnees` (21,5 Ko), `colonnes-des-deplacements` (6,3 Ko), `pieges-des-donnees` (2,8 Ko), la carte des événements (32,7 Ko), `read-event` et `events/INDEX.md` (12 Ko), puis jusqu'à trois fiches : environ 85 Ko, de l'ordre de 20 000 jetons avant la première donnée.
|
||||
|
||||
**Constat (Claude).**
|
||||
- Son savoir est un **catalogue de symptômes** (carte, section 1 : chaque éventualité et sa signature) et un dictionnaire des colonnes. Il lui manque le **mécanisme** : comment une mesure se fait, et où chaque cause entre dans la chaîne. C'est ce que l'utilisateur sait et dit : une référence cachée, la reprojection décale une zone de l'image, la recalibration la ramène ; le support chauffe, la caméra compense mal ; le brouillard baisse le flux partout, un objet le coupe sur une cible. Avec le mécanisme, l'analyste raisonne sur un cas que la carte ne liste pas ; sans lui, il apparie des signatures (le brouillard de JUNGFRAU pris pour une cible masquée, point 62).
|
||||
- Les règles non négociables des déplacements (`inlier` binaire, `sigma0` seul, mode commun contre mouvement de l'ouvrage, références cohérentes contre références fixes) sont dans `CLAUDE.md`, que l'analyste ne lit pas (`omitClaudeMd`, et la liste de ce qu'il a le droit de lire) ; aucun de ses documents ne les redit.
|
||||
- Ce qui pèse sans servir : la carte est lue en entier, avec la « Phrase au client » et la source de chaque éventualité, inutiles pour étiqueter.
|
||||
|
||||
**Proposition (Claude).**
|
||||
1. Une note courte, **la chaîne de mesure** (`docs/displacement/domaine/chaine-de-mesure.md`, une page), lue par l'analyste avant la carte : les étages (air, obstacle, cible, objectif, caméra et support, références et compensation, ouvrage) ; pour chacun, ce qu'il touche dans les données (positions brutes, `corr`, `error_value`, qualité, `reproj_err` des références, température) et son temps propre ; les règles non négociables en quatre lignes. Les savoirs des points 58, 61, 62 et 64 y entrent à mesure que l'utilisateur les valide, au lieu de s'éparpiller en notes.
|
||||
2. La carte reste le vocabulaire (section 4, les catégories) ; la section 1 se consulte à la demande (`grep` de l'éventualité), pas en entier : au total, moins lu qu'aujourd'hui.
|
||||
3. Savoir si c'est mieux, sans deviner : rejouer l'analyste sur un lot dont on connaît la réponse (le brouillard de JUNGFRAU), avant et après la note. Proposé, pas lancé.
|
||||
|
||||
**Où la mettre** (question de l'utilisateur, réponse de Claude, 2026-10-29). Dans `docs/displacement/domaine/`, la place du savoir métier des déplacements (règle de travail de `CLAUDE.md`), ajoutée à la liste de ce que l'analyste a le droit de lire. Pas dans `events/` : c'est la base qui grandit par les processus automatiques (l'`event-builder` y écrit, la carte y apprend, D-087), alors que le mécanisme ne change que sur la parole de l'utilisateur. Pas `CLAUDE.md` en partie : c'est la carte du projet pour les conversations, et l'analyste en est tenu à l'écart exprès (des conclusions sur les données) ; seules les quatre règles des déplacements le concernent, recopiées dans la note. La note ne redit ni les colonnes (`colonnes-des-deplacements.md`) ni les signatures (la carte) : elle dit pourquoi.
|
||||
|
||||
**Questions à l'utilisateur.**
|
||||
1. La note de la chaîne de mesure, plutôt que des notes éparses ?
|
||||
2. La carte lue à la demande ?
|
||||
3. Le test avant et après, et sur quel lot ?
|
||||
|
||||
- [ ] Les réponses de l'utilisateur.
|
||||
- [ ] Un brouillon de la note, tiré des vocaux du 2026-10-29 et des documents d'AIMsight (référence, §4.3 ; contexte support, §4), relu par l'utilisateur.
|
||||
- [ ] `analyser-lot` : la note parmi ce qu'il lit ; la carte à la demande.
|
||||
- [ ] Le test, si l'utilisateur le veut.
|
||||
|
||||
---
|
||||
|
||||
## Annexe A — Les rapports des agents du 2026-10-23, résumés
|
||||
|
||||
Huit agents, un par piste, lancés par l'orchestrateur ; tous ont rendu leur travail. Rien n'a été commité.
|
||||
@@ -1433,3 +1723,10 @@ Une ligne par séance : date, point(s) traités, ce qui a changé, ce qui reste.
|
||||
- 2026-10-29 : point 55 ajouté (idée de l'utilisateur : `/boucle` devient `events-learner` ; releveur et améliorateur à part, dans une autre conversation).
|
||||
- 2026-10-29 : point 55, revue de l'orchestrateur : benchmark de fin sur les mêmes events, spec réduite, renommage ; lot unique laissé.
|
||||
- 2026-10-29 : point 55, D-092 : `/boucle` devient `/events-learner` (skill, scripts, séances, spec, page, commits), plus de benchmark de fin, spec réduite au pourquoi.
|
||||
- 2026-10-29 : point 56 ajouté (idée de l'utilisateur : optimiser `/aiguiser` comme `/events-learner`) ; constat (neuf modifications, toutes gardées ; outils ×3,4) et transposition de Claude : `reading-critic`, `reading-upgrader`, `reading-control`, orchestrateur, spec ; quatre questions.
|
||||
- 2026-10-29 : point 56, l'utilisateur : étape par étape du déroulé ; étape 1, le lecteur : rôle inchangé, une section « Ce qui m'a encombré », deux consignes du skill corrigées à la main (Bash, pas natif).
|
||||
- 2026-10-29 : retour vocal de l'utilisateur sur les détecteurs : partie IX, nouvelle, points 57 à 66 : dire la cause plutôt que l'événement, l'analyste d'abord ; les trois effets thermiques (objectif, support, ouvrage) et leurs temps de chauffe ; les températures par `/aiguiser` ; des cas thermiques ; heat haze ; visibilité réduite ou cible masquée ; les métriques de qualité (seul NADELHORN les a) ; la cause des sauts ; le début d'un saut ; client et spécialiste. Rien documenté hors du plan, à sa demande ; questions dans chaque point.
|
||||
- 2026-10-29 : point 56, l'utilisateur remet en cause `/aiguiser` (un lecteur sans notion de pertinence ; combiner avec `/events-learner`) ; avis de Claude : d'accord sur le fond ; l'analyste dit ce qui lui manque, un `reading-upgrader` dans `/events-learner`, l'audit indépendant en piste.
|
||||
- 2026-10-29 : point 56, proposition de l'utilisateur : l'analyste voit ses données, crée ses outils et les décrit (section Outils) ; un `tool-builder` les adapte ; précisions de Claude (inventaire étendu, ordre, pas de contrôle, `/aiguiser` retiré).
|
||||
- 2026-10-29 : point 67 ajouté (idée de l'utilisateur : le savoir métier de l'analyste suffit-il, sans l'alourdir ?) : constat de Claude (un catalogue de symptômes, pas le mécanisme ; les règles des déplacements de `CLAUDE.md` ne lui parviennent pas ; ~85 Ko lus) ; proposition : une note d'une page, la chaîne de mesure, et la carte lue à la demande ; trois questions. Point 59 : à revoir avec le `tool-builder` (D-097).
|
||||
- 2026-10-29 : point 56, D-097 : `/aiguiser` retiré ; l'analyste voit ses données (`inventaire.py`), écrit ses scripts, dit ses outils ; le `tool-builder` optimise ou ajoute, sans retrait ni contrôle ; à essayer sur une séance.
|
||||
Reference in new issue
Block a user