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:
1 parent
79d83be3ff
commit
3b732adc52
169 files changed
+231
-288
No files matched your search
@@ -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, `boucle/` 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/` ; 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,7 +22,7 @@ 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 : `/boucle <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 `boucle/<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/boucle_<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/boucle/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/boucle-automatique.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`.
|
||||
|
||||
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`.
|
||||
|
||||
|
||||
@@ -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.
|
||||
@@ -1,162 +0,0 @@
|
||||
# La boucle automatique : conception
|
||||
|
||||
Point 31 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** ; plan de construction : `docs/superpowers/plans/2026-10-24-boucle-automatique.md`. Ce qui vient de l'utilisateur est dit « l'utilisateur » ; le reste est un choix de Claude, marqué *(choix de Claude)*.
|
||||
|
||||
## 1. Pourquoi
|
||||
|
||||
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. Puis passer au lot suivant.
|
||||
|
||||
À la fin d'une séance, il reste deux choses durables (l'utilisateur) :
|
||||
1. **de la connaissance** : de nouveaux events, appris sur des événements réels, de la même forme que E-001 à E-005, ajoutés à la même base d'events, `events/` : tous les events sont au même endroit (l'utilisateur) ;
|
||||
2. **des détections optimisées** : des détecteurs mieux réglés.
|
||||
|
||||
L'analyste, le detectors-critic et le detectors-control ne laissent rien de durable eux-mêmes : ce sont les juges qui y mènent.
|
||||
|
||||
## 2. Buts, non-buts, ce qui serait un échec
|
||||
|
||||
**Buts.** Une commande lance une séance sur une station ; elle tourne seule jusqu'au bout ; tout ce qu'elle fait est commité, étape par étape, pour s'y retrouver et revenir en arrière (l'utilisateur).
|
||||
|
||||
**Non-buts.**
|
||||
- Récupérer les données : la boucle prend un dossier de station tel quel, au format de `data/<STATION>/` (export « advanced » dans `displacement/`, images dans `images/`), qu'il vienne du pompage (`extraction/pomper.py`, point 27) ou de CSV et d'images téléchargés à la main.
|
||||
- Les autres domaines (Energy, Storage, Cellular, Temperature) : les déplacements seulement.
|
||||
- **L'agent de diagnostic** (`diagnostic`, D-046) : il n'entre pas en jeu ici, à aucun moment il n'a de travail dans la boucle (l'utilisateur, 2026-10-24). Il sert au diagnostic pour l'utilisateur ; on le traitera dans une autre conversation, y compris ce que les events appris changent pour lui. La boucle ne touche pas à ses consignes ; elle ne fait que compléter la base d'events.
|
||||
- L'exhaustivité : **pas de rejeu** des lots déjà vus par l'analyste, pas de revalidation générale après chaque modification ; on explore des données et on améliore peu à peu (l'utilisateur). Le score (D-062, §5) rejoue les lots d'avant sans regard de Claude, sur leurs étiquettes.
|
||||
- Revalider les events appris : peut-être plus tard, à la main, pas maintenant (l'utilisateur).
|
||||
- Plusieurs analystes en parallèle : plus tard (annexe).
|
||||
|
||||
**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).
|
||||
- Toucher aux events validés E-001 à E-005, ou aux catégories du journal, validées au point 5 du plan *(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)*.
|
||||
|
||||
## 3. Ce qui existe et que la boucle réutilise
|
||||
|
||||
- Les détecteurs du journal : `detectors/*.py`, contrat `detect(mesures)`, classés en événements par `categories.py`. Le tri en lot existe (point 30, validé) : `python3 detectors/categories.py <dossier> --du AAAA-MM-JJ --au AAAA-MM-JJ --tranche 4 --historique 3`. Chaque lot est classé avec les 3 jours d'avant : c'est la règle pour la boucle (D-056).
|
||||
- Les outils de lecture des données, `agent-tools/` : `inventaire.py`, `resume.py`, `graphique.py` (PNG des séries), `vignettes.py` (gros plans des cibles sur les images) ; leur mode d'emploi est le skill `.claude/skills/lire-les-donnees/`, que suit l'analyste ; ils évoluent par `/aiguiser` (D-059, `aiguiser-la-lecture.md`), pas par la boucle. Seuls les outils servent : l'agent de diagnostic, lui, n'est pas appelé.
|
||||
- La carte des événements, `events/carte-des-evenements.md` : ce qui peut arriver, en familles, et les catégories du journal (section 4).
|
||||
- La base d'events, `events/` : l'index `INDEX.md`, le modèle de fiche (§11.3 de `docs/agents/agent-diagnostic.md`), le skill `anonymize-event` (données copiées dans le dossier de l'event, noms codés, D-049, D-050). Les events existants ne se modifient jamais ; la boucle en ajoute.
|
||||
- Le registre des seuils, `vues-deplacements/contexte/seuils-du-journal.md` : une constante changée le met à jour dans le même changement.
|
||||
|
||||
## 4. Une séance
|
||||
|
||||
**Lancement** : `/boucle data/<STATION> [--du AAAA-MM-JJ] [--au AAAA-MM-JJ] [--ameliorer]`, par l'utilisateur seul ; un nom de station seul désigne `data/<STATION>/` (D-065) ; `--au` est exclu (la plage s'arrête à `--au` 00:00Z). Sans dates, toute la période du dossier ; une date qui déborde cette période y est ramenée, et dite sous « Erreurs » du bilan. **L'utilisateur pilote les lots** (2026-10-24) : avec les données en masse, on ne traitera pas tout ; les lots se traitent indépendamment, il choisit lesquels (`--du` / `--au` sur la plage d'un lot pour un seul) ; la manière de les choisir reste à voir. **La plage est le lot** (D-072, 2026-10-26) : une séance traite un seul lot, sans découpe ; l'utilisateur en choisit la longueur par ses dates (d'abord des lots de 4 jours par défaut, `--lot`, retirés).
|
||||
|
||||
**Mise en place** *(choix de Claude)*. L'orchestrateur commite directement sur `master` (D-070 ; d'abord une branche par séance, abandonnée le 2026-10-26) et crée le dossier de la séance `boucle/<AAAA-MM-JJTHHMMZ>_<STATION>/` (deux séances le même jour ne se mêlent pas), hors de tout dossier de station (règle de `vues-deplacements/CLAUDE.md`). La plage est un seul lot, `lot-01/`, sa commande `categories.py <dossier> [--du …] [--au …]`, sans `--tranche`.
|
||||
|
||||
**Pour chaque lot, dans l'ordre** (dossier `lot-NN/` dans celui de la séance) :
|
||||
1. **Analyste** : il écrit `analyse.md` et ses étiquettes. Commit.
|
||||
2. **Detectors-critic** : il compare les détecteurs à l'analyse et écrit `critique.md`. Commit. Verdict « d'accord » : on passe à l'étape 5.
|
||||
3. **Detectors-upgrader** : il adapte les détecteurs et écrit `modification-K.md` (K : numéro du passage). Commit.
|
||||
4. **Detectors-control** : il juge la modification sur la base d'events, sans regarder le lot, et écrit `validation-K.md`, « accepté » ou « à reprendre ». Commit. « À reprendre » : retour à l'étape 3, le detectors-upgrader lit ce contrôle. Au plus trois passages du detectors-upgrader *(choix de Claude)* : au troisième contrôle, le detectors-control n'a plus que deux réponses, « garder » (ça va dans le bon sens) ou « annuler » (l'orchestrateur annule par `git revert` les commits de détecteurs du lot).
|
||||
5. **Event-builder** : à chaque lot, il décide, face à la base d'events, ce que l'analyse lui apprend de nouveau ; il en fait des events, `events/`, et écrit `builder.md`. Un commit pour les events du lot (ils partagent la ligne d'index).
|
||||
|
||||
Le lot suivant tourne avec les détecteurs tels qu'ils sont devenus. À la fin, l'orchestrateur écrit `bilan.md` (§6) et le commite.
|
||||
|
||||
**Comment les agents communiquent** *(choix de Claude, accepté le 2026-10-24)*. Ils ne se parlent pas. Chacun reçoit de l'orchestrateur un prompt court : le dossier de station, les dates du lot, les chemins des fichiers à lire. Il écrit son rendu dans le dossier du lot et répond en quelques lignes (verdict, chemins). L'orchestrateur est le seul à commiter ; il commite par chemin, pour ne rien emporter d'autre (message `Loop <STATION> lot NN: <rôle> …`), et vérifie avant chaque commit que la branche est encore `master` (une autre session a pu en changer : il ne commite plus et le dit au bilan) ; un fichier qu'une autre session a déjà modifié sur les chemins de la séance (détecteurs, seuils, base d'events, registre) n'est ni commité ni annulé, et va au bilan sous « Erreurs ». Les agents prennent le modèle et l'effort de la session qui lance `/boucle` (`model: inherit`, sans `effort`, l'utilisateur, 2026-10-26, D-063 ; d'abord sur Opus).
|
||||
|
||||
**Sans question** : la séance tourne seule jusqu'au bout. Si un agent ne rend pas son fichier, l'orchestrateur le note dans le bilan et passe au lot suivant *(choix de Claude)*.
|
||||
|
||||
## 5. Les rôles
|
||||
|
||||
Chaque rôle est un sous-agent de Claude Code, défini dans `.claude/agents/<rôle>.md` (ses consignes y sont), comme l'agent `diagnostic`. L'orchestrateur est un skill, lancé dans la conversation principale : un sous-agent ne peut pas lancer d'autres sous-agents.
|
||||
|
||||
### Orchestrateur : skill `.claude/skills/boucle/SKILL.md`
|
||||
|
||||
Lancé par l'utilisateur seulement (comme `/new-event`). Il déroule le §4 et ne juge rien lui-même.
|
||||
|
||||
### Analyste : `.claude/agents/analyste.md`, avec le skill `analyser-lot`
|
||||
|
||||
Une seule responsabilité depuis le 2026-10-29 (l'utilisateur, D-090) : l'analyse la plus précise du lot ; la critique des détecteurs est au `detectors-critic`. On peut aussi lancer le skill à la main sur un lot, hors de la boucle, et `/new-event` s'en sert pour les étiquettes d'un event. Outils : Read, Bash, Write. Il ne modifie rien.
|
||||
|
||||
1. **Sa lecture**, avec tous les outils à sa disposition : outils de lecture (`lire-les-donnees`), images, la carte, la base d'events quand il veut (D-088) et la sortie des détecteurs quand il veut (D-090) ; un event connu ou un événement des détecteurs est une piste à vérifier sur les données, pas une conclusion. Il note chaque moment : début, fin, capteurs, ce qu'il voit, la catégorie de la carte qui conviendrait, ou « aucune catégorie ».
|
||||
2. **Ses étiquettes**, une par moment.
|
||||
3. **Events connus** : les events de la base proches de ses moments.
|
||||
|
||||
`analyse.md` reprend ces parties (avant D-091, aussi les nouveautés, pour le builder) ; ses figures sont dans le dossier du lot. Avant D-090, l'analyste lisait sans les détecteurs, puis les comparait lui-même et rendait la critique : `critique.md` des séances d'avant porte les deux.
|
||||
|
||||
### Detectors-critic : `.claude/agents/detectors-critic.md`
|
||||
|
||||
Il juge les détecteurs face à l'analyse, la vérité (l'utilisateur, 2026-10-29, D-090). Outils : Read, Bash, Write. **Il ne regarde pas les données** : il dit quoi et où ; le pourquoi d'un défaut, dans les données, revient au detectors-upgrader.
|
||||
|
||||
- Il lit l'analyse, ses étiquettes et ses figures, la sortie de `categories.py` pour le lot, le score, le code des détecteurs et la section 4 de la carte.
|
||||
- **Comparaison**, événement par événement : juste ; catégorie fausse ; en trop ; bornes fausses (en retard, trop large) ; manquant. L'alignement n'a pas à être parfait.
|
||||
- **Verdict** : « d'accord » (rien d'important à corriger), ou des **suggestions, au plus deux**, les plus importantes *(choix de Claude, contre la complexité)* : le défaut, l'exemple (moment, capteurs), le détecteur en cause et sa règle, ce qu'il faudrait, en mots et non en code.
|
||||
- `critique.md` : verdict, l'analyse lue, la sortie des détecteurs, la comparaison (partie 3), le score, les suggestions (partie 5) ; le detectors-upgrader lit les parties 3 et 5.
|
||||
|
||||
**Étiquettes** (D-061, ajoutées le 2026-10-25) : juste après sa lecture, l'analyste écrit aussi `etiquettes.json`, une entrée par moment de sa lecture (début, fin, capteurs, catégorie du journal, événement de la carte s'il est établi, preuve vue ou déduite), contrôlée par `.claude/skills/analyser-lot/etiquettes.py` ; le format est dans `analyser-lot`. Elles ne dépendent pas des modifications des détecteurs : ce sont les labels d'un futur modèle appris (point 44 du plan), à garder même si une modification est annulée. Toutes les étiquettes : `boucle/*/lot-*/etiquettes.json`.
|
||||
|
||||
**Score** (D-062, point 45 du plan, ajouté le 2026-10-25) : le but de la boucle est la précision de la détection sur tout le lot (l'utilisateur). `python3 .claude/skills/boucle/score.py <dossier>` compare, mesure par mesure et capteur par capteur, les événements des détecteurs aux étiquettes de **tous** les lots de la station : par catégorie et pour deux niveaux de validité (« à ignorer » : les zones grisées ; « prudence » : visibilité réduite et turbulence), « trouvées » (part des mesures étiquetées que les détecteurs signalent) et « justes » (part des mesures signalées que l'analyste a étiquetées). L'orchestrateur l'écrit au début de chaque lot (`score-avant.txt`) et en fin de séance (`score-fin.txt`) ; le detectors-upgrader le relance après une modification, comme un contrôle et non un but (D-089) : la catégorie en cause s'améliore sur ce lot, sans baisse nette ailleurs (une autre ligne de ce lot, les lots d'avant) ; un trou n'a pas de case (pas de mesure) : pour lui, la commande du lot dit le bon sens. Le score est un fait, pas un verdict : l'analyste peut se tromper aussi. Choix de Claude, laissé par l'utilisateur, à revoir après la première séance : trois niveaux plutôt que deux, un compte par mesure plutôt que par événement, par capteur plutôt que pour toute la station. Le script est hors de `detectors/` : le detectors-upgrader ne peut pas le modifier.
|
||||
|
||||
**Benchmark** (D-069, point 48 du plan, ajouté le 2026-10-26 à la demande de l'utilisateur) : chaque event de la base garde son diagnostic à la création, `etiquettes.json` au format des étiquettes de l'analyste, noms codés, figé ; `.claude/skills/boucle/benchmark.py` lance les détecteurs sur chaque event et les compare à ces étiquettes, comme le score (« trouvées », « justes », par catégorie, par cas et au total). Purement analytique, sans agent. L'orchestrateur le lance au début de chaque lot (`benchmark-avant.txt`), après chaque modification (`benchmark-K.txt`) et en fin de séance (`benchmark-fin.txt`), et l'ajoute à l'historique `vues-deplacements/benchmark/historique.csv`, avec la version des détecteurs (commit) ; le detectors-upgrader le relance et le detectors-control juge sur lui seul (D-089) : un event moins bien trouvé ou moins bien borné est un recul, une hausse un plus, pas un but (sur une dizaine d'events, les détecteurs se régleraient sur eux, choix de l'utilisateur). L'event-builder donne ses étiquettes à chaque event créé (`anonymiser.py --etiquettes`) ; E-001 à E-005 ont reçu les leurs d'un passage unique de l'analyste, corrigé par leur fiche (leur `etiquetage.md`). Limite : un event appris ne contient que l'événement ± 6 h, sans les 3 jours d'historique d'un lot.
|
||||
|
||||
### Detectors-upgrader : `.claude/agents/detectors-upgrader.md`
|
||||
|
||||
Il rend les détecteurs meilleurs sur le lot, d'après la critique de l'analyste, la vérité, qui met déjà l'accent sur ce qui est significatif (et d'après le dernier contrôle, s'il y en a un). Outils : Read, Edit, Write, Bash. Renommé et redéfini le 2026-10-29 (l'utilisateur, D-089).
|
||||
|
||||
- Il vise les événements significatifs du lot que les détecteurs ont manqués, ou mal bornés dans le temps ; pas une sortie identique à la lecture de l'analyste : l'alignement n'a pas à être parfait.
|
||||
- Il ne touche qu'à `detectors/*.py` et au registre des seuils ; sur eux, tout lui est possible : ajouter, retirer ou modifier une constante, une règle, un détecteur.
|
||||
- **Le plus simple d'abord** *(choix de Claude, contre la complexité)* : retirer ou simplifier ; sinon changer une constante ; sinon ajuster une règle existante ; sinon une règle nouvelle et courte ; un nouveau détecteur (contrat `detect(mesures)`) en dernier recours.
|
||||
- **Interdits** : pas de nouvelle catégorie (une suggestion qui en demande une va au bilan) ; chaque catégorie garde au moins un détecteur (D-074) ; pas de règle propre à une station, à un capteur ou à une date ; contrat et clés des épisodes inchangés ; bibliothèque standard seulement.
|
||||
- **Tout détecter** (l'utilisateur, 2026-10-26, D-068) : ce qu'on montre au client n'est pas la question ici. Un réglage pris pour l'affichage (points 13 et 41 du plan, `MISSING`) peut être changé.
|
||||
- Il met à jour le registre des seuils et la docstring du détecteur dans le même changement.
|
||||
- Il vérifie seul le lot, puisque le contrôle ne le regarde pas : `categories.py` avant et après, puis le score ; puis le benchmark, sur lequel il sera jugé : un event de la base qui recule se reprend avant de rendre.
|
||||
- `modification-K.md` : ce qui a changé et pourquoi (les deux parties que lit le contrôle, sans données du lot), les événements du lot avant et après, ce qu'il n'a pas pu corriger.
|
||||
|
||||
### Detectors-control : `.claude/agents/detectors-control.md`
|
||||
|
||||
Le garde-fou contre le sur-apprentissage (l'utilisateur, 2026-10-29, D-089) : des détecteurs collés au lot courant, qui perdent en précision sur les events de la base. C'est lui qui décide au final. Outils : Read, Bash, Write ; il ne modifie pas le code.
|
||||
|
||||
- **Il ne regarde pas le lot** : ni ses données, ni la critique, ni le score ; de la modification, seulement « Ce qui a changé » et « Pourquoi ». Il lit le diff des détecteurs depuis le début du lot et les benchmarks avant et après ; pour comprendre un recul, la fiche et les étiquettes de l'event, et les détecteurs sur ses données.
|
||||
- **Ses questions** : les détecteurs se chargent-ils ? La base recule-t-elle (un event moins bien trouvé ou moins bien borné, même si le total monte ; la ligne `a_verifier` de E-004) ? Le code reste-t-il simple ? Les interdits sont-ils respectés ?
|
||||
- Il ne renvoie pas pour la perfection ; il renvoie pour un recul de la base, une complexité hors de proportion, un interdit ou un détecteur sauté. Au plus trois remarques, en termes de détecteurs et de base.
|
||||
- `validation-K.md` : « accepté » ou « à reprendre » avec ses remarques ; au troisième passage, « garder » ou « annuler ».
|
||||
- Avant le 2026-10-29, le validateur jugeait aussi le lot (critique, score) et ne renvoyait que pour « un défaut net » ; il n'a jamais renvoyé une modification, et des mesures signalées à tort sur la base passaient (WILDSTRUBEL, point 52 du plan).
|
||||
|
||||
### Event-builder : `.claude/agents/event-builder.md`
|
||||
|
||||
Il construit la base de connaissances (l'utilisateur). Outils : Read, Bash, Write, Edit. Renommé et redéfini le 2026-10-29 (l'utilisateur, D-091) : appelé à chaque lot, il lit toute l'analyse et décide seul ce qui est nouveau ; avant, il ne traitait que les nouveautés que l'analyste (ou l'upgrader) avait signalées, et l'orchestrateur ne l'appelait que s'il y en avait.
|
||||
|
||||
- **Une seule base** (l'utilisateur) : `events/`, à côté de E-001 à E-005 ; numéro suivant de l'index, comme `/new-event`.
|
||||
- **Ce qui est nouveau, à son jugement** (l'utilisateur) : il consulte la base (`read-event`) et décide, moment par moment, s'il faut un nouvel event. Ce que la base connaît se juge sur ses events, avec leurs données : un événement que la carte décrit sans event (« hypothétique ») n'est pas connu, son premier exemple réel peut devenir un event. Un moment qui contredit le diagnostic d'un event est noté pour l'utilisateur, sans event.
|
||||
- **Bornes de l'événement, pas du lot** (l'utilisateur) : un lot peut couvrir des jours ; l'event ne garde que le moment où l'événement se produit, vérifié sur les données, plus 6 h de part et d'autre (un état qui couvre le lot : un moment qui le montre, ± 6 h, la plage entière dite dans la fiche). Données, étiquettes, figures et commandes de la signature s'y bornent.
|
||||
- Sinon, un event de la même forme que E-001 à E-005 : données copiées et codées par `anonymize-event` ; fiche du §11.3, un fait hors des listes fermées rangé sous la plus proche, précisé ; ligne d'index.
|
||||
- **Marqué « appris »** *(choix de Claude)*, pour la revalidation par `/review-event` : en tête de fiche, « Appris par la boucle le <date>, séance <horodatage>, non revalidé par l'expert » ; dans l'index, le Verdict commence par « (appris) ».
|
||||
- Il ne touche jamais aux events existants ni à la carte (elle apprend à la validation, D-087). Il ne passe pas par `/new-event` (ni passage à l'aveugle, ni validation) : les events appris s'ajoutent sans attendre (l'utilisateur : « ça ne peut pas vraiment faire de mal »).
|
||||
|
||||
### Releveur : `.claude/agents/releveur.md` (D-060)
|
||||
|
||||
Ajouté le 2026-10-24, commun à tous les processus automatiques. Chaque rendu finit par `## Difficultés` (consigne floue, contradictoire ou absente, chemin, format, commande ; « aucune » sinon). En fin de séance, l'orchestrateur l'appelle une fois, avec ses propres difficultés ; il retrouve la consigne ou le fichier en cause, regroupe les occurrences d'une même cause et note tout dans `docs/ameliorations-processus.md`. Il ne corrige rien : l'utilisateur s'en sert ensuite, dans une autre conversation.
|
||||
|
||||
### Améliorateur : `.claude/agents/ameliorateur.md` (D-071)
|
||||
|
||||
Ajouté le 2026-10-26 à la demande de l'utilisateur, seulement si `/boucle` est lancé avec `--ameliorer`. Après le commit du releveur, il lit les entrées que celui-ci a créées ou complétées pendant la séance et corrige, au plus simple, le skill `/boucle`, `analyser-lot`, les agents de la boucle, cette spec et `run.md` ; il marque les entrées corrigées **traité**. Il laisse ce qui sort de ces fichiers (outils de lecture, détecteurs, cas) et ce qui changerait ce que fait la boucle plutôt que la façon de le dire, ou reviendrait sur une décision ; l'orchestrateur commite ses fichiers (`Loop <STATION>: process fixes`).
|
||||
|
||||
## 6. Ce que l'utilisateur trouve à la fin
|
||||
|
||||
- Les commits de la séance sur `master`, un par étape, lisibles avec `git log` depuis la base de la séance (notée dans `bilan.md`) ; il annule ce qu'il ne garde pas par `git revert`.
|
||||
- `bilan.md` : une ligne par lot (verdict de la critique ; étiquettes ; modification gardée, annulée ou aucune ; events créés), et le score de fin de séance (`score-fin.txt`) sur toutes les étiquettes de la station ; les suggestions non traitées (nouvelle catégorie, au-delà de deux) ; les contradictions avec la base relevées par l'event-builder ; les erreurs.
|
||||
- `docs/ameliorations-processus.md` : les difficultés du processus relevées pendant la séance ; avec `--ameliorer`, celles que l'améliorateur a corrigées sont marquées **traité**.
|
||||
- La page `out/boucle_<séance>.html` (D-066, ajoutée le 2026-10-26 à la demande de l'utilisateur), ouverte en fin de séance : les courbes de toute la plage ; dessous, une ligne par catégorie, la lecture de l'analyste au-dessus des événements des détecteurs ; tout en bas, la ligne « Error rate » (`error_value` moyenne de tous les capteurs, du vert au rouge, avec sa barre de couleur, ajoutée le 2026-10-27 à la demande de l'utilisateur) ; le score de la séance. Le but, séance après séance : que les deux coïncident.
|
||||
|
||||
## 7. Essai et première séance
|
||||
|
||||
**Essai du 2026-10-24** (tâche 1 du plan) : l'analyste seul sur le lot 1 de NORDEND d'octobre (05/10 → 09/10) : verdict « suggestions » (deux : une référence rejetée qui fausse la compensation de toutes les cibles, fondue dans un épisode au lieu d'être grisée ; un nombre de capteurs faux dans la phrase de la buée), une nouveauté (halo sur la vitre sous PR17 au saut du 08/10 02:30, cause non établie), la buée du 07/10 au 08/10 retrouvée ; 53 appels d'outils, ~250 000 jetons, 8 min 30 (Opus, effort élevé ; les images pèsent le plus). **Fonctionnement validé par l'utilisateur le 2026-10-24.**
|
||||
|
||||
**Première séance** : par l'utilisateur seul, plus tard, sur de nouvelles données, lot par lot, quand les autres développements seront faits. Claude ne la lance pas. Pour un essai sur des données déjà là, NORDEND d'octobre (`vues-deplacements/cas/2026-10_NORDEND/NORDEND/`, 11 jours, 3 lots de 4 jours) a une vérité connue.
|
||||
|
||||
## 8. Laissé au constructeur
|
||||
|
||||
Le texte des consignes de chaque agent ; le format exact des messages de commit ; la découpe des lots (en lisant l'en-tête de `categories.py` ou en la calculant) ; les colonnes des courbes de l'analyste ; la marge autour d'un événement pour les données d'un event (proposition : 6 h ; seulement la fenêtre, pas tout le lot, pour ne pas commiter des centaines d'images par cas) ; une option de fenêtre dans `anonymiser.py` si elle manque (vérifiée par son `--test`) ; le mode de permission qui laisse une séance tourner sans demander d'accord.
|
||||
|
||||
À faire avec la construction : une entrée D-057 dans `docs/decisions.md` (la boucle ; la base d'events s'enrichit aussi par le builder, sans `/new-event`, ce qui complète D-048 ; l'agent de diagnostic hors de la boucle), une ligne dans `CLAUDE.md` et dans `vues-deplacements/CLAUDE.md`.
|
||||
|
||||
## Annexe : pistes à revoir
|
||||
|
||||
- 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.
|
||||
- La revalidation des events appris par l'utilisateur.
|
||||
- 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.
|
||||
- La durée : ~8 min 30 par lot pour l'analyste seul. Leviers : son effort (`high` → `medium`, il réfléchit moins à chaque appel, change peu ce qu'il voit) ; moins de vignettes (toutes les 4 à 6 h, plus serrées là où ça bouge ; risque de rater un événement court).
|
||||
- Le choix des lots parmi beaucoup de données (l'utilisateur : « on verra comment on fait »).
|
||||
- Le pompage en masse (points 27 à 29).
|
||||
@@ -0,0 +1,75 @@
|
||||
# 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)*.
|
||||
|
||||
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.
|
||||
|
||||
## 1. Pourquoi
|
||||
|
||||
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) :
|
||||
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. Buts, non-buts, ce qui serait un échec
|
||||
|
||||
**Buts.** Une commande lance une séance sur une station ; elle tourne seule jusqu'au bout ; tout ce qu'elle fait est commité, étape par étape, pour s'y retrouver et revenir en arrière (l'utilisateur).
|
||||
|
||||
**Non-buts.**
|
||||
- Récupérer les données : la séance prend un dossier de station tel quel, au format de `data/<STATION>/`, qu'il vienne du pompage (`extraction/pomper.py`) ou de fichiers téléchargés à la main.
|
||||
- Les autres domaines (Energy, Storage, Cellular, Temperature) : les déplacements seulement.
|
||||
- **L'agent de diagnostic** (D-046) : il n'a de travail à aucun moment de la séance (l'utilisateur, 2026-10-24) ; elle ne touche pas à ses consignes et ne fait que compléter la base d'events.
|
||||
- L'exhaustivité : **pas de rejeu** des lots déjà vus, pas de revalidation générale après chaque modification ; on explore et on améliore peu à peu (l'utilisateur). Le score rejoue les lots d'avant sur leurs étiquettes, sans regard de Claude.
|
||||
- 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).
|
||||
- **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)*.
|
||||
|
||||
## 3. Les principes
|
||||
|
||||
- **Un agent, une responsabilité** (l'utilisateur, 2026-10-29, D-090) :
|
||||
|
||||
| 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 |
|
||||
| `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 |
|
||||
| `event-builder` | décider ce que le lot apprend de nouveau à la base d'events, et en faire des events bornés à l'événement | — | D-091 |
|
||||
|
||||
Le releveur et l'améliorateur (D-060, D-071) sont communs à tous les processus automatiques, pas propres à celui-ci.
|
||||
- **L'orchestrateur ne juge rien** : il lit les lignes de verdict, transmet les chemins et commite *(choix de Claude)*. C'est un skill, lancé dans la conversation principale, parce qu'un sous-agent ne peut pas lancer d'autres sous-agents.
|
||||
- **Les agents ne se parlent pas** *(choix de Claude, accepté le 2026-10-24)* : chacun reçoit un prompt court (dossier, dates, chemins à lire), écrit son rendu dans le dossier de la séance et répond en quelques lignes.
|
||||
- **Tout est commité sur `master`, par chemin**, une étape par commit (l'utilisateur ; D-070) ; l'utilisateur annule ce qu'il ne garde pas par `git revert`.
|
||||
- **Sans question** : la séance tourne seule ; un rendu absent va au bilan *(choix de Claude)*.
|
||||
- **L'utilisateur pilote les lots** (2026-10-24) : avec les données en masse, on ne traitera pas tout ; **la plage est le lot** (D-072), une séance par plage choisie.
|
||||
- **Les agents prennent le modèle et l'effort de la session** (`model: inherit`, D-063).
|
||||
|
||||
## 4. Les mesures
|
||||
|
||||
- **Le score** (D-062) : les détecteurs face aux étiquettes de l'analyste, mesure par mesure, sur ce lot et les lots d'avant de la station. Un contrôle pour le `detectors-upgrader`, pas un but (D-089) : l'alignement n'a pas à être parfait. Choix de Claude, laissés par l'utilisateur : un compte par mesure plutôt que par événement, par capteur, trois niveaux de validité.
|
||||
- **Le benchmark** (D-069) : les détecteurs face au diagnostic gardé dans chaque event de la base, ses cas de régression ; c'est sur lui seul que juge le `detectors-control`. Une hausse est un plus, pas un but : sur une dizaine d'events, les détecteurs se régleraient sur eux (l'utilisateur). Le benchmark de fin des détecteurs est celui de la dernière modification gardée, sur les mêmes events que celui du début ; les events créés pendant la séance se mesurent à la suivante (D-092). Limite : un event appris ne contient que l'événement ± 6 h, sans les 3 jours d'historique d'un lot.
|
||||
- **Les étiquettes** de l'analyste (D-061) ne dépendent pas des modifications des détecteurs : ce sont aussi les labels d'un futur modèle appris (point 44 du plan), à garder même si une modification est annulée.
|
||||
|
||||
## 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`.
|
||||
|
||||
## 6. Essai et séances
|
||||
|
||||
**Essai du 2026-10-24** : l'analyste seul sur le lot 1 de NORDEND d'octobre (05/10 → 09/10) : verdict « suggestions » (deux : une référence rejetée qui fausse la compensation de toutes les cibles, fondue dans un épisode au lieu d'être grisée ; un nombre de capteurs faux dans la phrase de la buée), une nouveauté (halo sur la vitre sous PR17 au saut du 08/10 02:30, cause non établie), la buée du 07/10 au 08/10 retrouvée ; 53 appels d'outils, ~250 000 jetons, 8 min 30 (Opus, effort élevé ; les images pèsent le plus). **Fonctionnement validé par l'utilisateur le 2026-10-24.**
|
||||
|
||||
**Séances** : lancées par l'utilisateur seul ; six du 2026-10-26 au 2026-10-27, dans `events-learner/`, avec les rôles d'avant le 2026-10-29. Les rôles revus (points 51 à 54 du plan) attendent leur première séance.
|
||||
|
||||
## Annexe : pistes à revoir
|
||||
|
||||
- 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.
|
||||
- La durée : ~8 min 30 par lot pour l'analyste seul. Leviers : son effort, moins de vignettes (risque de rater un événement court).
|
||||
- Le choix des lots parmi beaucoup de données (l'utilisateur : « on verra comment on fait ») ; le pompage en masse (points 27 à 29 du plan).
|
||||
- Le lot unique numéroté `lot-01` (vestige du découpage en lots, D-072) : le retirer toucherait trois scripts et la lecture des séances passées.
|
||||
Reference in new issue
Block a user