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
+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.
|
||||
Reference in new issue
Block a user