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:
maximeandClaude Opus 5.5 committed 2026-10-29 17:10:17 +01:00
1 parent 52de2becbf
commit 7fb176cf0a
24 files changed
+555 -513

No files matched your search

+3 -3
View File
@@ -14,7 +14,7 @@ vues-deplacements/
└── parcours.md la démarche de l'utilisateur, qu'il décrit étape par étape en conversation et que Claude note ici : pages ouvertes, ce qu'il y cherchait, où il a bloqué, son verdict
```
Sortis de ce dossier, à la racine du dépôt (D-084) : les détecteurs, `detectors/`, et les séances des processus automatiques, `events-learner/` et `aiguiser/` ; les chemins ci-dessous qui les citent partent de la racine. Restent ici `maquette/`, `contexte/`, `cas/` et `benchmark/`.
Sortis de ce dossier, à la racine du dépôt (D-084) : les détecteurs, `detectors/`, et les séances des processus automatiques, `events-learner/` et `aiguiser/` (retiré, historique) ; les chemins ci-dessous qui les citent partent de la racine. Restent ici `maquette/`, `contexte/`, `cas/` et `benchmark/`.
Le code et les maquettes du chantier vivent dans `maquette/` (D-053, D-054) : `explore.py` (maquette de la page Explore avec les onglets View, Diagnosis et Displacements, `python3 vues-deplacements/maquette/explore.py [dossier de station]`, page dans `out/`), son gabarit `explore_template.html` et sa spec `spec.md`.
@@ -22,9 +22,9 @@ Détection mécanique des anomalies (D-055) : faire ressortir les courbes qui co
Journal du matin du client (D-056), le cap actuel : onglet `Journal` de la maquette ; un détecteur élémentaire par fichier dans `detectors/` (`detect(mesures)` -> épisodes `start`, `end`, `kind`, `label`, `text`, `ignore`, `sensors`), chargés et classés en événements des douze catégories du journal (D-074) par `detectors/categories.py` (`python3 detectors/categories.py <dossier>` : une ligne par événement), que `explore.py` affiche ; brainstorming et pistes dans `contexte/journal-du-matin.md`, registre des seuils provisoires dans `contexte/seuils-du-journal.md`, lissage dans `contexte/lissage.md`, données en masse et boucle Claude dans `contexte/donnees-et-boucle.md`.
Boucle automatique (D-057), lancée par l'utilisateur seul, sur les lots qu'il choisit : `/events-learner <dossier de station> [--du … --au …]` fait analyser chaque lot par un analyste, juger les détecteurs du journal face à son analyse par un detectors-critic (D-090), les fait corriger par un detectors-upgrader, contrôlé sur la base d'events par un detectors-control (D-089), et fait décider par un event-builder ce que le lot apprend de nouveau à la base d'events (D-091) ; une séance commitée directement sur `master` (D-070), ses rendus dans `events-learner/<séance>_<STATION>/lot-NN/` (dont les étiquettes de l'analyste, `etiquettes.json`, D-061, et `score-avant.txt`, le score des détecteurs face à toutes les étiquettes, D-062) et son `bilan.md`, hors de tout dossier de station ; en fin de séance, la page `out/events-learner_<séance>.html` montre l'analyste face aux détecteurs (D-066) ; à chaque lot et après chaque modification, le benchmark des détecteurs sur la base d'events (`.claude/skills/events-learner/benchmark.py`, historique dans `benchmark/historique.csv`, D-069) ; avec `--ameliorer`, l'améliorateur corrige ensuite le skill et ses agents d'après les relevés du releveur (D-071) ; spec `contexte/events-learner.md`.
Boucle automatique (D-057), lancée par l'utilisateur seul, sur les lots qu'il choisit : `/events-learner <dossier de station> [--du … --au …]` fait analyser chaque lot par un analyste (qui peut écrire ses propres scripts et dit les outils dont il s'est servi), améliorer les outils de lecture (`agent-tools/`) d'après eux par un tool-builder, qui optimise ou ajoute sans rien retirer (D-097), juger les détecteurs du journal face à son analyse par un detectors-critic (D-090), les fait corriger par un detectors-upgrader, contrôlé sur la base d'events par un detectors-control (D-089), et fait décider par un event-builder ce que le lot apprend de nouveau à la base d'events (D-091) ; une séance commitée directement sur `master` (D-070), ses rendus dans `events-learner/<séance>_<STATION>/lot-NN/` (dont les étiquettes de l'analyste, `etiquettes.json`, D-061, et `score-avant.txt`, le score des détecteurs face à toutes les étiquettes, D-062) et son `bilan.md`, hors de tout dossier de station ; en fin de séance, la page `out/events-learner_<séance>.html` montre l'analyste face aux détecteurs (D-066) ; à chaque lot et après chaque modification, le benchmark des détecteurs sur la base d'events (`.claude/skills/events-learner/benchmark.py`, historique dans `benchmark/historique.csv`, D-069) ; avec `--ameliorer`, l'améliorateur corrige ensuite le skill et ses agents d'après les relevés du releveur (D-071) ; spec `contexte/events-learner.md`.
Aiguiser la lecture (D-059), lancé par l'utilisateur seul, sur les lots qu'il choisit : `/aiguiser <dossier de station> [--du … --au …]` améliore les outils de lecture (`agent-tools/`) et leur mode d'emploi, le skill `lire-les-donnees`, que suivent l'analyste et l'agent de diagnostic : un lecteur lit le lot avec le skill, un correcteur le lit à fond avec ses propres scripts et mesure l'écart, un optimiseur modifie le skill, un changement sans gain est annulé ; commandes des fiches lancées en fin de séance (D-064) ; une séance commitée directement sur `master` (D-077), ses rendus dans `aiguiser/<séance>_<STATION>/lot-NN/` et `bilan.md`, hors de tout dossier de station ; avec `--ameliorer`, l'améliorateur corrige ensuite le skill et ses agents d'après les relevés du releveur (D-076) ; spec `contexte/aiguiser-la-lecture.md`.
Aiguiser la lecture (D-059) : `/aiguiser`, retiré le 2026-10-29 (D-097) ; ses séances restent dans `aiguiser/`, sa spec dans `contexte/aiguiser-la-lecture.md`, comme historique. Les outils de lecture s'améliorent désormais dans `/events-learner`, par le `tool-builder`.
## Règles
@@ -1,5 +1,7 @@
# Aiguiser la lecture : conception
> **Remplacée le 2026-10-29 (D-097)** : `/aiguiser` est retiré ; l'analyste de `/events-learner` crée ses propres outils et un `tool-builder` les fait entrer dans `agent-tools/` (spec `events-learner.md`). Cette page reste comme historique, avec les séances de `aiguiser/`.
Point 42 du plan `docs/superpowers/plans/2026-10-23-journal-du-matin.md`, brainstorming du 2026-10-24. Statut : **approuvée par l'utilisateur le 2026-10-24**, **construite le même jour** (D-059) ; plan de construction : `docs/superpowers/plans/2026-10-24-aiguiser-la-lecture.md`. Pendant la construction, une règle du projet est venue s'ajouter (D-060) : chaque rendu finit par `## Difficultés`, et l'orchestrateur appelle le releveur en fin de séance. Ce qui vient de l'utilisateur est dit « l'utilisateur » ; le reste est un choix de Claude, marqué *(choix de Claude)* ; « accepté » : proposé par Claude, accepté par l'utilisateur le 2026-10-24.
## 1. Pourquoi
+10 -6
View File
@@ -1,6 +1,6 @@
# events-learner : conception
Point 31 du plan `docs/superpowers/plans/2026-10-23-journal-du-matin.md`, brainstorming du 2026-10-24, d'abord sous le nom `/boucle` ; **approuvée par l'utilisateur le 2026-10-24**, rôles revus le 2026-10-29 (points 51 à 55 du plan, D-087 à D-092). Ce qui vient de l'utilisateur est dit « l'utilisateur » ; le reste est un choix de Claude, marqué *(choix de Claude)*.
Point 31 du plan `docs/superpowers/plans/2026-10-23-journal-du-matin.md`, brainstorming du 2026-10-24, d'abord sous le nom `/boucle` ; **approuvée par l'utilisateur le 2026-10-24**, rôles revus le 2026-10-29 (points 51 à 55 du plan, D-087 à D-092) ; les outils de lecture y entrent le même jour, avec le `tool-builder`, et `/aiguiser` se retire (point 56, D-097). Ce qui vient de l'utilisateur est dit « l'utilisateur » ; le reste est un choix de Claude, marqué *(choix de Claude)*.
Cette page dit **pourquoi** le processus est ainsi. **Comment** il tourne est écrit une seule fois, ailleurs : le déroulé dans le skill `.claude/skills/events-learner/SKILL.md`, chaque rôle dans sa consigne, `.claude/agents/<agent>.md`. Ne pas les recopier ici.
@@ -8,9 +8,10 @@ Cette page dit **pourquoi** le processus est ainsi. **Comment** il tourne est é
L'utilisateur veut que Claude apprenne sur des lots entiers de données de stations, sans lui : passer les détecteurs du journal du matin sur un lot, juger leurs résultats comme le ferait un expert, en regardant lui-même les courbes et les images, corriger les détecteurs, et garder sous forme d'events tout ce qui est nouveau.
À la fin d'une séance, il reste deux choses durables (l'utilisateur) :
À la fin d'une séance, il reste trois choses durables (l'utilisateur) :
1. **de la connaissance** : de nouveaux events, appris sur des événements réels, de la même forme que ceux de la base, dans la même base, `events/` (l'utilisateur) ;
2. **des détections optimisées** : des détecteurs mieux réglés.
2. **des détections optimisées** : des détecteurs mieux réglés ;
3. **des outils de lecture meilleurs** (D-097) : ceux dont l'analyste s'est servi, ou qu'il a dû écrire, optimisés ou ajoutés à `agent-tools/`. Seul l'analyste sait ce qui est pertinent dans les données : c'est son travail réel qui guide les outils (l'utilisateur, 2026-10-29), et non un lecteur à part qui en extrait tout sans savoir ce qui compte (`/aiguiser`, retiré).
## 2. Buts, non-buts, ce qui serait un échec
@@ -24,7 +25,7 @@ L'utilisateur veut que Claude apprenne sur des lots entiers de données de stati
- Mesurer les progrès de l'analyste (l'utilisateur, 2026-10-29, D-088).
**Ce qui serait un échec.**
- **La complexité** : des détecteurs qui gonflent de règles et de cas particuliers pour un petit gain (la crainte de l'utilisateur).
- **La complexité** : des détecteurs qui gonflent de règles et de cas particuliers pour un petit gain (la crainte de l'utilisateur) ; de même des outils de lecture qui grossissent sans servir, risque que le `tool-builder`, qui ne retire rien et n'a pas de contrôle (D-097), laisse ouvert : à observer.
- **Le sur-apprentissage** : des détecteurs collés au lot courant, qui perdent en précision sur les events de la base (l'utilisateur, 2026-10-29, D-089).
- Toucher aux events validés ou aux catégories du journal, validées *(choix de Claude)*.
- Un détecteur cassé qui disparaît sans bruit : le chargeur de `categories.py` saute, avec un simple message, un fichier qui ne se charge pas *(constaté dans le code)*.
@@ -35,7 +36,8 @@ L'utilisateur veut que Claude apprenne sur des lots entiers de données de stati
| Agent | Sa seule responsabilité | Ce qu'il ne voit pas | Décisions |
|---|---|---|---|
| `analyste` (skill `analyser-lot`) | l'analyse la plus précise du lot, la vérité ; tous les outils, détecteurs et base d'events compris | le code des détecteurs, les autres séances | D-088, D-090 |
| `analyste` (skill `analyser-lot`) | l'analyse la plus précise du lot, la vérité ; tous les outils, détecteurs et base d'events compris, et ses propres scripts ; il dit les outils dont il s'est servi | le code des détecteurs, les autres séances | D-088, D-090, D-097 |
| `tool-builder` | optimiser ou ajouter des outils de lecture d'après ceux dont l'analyste s'est servi ; ne rien retirer : un seul lot ne suffit pas (l'utilisateur) | les détecteurs | D-097 |
| `detectors-critic` | juger les détecteurs face à l'analyse : quoi et où | les données | D-090 |
| `detectors-upgrader` | adapter les détecteurs (ajouter, retirer, modifier), le plus simple d'abord | — | D-089 |
| `detectors-control` | le garde-fou contre le sur-apprentissage ; il décide | le lot (données, critique, score) | D-089 |
@@ -57,7 +59,7 @@ L'utilisateur veut que Claude apprenne sur des lots entiers de données de stati
## 5. Ce que l'utilisateur trouve à la fin
Les commits de la séance ; `bilan.md` (le lot, la modification gardée ou non, les events créés, les contradictions avec la base, les erreurs) ; les difficultés du processus dans `docs/ameliorations-processus.md` ; la page `out/events-learner_<séance>.html` (D-066), la lecture de l'analyste au-dessus des événements des détecteurs, catégorie par catégorie. Le but, séance après séance : que les deux coïncident. Les events appris attendent sa revue par `/review-event`.
Les commits de la séance ; `bilan.md` (le lot, les outils modifiés, la modification gardée ou non, les events créés, les contradictions avec la base, les erreurs) ; les difficultés du processus dans `docs/ameliorations-processus.md` ; la page `out/events-learner_<séance>.html` (D-066), la lecture de l'analyste au-dessus des événements des détecteurs, catégorie par catégorie. Le but, séance après séance : que les deux coïncident. Les events appris attendent sa revue par `/review-event`.
## 6. Essai et séances
@@ -67,6 +69,8 @@ Les commits de la séance ; `bilan.md` (le lot, la modification gardée ou non,
## Annexe : pistes à revoir
- Un contrôle du `tool-builder` (sur le diff des outils, sans le lot), si les outils grossissent sans servir : l'utilisateur ne sait pas encore comment le faire (D-097).
- Un audit indépendant de la lecture commune (`donnees.py`), par des scripts qui ne passent pas par elle, comme le correcteur de `/aiguiser` qui a trouvé l'erreur des rejets des références : de temps en temps, ou quand `donnees.py` change.
- Plusieurs analystes en parallèle : les lots sont indépendants ; le `detectors-upgrader` reste seul, pour que deux agents ne modifient jamais le même détecteur.
- Le rejeu sur les lots déjà vus (écarté le 2026-10-24 : trop lourd, pas exhaustif voulu).
- Un plafond de lots ou de coût par séance ; plusieurs stations par séance.