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