Loop renamed events-learner; end benchmark on the same events; spec reduced to the why (D-092)

- /boucle becomes /events-learner: skill and scripts in
  .claude/skills/events-learner/, sessions in events-learner/, spec
  vues-deplacements/contexte/events-learner.md, end page
  out/events-learner_<session>.html, commits "Learn <STATION> ...";
  history keeps /boucle, the review page reads both.
- No benchmark-fin.txt: the end benchmark is the last kept
  modification's, on the same events as the start.
- The spec keeps only the why; the how lives in the skill and agents.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-29 10:27:05 +01:00
1 parent 79d83be3ff
commit 3b732adc52
169 files changed
+231 -288

No files matched your search

@@ -4,28 +4,28 @@ Point 42 du plan `docs/superpowers/plans/2026-10-23-journal-du-matin.md`, brains
## 1. Pourquoi
L'analyste de `/boucle` et l'agent de diagnostic prennent les données d'un lot et en font un jugement. Pour bien juger, il faut d'abord bien **lire** les données, et ce n'est pas facile (l'utilisateur). Il y a deux côtés : la **lecture** (comprendre ce que montrent les courbes et les images) et le **diagnostic** (les détecteurs du journal, que l'analyste critique et que `/boucle` améliore). Les deux ne demandent pas les mêmes scripts. Si l'analyste lisait les données avec les détecteurs, il serait biaisé et tendrait à les valider (l'utilisateur).
L'analyste de `/events-learner` et l'agent de diagnostic prennent les données d'un lot et en font un jugement. Pour bien juger, il faut d'abord bien **lire** les données, et ce n'est pas facile (l'utilisateur). Il y a deux côtés : la **lecture** (comprendre ce que montrent les courbes et les images) et le **diagnostic** (les détecteurs du journal, que l'analyste critique et que `/events-learner` améliore). Les deux ne demandent pas les mêmes scripts. Si l'analyste lisait les données avec les détecteurs, il serait biaisé et tendrait à les valider (l'utilisateur).
On veut donc un autre processus automatique, à part de `/boucle`, qui ne travaille que sur le côté lecture : les outils dont Claude se sert pour lire les données, améliorés lot après lot, sur plusieurs jeux de données et sur plusieurs itérations, et repris quand de nouveaux champs de données arriveront. Le but : **aiguiser la vision de Claude**, et rendre l'analyste et l'agent de diagnostic plus performants en leur donnant des outils plus robustes (l'utilisateur).
On veut donc un autre processus automatique, à part de `/events-learner`, qui ne travaille que sur le côté lecture : les outils dont Claude se sert pour lire les données, améliorés lot après lot, sur plusieurs jeux de données et sur plusieurs itérations, et repris quand de nouveaux champs de données arriveront. Le but : **aiguiser la vision de Claude**, et rendre l'analyste et l'agent de diagnostic plus performants en leur donnant des outils plus robustes (l'utilisateur).
## 2. Buts, non-buts, ce qui serait un échec
**Buts.**
- Une commande lance une séance sur un dossier de station ; elle tourne seule jusqu'au bout ; tout est commité, étape par étape, directement sur `master`, comme `/boucle` (D-070 ; d'abord sur une branche à part, accepté le 2026-10-24, remplacée par D-077).
- Une commande lance une séance sur un dossier de station ; elle tourne seule jusqu'au bout ; tout est commité, étape par étape, directement sur `master`, comme `/events-learner` (D-070 ; d'abord sur une branche à part, accepté le 2026-10-24, remplacée par D-077).
- À la fin, un skill de lecture meilleur (§4) : ses outils et son mode d'emploi. Il sert à l'analyste et à l'agent de diagnostic, donc chaque gain profite aux deux (accepté).
- Elle tourne sur n'importe quelles données, sans vérité connue : pas seulement sur les cinq events validés (l'utilisateur).
**Non-buts.**
- Les détecteurs du journal : c'est `/boucle`.
- La base d'events : la séance n'ajoute aucun event ; ce que le correcteur trouve de nouveau va au bilan, pour `/boucle` ou `/new-event` *(choix de Claude)*.
- Les détecteurs du journal : c'est `/events-learner`.
- La base d'events : la séance n'ajoute aucun event ; ce que le correcteur trouve de nouveau va au bilan, pour `/events-learner` ou `/new-event` *(choix de Claude)*.
- Le raisonnement de diagnostic : classer, comparer aux events, faire des hypothèses, conclure. Seule la lecture change.
- Récupérer les données (un dossier de station au format de `data/<STATION>/`, comme `/boucle`) ; les autres domaines.
- L'exhaustivité : pas de rejeu des lots déjà vus, comme `/boucle`.
- Récupérer les données (un dossier de station au format de `data/<STATION>/`, comme `/events-learner`) ; les autres domaines.
- L'exhaustivité : pas de rejeu des lots déjà vus, comme `/events-learner`.
**Ce qui serait un échec.**
- **Des outils qui jugent** : un seuil, une catégorie, « anomalie ici » dans ce que rend un outil. Ils deviendraient des détecteurs de plus, et l'analyste finirait par valider ce qu'il lit (accepté).
- **Des outils taillés pour les events** : un outil qui « sait » où chercher la buée de E-001, une règle propre à une station, à un capteur ou à une date (accepté).
- **La complexité** : des outils qui se multiplient et un mode d'emploi qui s'allonge pour un petit gain (même crainte que pour `/boucle`, accepté).
- **La complexité** : des outils qui se multiplient et un mode d'emploi qui s'allonge pour un petit gain (même crainte que pour `/events-learner`, accepté).
- Casser une commande citée par une fiche d'events : les fiches E-001 à E-005 citent des commandes de `resume.py`, `inventaire.py` et `vignettes.py` avec leurs options, et les events existants ne se modifient jamais *(constaté dans les fiches)*.
- Un lecteur qui voit le corrigé, ou un correcteur qui lit avec les outils qu'on améliore : la mesure ne vaudrait plus rien.
@@ -34,7 +34,7 @@ On veut donc un autre processus automatique, à part de `/boucle`, qui ne travai
- **Les outils de lecture**, `agent-tools/` (419 lignes) : `donnees.py` (lecture commune des exports), `inventaire.py`, `resume.py`, `graphique.py` (PNG des séries), `vignettes.py` (gros plans des capteurs sur les images). Bibliothèque standard, matplotlib par `.venv` pour les figures. Ils rendent des valeurs, jamais des verdicts.
- **Leur mode d'emploi est recopié à deux endroits** : le tableau « Tes outils » et l'étape 1 de `.claude/skills/analyser-lot/SKILL.md` (l'analyste ; `critiquer-lot` avant D-090), le §3 et une partie du §4 (étapes 1, 2 et 4) de `agent-diagnostic/instructions.md` (l'agent de diagnostic).
- **Les cinq events validés**, `events/E-001/` à `E-005/` : données (`displacement/`, `images/`), fiche `event.md` (signature en critères, avec leurs commandes) et figures, dans le même dossier.
- **Le modèle de `/boucle`** (D-057, `vues-deplacements/contexte/boucle-automatique.md`, skill `.claude/skills/boucle/SKILL.md`) : un skill orchestrateur dans la conversation principale, des sous-agents qui ne se parlent pas et écrivent chacun un rendu, une ligne `**Verdict** :` lue par `grep`, des commits par chemin, une branche par séance, un `bilan.md`. Un passage de l'analyste coûte environ 250 000 jetons et 8 min 30 (essai du 2026-10-24).
- **Le modèle de `/events-learner`** (D-057, `vues-deplacements/contexte/events-learner.md`, skill `.claude/skills/events-learner/SKILL.md`) : un skill orchestrateur dans la conversation principale, des sous-agents qui ne se parlent pas et écrivent chacun un rendu, une ligne `**Verdict** :` lue par `grep`, des commits par chemin, une branche par séance, un `bilan.md`. Un passage de l'analyste coûte environ 250 000 jetons et 8 min 30 (essai du 2026-10-24).
## 4. Ce qu'on optimise : le skill `lire-les-donnees`
@@ -52,9 +52,9 @@ Il ne contient ni catégorie, ni event, ni hypothèse, ni verdict : c'est l'affa
## 5. Une séance
**Lancement** : `/aiguiser <dossier de station> [--du AAAA-MM-JJ] [--au AAAA-MM-JJ] [--ameliorer]`, par l'utilisateur seul, d'après son expression « aiguiser la vision » (accepté). Séparé de `/boucle` (l'utilisateur : « un autre processus automatique »). **La plage est le lot**, sans découpe, comme pour `/boucle` (D-078, D-072) : une séance, un lot, de la longueur choisie par `--du` / `--au` (l'utilisateur).
**Lancement** : `/aiguiser <dossier de station> [--du AAAA-MM-JJ] [--au AAAA-MM-JJ] [--ameliorer]`, par l'utilisateur seul, d'après son expression « aiguiser la vision » (accepté). Séparé de `/events-learner` (l'utilisateur : « un autre processus automatique »). **La plage est le lot**, sans découpe, comme pour `/events-learner` (D-078, D-072) : une séance, un lot, de la longueur choisie par `--du` / `--au` (l'utilisateur).
**Mise en place** *(choix de Claude, calquée sur `/boucle`)* : sur `master`, sans changer de branche (ailleurs, l'orchestrateur le dit et s'arrête), la base de la séance notée au bilan (D-077) ; dossier de séance `aiguiser/<SEANCE>_<STATION>/`, hors de tout dossier de station ; un dossier `lot-01/`, le lot de la séance. L'agent de diagnostic ne lit pas `vues-deplacements/` : il ne verra pas les rendus de la séance.
**Mise en place** *(choix de Claude, calquée sur `/events-learner`)* : sur `master`, sans changer de branche (ailleurs, l'orchestrateur le dit et s'arrête), la base de la séance notée au bilan (D-077) ; dossier de séance `aiguiser/<SEANCE>_<STATION>/`, hors de tout dossier de station ; un dossier `lot-01/`, le lot de la séance. L'agent de diagnostic ne lit pas `vues-deplacements/` : il ne verra pas les rendus de la séance.
**Le lot, dans l'ordre** (accepté) :
1. **Lecteur** : il lit le lot avec le skill, rien d'autre, et écrit `lecture-1.md`. Commit.
@@ -71,15 +71,15 @@ La séance suivante tourne avec le skill tel qu'il est devenu.
**Commandes des fiches, une fois, en fin de séance** : l'orchestrateur lance les commandes que citent les fiches de la base d'events (pas d'agent) ; les échecs vont au bilan. Rien n'est annulé d'office : le bilan le dit et l'utilisateur décide. Il n'y a plus de contrôle de lecture sur les cinq events validés (D-064) : l'utilisateur a validé les diagnostics de ces events, pas les outils qui les lisent.
**Bilan** : `bilan.md`, une ligne pour le lot (verdict du premier écart ; passages gardés, annulés ; verdict du dernier écart), les commandes des fiches en échec, les manques imputés au lecteur (que le skill ne pouvait pas corriger), les nouveautés vues par le correcteur (pour `/boucle` ou `/new-event`), les erreurs. Commit.
**Bilan** : `bilan.md`, une ligne pour le lot (verdict du premier écart ; passages gardés, annulés ; verdict du dernier écart), les commandes des fiches en échec, les manques imputés au lecteur (que le skill ne pouvait pas corriger), les nouveautés vues par le correcteur (pour `/events-learner` ou `/new-event`), les erreurs. Commit.
**Difficultés** : le releveur note celles de la séance (D-060) ; avec `--ameliorer`, l'améliorateur (`.claude/agents/ameliorateur.md`, le même que pour `/boucle`) corrige ensuite le skill `/aiguiser`, ses agents, `voir.py`, cette spec et `run.md` d'après ces relevés, et marque les entrées **traité** ; les outils de lecture et `lire-les-donnees` restent à l'optimiseur (D-076). Commit `Sharpen <STATION>: process fixes`.
**Difficultés** : le releveur note celles de la séance (D-060) ; avec `--ameliorer`, l'améliorateur (`.claude/agents/ameliorateur.md`, le même que pour `/events-learner`) corrige ensuite le skill `/aiguiser`, ses agents, `voir.py`, cette spec et `run.md` d'après ces relevés, et marque les entrées **traité** ; les outils de lecture et `lire-les-donnees` restent à l'optimiseur (D-076). Commit `Sharpen <STATION>: process fixes`.
**Comment les agents communiquent** : comme dans `/boucle` : ils ne se parlent pas ; chacun reçoit un prompt court (dossier, dates du lot, chemins à lire, chemin de son rendu), écrit son rendu et répond en quelques lignes. L'orchestrateur est seul à commiter, par chemin. Modèle et effort de la session qui lance `/aiguiser` (`model: inherit`, sans `effort`, D-063 ; d'abord sur Opus). Sans question à l'utilisateur pendant la séance *(choix de Claude, comme `/boucle`)*.
**Comment les agents communiquent** : comme dans `/events-learner` : ils ne se parlent pas ; chacun reçoit un prompt court (dossier, dates du lot, chemins à lire, chemin de son rendu), écrit son rendu et répond en quelques lignes. L'orchestrateur est seul à commiter, par chemin. Modèle et effort de la session qui lance `/aiguiser` (`model: inherit`, sans `effort`, D-063 ; d'abord sur Opus). Sans question à l'utilisateur pendant la séance *(choix de Claude, comme `/events-learner`)*.
## 6. Les rôles
Chaque rôle est un sous-agent, `.claude/agents/<rôle>.md`, avec `omitClaudeMd: true` ; l'orchestrateur est un skill, comme pour `/boucle` (un sous-agent ne peut pas lancer de sous-agents).
Chaque rôle est un sous-agent, `.claude/agents/<rôle>.md`, avec `omitClaudeMd: true` ; l'orchestrateur est un skill, comme pour `/events-learner` (un sous-agent ne peut pas lancer de sous-agents).
### Orchestrateur : skill `.claude/skills/aiguiser/SKILL.md`
@@ -87,7 +87,7 @@ Lancé par l'utilisateur seulement (`disable-model-invocation: true`). Il dérou
### Lecteur : `.claude/agents/lecteur.md`
Il teste le skill : il lit `lire-les-donnees/SKILL.md` et le suit, rien d'autre. Outils : Read, Bash, Write. Il lit le dossier de station par les outils du skill, les images par Read, et les deux notes de `docs/domaine/` que le skill cite. **Il ne lit pas** : les détecteurs ni leur sortie, la base d'events, la carte des événements, les rendus de la séance (ni le corrigé, ni les écarts, ni les modifications), `CLAUDE.md`, `docs/decisions.md`, `vues-deplacements/` hors du dossier de station, les autres séances de `aiguiser/` et `boucle/`. Il n'écrit aucun script.
Il teste le skill : il lit `lire-les-donnees/SKILL.md` et le suit, rien d'autre. Outils : Read, Bash, Write. Il lit le dossier de station par les outils du skill, les images par Read, et les deux notes de `docs/domaine/` que le skill cite. **Il ne lit pas** : les détecteurs ni leur sortie, la base d'events, la carte des événements, les rendus de la séance (ni le corrigé, ni les écarts, ni les modifications), `CLAUDE.md`, `docs/decisions.md`, `vues-deplacements/` hors du dossier de station, les autres séances de `aiguiser/` et `events-learner/`. Il n'écrit aucun script.
`lecture-K.md` : le tableau des moments (début, fin, capteurs, colonnes, ce que je vois, ce que montrent les images) ; **ce qui m'a manqué** : où il a peiné, ce qu'il aurait voulu pouvoir regarder ; les sources lues. Ses figures dans `lot-NN/lecture-K/`, une lecture par dossier, pour qu'une lecture n'écrase pas les figures d'une autre (même nom de PNG).
@@ -169,5 +169,5 @@ Le texte des consignes de chaque agent ; le format exact des messages de commit
- Deux lectures par passage, pour séparer le gain du hasard : deux lectures du même lot diffèrent d'elles-mêmes.
- Le coût de la lecture (appels d'outils, jetons) comme second critère, à qualité égale.
- De nouveaux champs de données (à terme, la base de la plateforme) : la même séance, sur ces champs (l'utilisateur).
- `/aiguiser` et `/boucle` sur les mêmes lots, l'un après l'autre.
- `/aiguiser` et `/events-learner` sur les mêmes lots, l'un après l'autre.
- Plusieurs correcteurs, ou un correcteur sur un autre modèle, contre les angles morts communs au lecteur et au correcteur.