Loop: the analyst analyses, a new detectors-critic critiques (D-090)
- analyste: the most precise analysis of the batch, detectors allowed as a tool; reading, labels, known events, novelties in analyse.md; skill critiquer-lot renamed analyser-lot. - detectors-critic: compares the detectors to the analysis event by event, without looking at the data; verdict and at most two suggestions in critique.md, read by the detectors-upgrader. - /boucle step 2, builder, review page, /new-event and score.py import follow. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
21f8cd1db6
commit
c763cda5c3
24 files changed
+204
-86
No files matched your search
@@ -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 juger les détecteurs du journal, lot après lot, par un analyste, les fait corriger par un detectors-upgrader, contrôlé sur la base d'events par un detectors-control (D-089), et ajoute les nouveautés à la base d'events par un builder ; 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 : `/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 ajoute les nouveautés à la base d'events par un builder ; 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`.
|
||||
|
||||
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`.
|
||||
|
||||
|
||||
@@ -32,7 +32,7 @@ On veut donc un autre processus automatique, à part de `/boucle`, qui ne travai
|
||||
## 3. Ce qui existe
|
||||
|
||||
- **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/critiquer-lot/SKILL.md` (l'analyste), le §3 et une partie du §4 (étapes 1, 2 et 4) de `agent-diagnostic/instructions.md` (l'agent de diagnostic).
|
||||
- **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).
|
||||
|
||||
@@ -46,7 +46,7 @@ Un skill, `.claude/skills/lire-les-donnees/SKILL.md`, devient la seule source du
|
||||
|
||||
Il ne contient ni catégorie, ni event, ni hypothèse, ni verdict : c'est l'affaire de celui qui l'appelle.
|
||||
|
||||
**Ceux qui l'utilisent** : l'analyste (« Tes outils » et l'étape 1 de `critiquer-lot` renvoient au skill ; l'étape 1 garde la catégorie de la carte, ajoutée après la lecture), l'agent de diagnostic (le §3 de ses instructions renvoie au skill et garde la ligne `categories.py` et la remarque sur `--sortie` ; ses étapes de diagnostic ne changent pas) et le lecteur (§6). Les sous-agents le lisent par Read, comme l'analyste lit `critiquer-lot` *(choix de Claude)*.
|
||||
**Ceux qui l'utilisent** : l'analyste (« Tes outils » et l'étape 1 d'`analyser-lot` renvoient au skill ; l'étape 1 garde la catégorie de la carte, ajoutée après la lecture), l'agent de diagnostic (le §3 de ses instructions renvoie au skill et garde la ligne `categories.py` et la remarque sur `--sortie` ; ses étapes de diagnostic ne changent pas) et le lecteur (§6). Les sous-agents le lisent par Read, comme l'analyste lit `critiquer-lot` *(choix de Claude)*.
|
||||
|
||||
**L'optimiseur touche à deux choses, et seulement à elles** : les scripts de `agent-tools/` (y compris un nouveau script) et `lire-les-donnees/SKILL.md`.
|
||||
|
||||
|
||||
@@ -10,7 +10,7 @@ L'utilisateur veut que Claude apprenne sur des lots entiers de données de stati
|
||||
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 et le detectors-control ne laissent rien de durable eux-mêmes : ce sont les juges qui y mènent.
|
||||
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
|
||||
|
||||
@@ -44,8 +44,8 @@ L'analyste et le detectors-control ne laissent rien de durable eux-mêmes : ce 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 `critique.md`. Commit.
|
||||
2. Verdict « d'accord » : on passe à l'étape 5.
|
||||
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. **Builder** : s'il y a des nouveautés dans les rendus du lot, il ajoute les events à la base, `events/`, et écrit `builder.md`. Un commit pour les events du lot (ils partagent la ligne d'index).
|
||||
@@ -64,20 +64,27 @@ Chaque rôle est un sous-agent de Claude Code, défini dans `.claude/agents/<rô
|
||||
|
||||
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 `critiquer-lot`
|
||||
### Analyste : `.claude/agents/analyste.md`, avec le skill `analyser-lot`
|
||||
|
||||
La critique est un skill à part, à la demande de l'utilisateur ; on peut aussi la lancer à la main sur un lot, hors de la boucle. Outils : Read, Bash, Write. Il ne modifie rien.
|
||||
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 propre lecture d'abord, sans la sortie des détecteurs** *(choix de Claude)* : sinon il ne trouverait jamais ce que les détecteurs ratent. Inventaire, courbes du lot avec `graphique.py`, vignettes espacées (une toutes les 2 à 3 h) et plus serrées là où les courbes bougent, images entières pour la scène. 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. **Puis** la sortie de `categories.py` pour le lot.
|
||||
3. **Comparaison**, événement par événement : juste ; catégorie fausse ; en trop ; bornes fausses (en retard, trop large) ; manquant.
|
||||
4. **Puis les events**, après les faits (sinon il chercherait ce que dit un event au lieu de ce que montrent les données) : l'index `events/INDEX.md`, avec les events appris aux lots et aux séances d'avant.
|
||||
5. **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, ce qu'il faudrait, en mots et non en code.
|
||||
6. **Nouveautés** pour le builder : ce que ni la carte ni l'index ne décrivent, avec le moment, les capteurs et la figure qui le montre.
|
||||
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.
|
||||
4. **Nouveautés** pour le builder : ce que ni la carte ni l'index ne décrivent, avec le moment, les capteurs et la figure qui le montre.
|
||||
|
||||
`critique.md` reprend ces six parties ; ses figures sont dans le dossier du lot.
|
||||
`analyse.md` reprend ces parties ; 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.
|
||||
|
||||
**Étiquettes** (D-061, ajoutées le 2026-10-25) : juste après sa lecture, avant la sortie des détecteurs, 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/critiquer-lot/etiquettes.py` ; le format est dans `critiquer-lot`. Elles ne dépendent pas 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`.
|
||||
### 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.
|
||||
|
||||
@@ -122,7 +129,7 @@ Ajouté le 2026-10-24, commun à tous les processus automatiques. Chaque rendu f
|
||||
|
||||
### 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`, `critiquer-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`).
|
||||
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
|
||||
|
||||
|
||||
Reference in new issue
Block a user