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
@@ -16,14 +16,14 @@ Le processus (`/boucle` ou `/aiguiser`) et le commit du releveur : `git show <co
|
||||
1. Lis ces entrées, puis la consigne ou le fichier que chacune cite (`fichier:ligne`).
|
||||
2. Pour chaque entrée, la correction la plus simple qui lève la difficulté : une phrase précisée, une contradiction tranchée dans le sens du skill, une commande ou un chemin rectifié. La piste de l'entrée, s'il y en a une, est un point de départ, pas un ordre.
|
||||
3. Une consigne citée ailleurs (le skill et la spec, un agent et le skill) : corrige les deux, pour qu'ils disent la même chose.
|
||||
4. Un script modifié (`.claude/skills/boucle/*.py`, `.claude/skills/critiquer-lot/*.py`, `aiguiser/voir.py`) : relance une fois la commande en cause et vérifie qu'elle passe.
|
||||
4. Un script modifié (`.claude/skills/boucle/*.py`, `.claude/skills/analyser-lot/*.py`, `aiguiser/voir.py`) : relance une fois la commande en cause et vérifie qu'elle passe.
|
||||
5. Marque l'entrée corrigée **traité** (`AAAA-MM-JJ : ce qui a changé, où`), au format du carnet.
|
||||
|
||||
## Ce que tu peux modifier
|
||||
|
||||
Ceux du processus de ta demande, et, pour les mentions **traité**, `docs/ameliorations-processus.md`. Rien d'autre.
|
||||
|
||||
- `/boucle` : `.claude/skills/boucle/`, `.claude/skills/critiquer-lot/`, les agents de la boucle (`.claude/agents/analyste.md`, `detectors-upgrader.md`, `detectors-control.md`, `builder.md`, `releveur.md`, `ameliorateur.md`), la spec `vues-deplacements/contexte/boucle-automatique.md`, `run.md` (section `/boucle`).
|
||||
- `/boucle` : `.claude/skills/boucle/`, `.claude/skills/analyser-lot/`, les agents de la boucle (`.claude/agents/analyste.md`, `detectors-critic.md`, `detectors-upgrader.md`, `detectors-control.md`, `builder.md`, `releveur.md`, `ameliorateur.md`), la spec `vues-deplacements/contexte/boucle-automatique.md`, `run.md` (section `/boucle`).
|
||||
- `/aiguiser` : `.claude/skills/aiguiser/`, ses agents (`.claude/agents/lecteur.md`, `correcteur.md`, `optimiseur.md`, `releveur.md`, `ameliorateur.md`), `aiguiser/voir.py`, la spec `vues-deplacements/contexte/aiguiser-la-lecture.md`, `run.md` (section `/aiguiser`).
|
||||
|
||||
## Ce que tu laisses
|
||||
|
||||
@@ -1,9 +1,9 @@
|
||||
---
|
||||
name: analyste
|
||||
description: Analyste de la boucle automatique (/boucle) — juge les événements des détecteurs du journal sur un lot de données de déplacement. Appelé par l'orchestrateur avec un dossier de station, un lot, la commande du lot et le chemin de sa critique.
|
||||
description: Analyste — analyse un lot de données de déplacement comme un expert (événements datés, étiquettes, events connus, nouveautés) : la vérité de /boucle, sur laquelle le detectors-critic juge les détecteurs. Appelé par l'orchestrateur de /boucle avec un dossier de station, un lot, la commande du lot et le chemin de son analyse, ou par /new-event pour les étiquettes d'un event.
|
||||
tools: Read, Bash, Write
|
||||
model: inherit
|
||||
omitClaudeMd: true
|
||||
---
|
||||
|
||||
Tu es l'analyste de la boucle. Lis `.claude/skills/critiquer-lot/SKILL.md` et suis-le à la lettre. Ta demande : ce qui suit.
|
||||
Tu es l'analyste. Lis `.claude/skills/analyser-lot/SKILL.md` et suis-le à la lettre. Ta demande : ce qui suit.
|
||||
@@ -9,15 +9,15 @@ Tu es le builder de la boucle automatique : tu construis la base de connaissance
|
||||
|
||||
## Ta demande
|
||||
|
||||
Le dossier de station, le lot (UTC), le dossier du lot (ses rendus : `critique.md`, `modification-K.md`), le dossier de la séance, le chemin de ton rendu `builder.md`.
|
||||
Le dossier de station, le lot (UTC), le dossier du lot (ses rendus : `analyse.md`, `critique.md`, `modification-K.md`), le dossier de la séance, le chemin de ton rendu `builder.md`.
|
||||
|
||||
## Ce que tu fais
|
||||
|
||||
1. Lis la partie `## Nouveautés` de chaque rendu du lot, et ce que la critique en dit (parties 1 et 3, figures).
|
||||
1. Lis la partie `## Nouveautés` de chaque rendu du lot, et ce que l'analyse en dit (sa lecture, ses figures).
|
||||
2. Consulte la base comme le dit `.claude/skills/read-event/SKILL.md` (l'index, puis les fiches des events proches). **Un event par genre d'événement, pas par occurrence** : une nouveauté dont un event a déjà la signature (même rôle des capteurs, même forme, même moment de la journée, même durée à peu près) ne donne rien. La signature d'un event, c'est sa ligne d'index **ou** sa fiche : ouvre la fiche des events proches, un phénomène peut n'être que dans la fiche. Une nouveauté qui contredit le diagnostic d'un event (un même état étiqueté autrement) est « déjà connue (E-00x) », avec la contradiction en une phrase, pour l'utilisateur.
|
||||
3. Pour chaque nouveauté vraiment nouvelle, un event :
|
||||
- **numéro** : le plus grand `E-xxx` de l'index, plus un ; dossier `events/E-xxx/` ;
|
||||
- **données et diagnostic** : `python3 .claude/skills/anonymize-event/anonymiser.py <dossier de station> events/E-xxx/ --du <début − 6 h> --au <fin + 6 h> --etiquettes <dossier du lot>/etiquettes.json` (instants `AAAA-MM-JJTHH:MMZ`) : seulement la fenêtre de l'événement et sa marge ; un événement de plus d'un jour (un état qui couvre le lot) se copie sur un moment qui le montre (celui que cite la critique) ± 6 h, pas des centaines d'images, et la fiche donne les deux plages, la copiée et celle de l'événement ; les étiquettes de l'analyste dans cette fenêtre, codées, deviennent `etiquettes.json` de l'event, son diagnostic à la création, que le benchmark compare aux détecteurs (D-069), et `etiquetage.md` à côté dit d'où elles viennent ; contrôle : `python3 .claude/skills/critiquer-lot/etiquettes.py events/E-xxx events/E-xxx/etiquettes.json`, « bon » ;
|
||||
- **données et diagnostic** : `python3 .claude/skills/anonymize-event/anonymiser.py <dossier de station> events/E-xxx/ --du <début − 6 h> --au <fin + 6 h> --etiquettes <dossier du lot>/etiquettes.json` (instants `AAAA-MM-JJTHH:MMZ`) : seulement la fenêtre de l'événement et sa marge ; un événement de plus d'un jour (un état qui couvre le lot) se copie sur un moment qui le montre (celui que cite l'analyse) ± 6 h, pas des centaines d'images, et la fiche donne les deux plages, la copiée et celle de l'événement ; les étiquettes de l'analyste dans cette fenêtre, codées, deviennent `etiquettes.json` de l'event, son diagnostic à la création, que le benchmark compare aux détecteurs (D-069), et `etiquetage.md` à côté dit d'où elles viennent ; contrôle : `python3 .claude/skills/analyser-lot/etiquettes.py events/E-xxx events/E-xxx/etiquettes.json`, « bon » ;
|
||||
- **fiche** `event.md` : le modèle du §11.3 de `docs/agents/agent-diagnostic.md` (`grep -n '^### 11.3' docs/agents/agent-diagnostic.md`, puis lis cette section seule) ; prends exemple sur une fiche existante, par exemple `events/E-001/event.md` ;
|
||||
- **en tête de fiche**, juste sous le titre : `**Appris par la boucle** le <AAAA-MM-JJ>, séance <SEANCE>, non revalidé par l'expert`, `<SEANCE>` étant l'horodatage seul du dossier de la séance (`2026-10-26T1414Z`), sans la station : `anonymize-event` refuse tout nom réel ;
|
||||
- **figures et noms** : le skill `anonymize-event` (`.claude/skills/anonymize-event/SKILL.md`), étapes 2 à 4, avec la même fenêtre `--du` / `--au` à chaque relance ;
|
||||
|
||||
@@ -0,0 +1,72 @@
|
||||
---
|
||||
name: detectors-critic
|
||||
description: Critique des détecteurs de la boucle automatique (/boucle) — compare, événement par événement, ce que les détecteurs du journal trouvent sur un lot à l'analyse de l'analyste, la vérité, et rend un verdict et au plus deux suggestions pour le detectors-upgrader ; sans regarder les données. Appelé par l'orchestrateur avec le dossier de station, le lot, la commande du lot, l'analyse, le score avant et le chemin de sa critique.
|
||||
tools: Read, Bash, Write
|
||||
model: inherit
|
||||
---
|
||||
|
||||
Tu es le detectors-critic de la boucle automatique : tu juges les détecteurs du journal du matin face à l'analyse d'un lot. L'analyste a lu le lot en expert ; son analyse est la vérité. Tu compares ce que les détecteurs trouvent, événement par événement, et tu dis ce qui est faux, où, et quel détecteur en est la cause. Le detectors-upgrader adaptera les détecteurs d'après ta critique.
|
||||
|
||||
**Tu ne regardes pas les données** (D-090) : tu dis quoi et où. Comprendre dans les données pourquoi un détecteur se trompe n'est pas ton travail.
|
||||
|
||||
## Ta demande
|
||||
|
||||
Le dossier de station (pour la commande du lot seulement), le lot (UTC), la commande du lot, l'analyse (`analyse.md` ; à côté, ses étiquettes `etiquettes.json` et ses figures), le score avant, le chemin de ta critique `critique.md`.
|
||||
|
||||
## Ce que tu lis, seulement
|
||||
|
||||
- l'analyse, ses étiquettes et les figures qu'elle cite : ce sont des sorties de l'analyste, pas les données ;
|
||||
- la sortie de la commande du lot, lancée telle quelle avec `2>&1` ;
|
||||
- le score avant, et au besoin `python3 .claude/skills/boucle/score.py <dossier>` : la même comparaison, mesure par mesure, aux étiquettes (D-062) ;
|
||||
- le code des détecteurs (`detectors/*.py`, `detectors/categories.py`), pour nommer la règle en cause ;
|
||||
- `events/carte-des-evenements.md`, section 4 : les catégories du journal et les détecteurs de chacune.
|
||||
|
||||
Rien d'autre : ni le dossier de station par un autre chemin (ni outils de lecture, ni images, ni CSV), ni la base d'events, ni les autres séances de `boucle/`, ni `CLAUDE.md`, `docs/decisions.md` ou les plans. Tu listes tout ce que tu as lu dans « Sources lues ».
|
||||
|
||||
## Déroulé
|
||||
|
||||
1. **L'analyse** : chaque moment, ses bornes, ses capteurs, sa catégorie, ce que l'analyste y voit.
|
||||
2. **Les détecteurs** : lance la commande du lot telle qu'elle est donnée ; colle sa sortie.
|
||||
3. **Comparaison**, événement par événement et moment par moment : juste ; catégorie fausse ; en trop (signalé par les détecteurs, absent de l'analyse) ; bornes fausses (en retard, trop tôt, trop large) ; manquant. Une ligne chacun, avec pourquoi. L'alignement n'a pas à être parfait : quelques mesures d'écart aux bornes ne sont pas un défaut.
|
||||
4. **Score** : les lignes de ce lot dans le score avant, en appui de la comparaison.
|
||||
5. **Verdict.** « d'accord » si rien d'important n'est à corriger. Sinon « suggestions », **au plus deux**, les plus importantes : un événement significatif manqué ou mal borné passe avant une petite gêne. Chacune : le défaut, un exemple (moment UTC, capteurs), le détecteur en cause (son nom de fichier tel que la commande le montre après la catégorie ; pour un événement manquant, celui de sa catégorie : `visibilite` pour la visibilité, les passages et les cibles masquées, `sauts` pour les sauts brefs et à vérifier, `degradee` (ou `sauts` pour une cible qui bascule) pour la cible défaillante, `derive` pour la dérive lente, `thermique`, `turbulence`, `trous`), la règle en cause dans son code si tu la vois, ce qu'il faudrait, en mots et non en code. Pas de suggestion propre à une station, à un capteur ou à une date : une règle générale. Pour un événement en trop dont l'analyse ne dit pas ce qu'il y a à cet instant, dis-le : le pourquoi revient au detectors-upgrader.
|
||||
|
||||
## Le fichier
|
||||
|
||||
Écris-le exactement sur ce plan ; l'orchestrateur lit la ligne Verdict telle quelle, le detectors-upgrader les parties 3 et 5.
|
||||
|
||||
```markdown
|
||||
# Lot NN : critique des détecteurs, <STATION>, <début> → <fin> (UTC)
|
||||
|
||||
**Verdict** : d'accord | suggestions
|
||||
|
||||
## 1. L'analyse
|
||||
<son chemin, son nombre de moments, en une ligne>
|
||||
|
||||
## 2. Ce qu'ont trouvé les détecteurs
|
||||
<sortie de la commande du lot>
|
||||
|
||||
## 3. Comparaison
|
||||
| Événement ou moment | Jugement | Pourquoi |
|
||||
|
||||
## 4. Score
|
||||
<les lignes de ce lot>
|
||||
|
||||
## 5. Suggestions
|
||||
### S1 : <titre>
|
||||
- **Défaut** : …
|
||||
- **Exemple** : …
|
||||
- **Détecteur** : …
|
||||
- **Ce qu'il faudrait** : …
|
||||
|
||||
## Difficultés
|
||||
aucune | - <ce qui a gêné ton travail : consigne floue, contradictoire ou absente qui t'a fait deviner, fichier ou chemin introuvable, format inattendu, commande qui échoue ; où, et ce que tu as fait à la place>
|
||||
|
||||
## Sources lues
|
||||
```
|
||||
|
||||
La ligne Verdict porte un seul mot : `d'accord` ou `suggestions`. Sans suggestion, la partie 5 dit « aucune ». « Difficultés » ne parle que du processus (consignes, chemins, outils), pas des détecteurs : un releveur les note pour l'utilisateur (D-060). Heures en UTC.
|
||||
|
||||
## Ta réponse
|
||||
|
||||
En 3 lignes : le verdict, le nombre de suggestions, le chemin du fichier.
|
||||
@@ -1,11 +1,11 @@
|
||||
---
|
||||
name: detectors-upgrader
|
||||
description: Upgrader des détecteurs de la boucle automatique (/boucle) — adapte les détecteurs du journal (ajoute, retire, modifie) d'après la critique de l'analyste et les remarques du contrôle des détecteurs. Appelé par l'orchestrateur avec un dossier de station, un lot, la commande du lot, les chemins à lire et celui de son rendu.
|
||||
description: Upgrader des détecteurs de la boucle automatique (/boucle) — adapte les détecteurs du journal (ajoute, retire, modifie) d'après la critique du detectors-critic et les remarques du contrôle des détecteurs. Appelé par l'orchestrateur avec un dossier de station, un lot, la commande du lot, les chemins à lire et celui de son rendu.
|
||||
tools: Read, Edit, Write, Bash
|
||||
model: inherit
|
||||
---
|
||||
|
||||
Tu es le detectors-upgrader de la boucle automatique : ton travail est de rendre les détecteurs du journal du matin meilleurs. Un analyste a lu un lot de données de déplacement et jugé ce que les détecteurs y ont trouvé ; sa critique est notre vérité, et elle met déjà l'accent sur ce qui est significatif. Concentré sur ce lot, tu adaptes les détecteurs pour qu'ils trouvent les événements significatifs qu'ils avaient manqués, dans leur catégorie et aux bonnes heures. Ensuite, le contrôle des détecteurs (`detectors-control`) juge ta modification sur la base d'events, sans voir le lot : si tu colles les détecteurs à ce lot au prix des events de la base, il te renvoie ses remarques.
|
||||
Tu es le detectors-upgrader de la boucle automatique : ton travail est de rendre les détecteurs du journal du matin meilleurs. Un analyste a lu un lot de données de déplacement, et son analyse est notre vérité ; le detectors-critic y a comparé les détecteurs, et sa critique met déjà l'accent sur ce qui est significatif. Concentré sur ce lot, tu adaptes les détecteurs pour qu'ils trouvent les événements significatifs qu'ils avaient manqués, dans leur catégorie et aux bonnes heures. Ensuite, le contrôle des détecteurs (`detectors-control`) juge ta modification sur la base d'events, sans voir le lot : si tu colles les détecteurs à ce lot au prix des events de la base, il te renvoie ses remarques.
|
||||
|
||||
## Ta demande
|
||||
|
||||
|
||||
@@ -15,7 +15,7 @@ Un event `E-xxx`, et l'une de ces trois consignes :
|
||||
|
||||
1. Lis `events/E-xxx/event.md`, sa ligne de `events/INDEX.md` et `etiquetage.md` à côté.
|
||||
2. La station réelle : la ligne `<STATION>,<STATION>,E-xxx` de `.claude/skills/anonymize-event/registre.csv` ; les vrais noms des capteurs cités : les lignes `<STATION>,<nom>,<code>` du même registre. Ils sont pour l'utilisateur seulement : jamais dans un fichier de l'event.
|
||||
3. La séance : l'horodatage de l'en-tête de la fiche, dossier `boucle/<horodatage>_<STATION>/` ; le lot dont le `builder.md` cite l'event. Lis ce `builder.md` et, dans la `critique.md` du lot, ce que l'analyste dit de l'événement (`grep -n` sur les capteurs ou le phénomène, puis la section seule).
|
||||
3. La séance : l'horodatage de l'en-tête de la fiche, dossier `boucle/<horodatage>_<STATION>/` ; le lot dont le `builder.md` cite l'event. Lis ce `builder.md` et, dans l'analyse du lot (`analyse.md` ; avant D-090, la partie 1 de `critique.md`), ce que l'analyste dit de l'événement (`grep -n` sur les capteurs ou le phénomène, puis la section seule).
|
||||
4. Les détecteurs, sur la plage de l'événement (ligne **Événement** de la fiche ; `--au` exclu, donc le jour de fin plus un) : `python3 .claude/skills/boucle/detecteurs.py data/<STATION> --du <AAAA-MM-JJ> --au <AAAA-MM-JJ> --sans-ouvrir` (la page des détecteurs ne s'ouvre pas : l'utilisateur la retrouve dans la page de revue) (sans `data/<STATION>/`, hors de git, sur `events/E-xxx/`). Note ce que les détecteurs sortent sur l'événement (la liste au bas de la page, ou `score.py` si besoin) : le voient-ils, sous quelle catégorie ?
|
||||
5. Regarde chaque PNG de la fiche : montre-t-il ce que dit sa légende ?
|
||||
6. Écris la présentation (format ci-dessous) dans `out/review-event/E-xxx.md`, puis fais la page de revue, qui s'ouvre chez l'utilisateur : `python3 .claude/skills/review-event/page.py E-xxx --du <AAAA-MM-JJ> --au <AAAA-MM-JJ>` (mêmes dates qu'en 4).
|
||||
@@ -23,7 +23,7 @@ Un event `E-xxx`, et l'une de ces trois consignes :
|
||||
|
||||
### « corriger : <ce que dit l'utilisateur> »
|
||||
|
||||
- Applique ses corrections à la fiche, à la ligne d'index (sa Signature vise environ 250 caractères, une indication et non une limite ; le détail va dans la fiche, D-085) et, si le diagnostic change (catégorie, plage d'un moment), à `etiquettes.json` ; contrôle : `python3 .claude/skills/critiquer-lot/etiquettes.py events/E-xxx events/E-xxx/etiquettes.json`, « bon ». Une figure à refaire : skill `anonymize-event`, étape 2. Son jugement entre dans le **Diagnostic** (le fait, et ce qu'en dit l'expert) ; les listes fermées du §11.3 de `docs/agents/agent-diagnostic.md` restent fermées.
|
||||
- Applique ses corrections à la fiche, à la ligne d'index (sa Signature vise environ 250 caractères, une indication et non une limite ; le détail va dans la fiche, D-085) et, si le diagnostic change (catégorie, plage d'un moment), à `etiquettes.json` ; contrôle : `python3 .claude/skills/analyser-lot/etiquettes.py events/E-xxx events/E-xxx/etiquettes.json`, « bon ». Une figure à refaire : skill `anonymize-event`, étape 2. Son jugement entre dans le **Diagnostic** (le fait, et ce qu'en dit l'expert) ; les listes fermées du §11.3 de `docs/agents/agent-diagnostic.md` restent fermées.
|
||||
- Une phrase de lui qui n'est pas nette : ne devine pas, rends la question.
|
||||
- Relance l'étape 3 du skill `anonymize-event` (la commande d'`anonymiser.py` avec la fenêtre `--du` / `--au` d'`etiquetage.md`) : aucun nom réel ne reste.
|
||||
- Mets à jour `out/review-event/E-xxx.md` (ce qui est tranché quitte « À trancher », une section « Corrections de l'expert » dit ce qui a changé, « Ce que la carte apprendrait » suit les corrections) et refais la page de revue (même commande, mêmes dates).
|
||||
|
||||
@@ -1,66 +1,50 @@
|
||||
---
|
||||
name: critiquer-lot
|
||||
description: Juger les événements du journal du matin sur un lot de données de déplacement — lecture propre des courbes et des images d'abord, puis comparaison aux détecteurs, suggestions et nouveautés. Utilisé par l'analyste de /boucle, ou à la main sur un lot.
|
||||
name: analyser-lot
|
||||
description: Analyser un lot de données de déplacement comme un expert — lire les courbes et les images, trouver et dater chaque événement, l'étiqueter, dire ce que la base d'events en connaît et ce qui est nouveau. Suivi par l'analyste de /boucle (et par /new-event pour les étiquettes d'un event), ou à la main sur un lot.
|
||||
argument-hint: "<dossier> <début> <fin> <fichier de sortie> [commande du lot]"
|
||||
---
|
||||
|
||||
# Critiquer un lot
|
||||
# Analyser un lot
|
||||
|
||||
Tu juges, comme un expert, ce que les détecteurs du journal du matin (`detectors/`) ont trouvé sur un lot de quelques jours d'une station AIMsight. Une caméra suit des cibles fixées sur un ouvrage ; son propre mouvement est compensé grâce à des références, supposées fixes. Une anomalie, c'est tout ce qui rend les courbes non plates : presque toujours un moment où il ne faut pas se fier aux données (pluie, buée, passage, toile, turbulence…), parfois un vrai mouvement. Tu te fais **ta propre idée d'abord**, puis tu compares : sinon tu ne trouverais jamais ce que les détecteurs ratent. Tu ne modifies rien d'autre que ton fichier et tes figures.
|
||||
Tu lis, comme un expert, un lot de quelques jours d'une station AIMsight. Une caméra suit des cibles fixées sur un ouvrage ; son propre mouvement est compensé grâce à des références, supposées fixes. Une anomalie, c'est tout ce qui rend les courbes non plates : presque toujours un moment où il ne faut pas se fier aux données (pluie, buée, passage, toile, turbulence…), parfois un vrai mouvement. Ton travail : **l'analyse la plus précise possible** du lot, chaque événement trouvé, daté, rangé dans sa catégorie. Ton analyse est la vérité de la boucle : les détecteurs sont jugés sur elle par le `detectors-critic`, et tes nouveautés deviennent des events. Tu ne juges pas les détecteurs. Tu ne modifies rien d'autre que ton fichier, tes étiquettes et tes figures.
|
||||
|
||||
## La demande
|
||||
|
||||
Tu reçois : le dossier de station, le lot (début et fin, UTC), la commande du lot (sinon : `python3 detectors/categories.py <dossier> --du <jour du début> --au <jour de la fin>`), le chemin de ta critique. Le dossier de ta critique est `<dossier de sortie>` ci-dessous.
|
||||
Tu reçois : le dossier de station, le lot (début et fin, UTC), la commande du lot (sinon : `python3 detectors/categories.py <dossier> --du <jour du début> --au <jour de la fin>`), le chemin de ton analyse. Le dossier de ton analyse est `<dossier de sortie>` ci-dessous.
|
||||
|
||||
## Ce que tu as le droit de lire, seulement
|
||||
|
||||
- `.claude/skills/lire-les-donnees/SKILL.md` (lis-le en premier) : tes outils et ta façon de lire ;
|
||||
- le dossier de station, par ces outils, et ses images avec Read ;
|
||||
- `docs/domaine/colonnes-des-deplacements.md` et `docs/domaine/pieges-des-donnees.md`, que ce skill cite ;
|
||||
- `events/carte-des-evenements.md` : ce qui peut arriver, en familles, et les catégories du journal (section 4 : définition de chacune, éventualités du terrain qui la font, détecteurs ; D-074) ;
|
||||
- la base d'events, ta base de connaissance, quand tu veux, avant ta lecture comme pendant : comme le dit `.claude/skills/read-event/SKILL.md` (`events/INDEX.md`, puis les fiches `event.md` qu'il cite, leurs figures et leurs données). Un event connu est une piste à vérifier sur tes données, pas une conclusion (D-088).
|
||||
- `events/carte-des-evenements.md` : ce qui peut arriver, en familles, les catégories du journal (section 4 : définition de chacune, éventualités du terrain qui la font, détecteurs ; D-074) et les faux amis (section 5) ;
|
||||
- la base d'events, ta base de connaissance, quand tu veux, avant ta lecture comme pendant : comme le dit `.claude/skills/read-event/SKILL.md` (`events/INDEX.md`, puis les fiches `event.md` qu'il cite, leurs figures et leurs données). Un event connu est une piste à vérifier sur tes données, pas une conclusion (D-088) ;
|
||||
- la sortie des détecteurs, par la commande du lot, quand tu veux : un outil de plus pour trouver et dater les événements (D-090). Ce qu'ils signalent est une piste à vérifier sur les données, pas une conclusion : ce que tu n'y vérifies pas n'entre pas dans ton analyse.
|
||||
|
||||
Rien d'autre : ni `CLAUDE.md`, ni `docs/decisions.md`, ni les plans, ni rien dans `vues-deplacements/` hors du dossier de station (pas de `parcours.md`, pas de `plateforme/`), ni les séances de `aiguiser/`, ni les critiques et bilans d'autres lots dans `boucle/`, ni le code des détecteurs. Ils contiennent des conclusions sur ces données ; ton jugement doit partir des données. Tu listes tout ce que tu as lu dans « Sources lues ».
|
||||
Rien d'autre : ni `CLAUDE.md`, ni `docs/decisions.md`, ni les plans, ni rien dans `vues-deplacements/` hors du dossier de station (pas de `parcours.md`, pas de `plateforme/`), ni les séances de `aiguiser/`, ni les analyses, critiques et bilans d'autres lots dans `boucle/`, ni le code des détecteurs. Ils contiennent des conclusions sur ces données ; ton jugement doit partir des données. Tu listes tout ce que tu as lu dans « Sources lues ».
|
||||
|
||||
## Tes outils
|
||||
|
||||
Ceux de `lire-les-donnees`, avec `--debut` et `--fin` du lot et `--sortie <dossier de sortie>` pour tes figures. Bash sert aussi à lancer la commande du lot et le contrôle de tes étiquettes, `python3 .claude/skills/critiquer-lot/etiquettes.py <dossier> <dossier de sortie>/etiquettes.json`. N'écris aucun autre script.
|
||||
Ceux de `lire-les-donnees`, avec `--debut` et `--fin` du lot et `--sortie <dossier de sortie>` pour tes figures. Bash sert aussi à lancer la commande du lot et le contrôle de tes étiquettes, `python3 .claude/skills/analyser-lot/etiquettes.py <dossier> <dossier de sortie>/etiquettes.json`. N'écris aucun autre script.
|
||||
|
||||
## Déroulé
|
||||
|
||||
1. **Ta lecture, sans les détecteurs.** Lis le lot comme le dit `lire-les-donnees`. À chaque moment de son tableau, ajoute la catégorie de la carte qui conviendrait, ou « aucune catégorie ». **Écris cette partie dans ton fichier avant l'étape 2**, puis tes **étiquettes** (ci-dessous) : une par ligne du tableau, dans le même ordre ; lance leur contrôle et corrige jusqu'à « bon ».
|
||||
2. **Les détecteurs.** Lance la commande du lot telle qu'elle est donnée ; colle sa sortie.
|
||||
3. **Comparaison**, événement par événement et moment par moment : juste ; catégorie fausse ; en trop ; bornes fausses (en retard, trop tôt, trop large) ; manquant. Une ligne chacun, avec pourquoi. Un événement des détecteurs juste, que tu vérifies dans les données mais qui manque à ta lecture : ajoute-le à tes étiquettes avec `"apres_detecteurs": true`, et relance le contrôle. Ne change jamais les étiquettes de l'étape 1.
|
||||
4. **Events connus** : les events de la base proches de tes moments (`read-event` : l'index, puis au plus 3 fiches), consultés avant ou maintenant. Ce que la base connaît déjà, events « (appris) » compris.
|
||||
5. **Verdict.** « d'accord » si rien d'important n'est à corriger. Sinon « suggestions », **au plus deux**, les plus importantes. Chacune : le défaut, un exemple (moment UTC, capteurs), le détecteur en cause (son nom de fichier tel que la commande le montre après la catégorie ; pour un événement manquant, celui de sa catégorie : `visibilite` pour la visibilité, les passages et les cibles masquées, `sauts` pour les sauts brefs et à vérifier, `degradee` (ou `sauts` pour une cible qui bascule) pour la cible défaillante, `derive` pour la dérive lente, `thermique`, `turbulence`, `trous`), ce qu'il faudrait, en mots et non en code. Pas de suggestion propre à une station, à un capteur ou à une date : une règle générale.
|
||||
6. **Nouveautés** : ce que ni la carte ni l'index ne décrivent ; chacune avec son moment, ses capteurs, ce qui la montre et la figure.
|
||||
1. **Ta lecture.** Lis le lot comme le dit `lire-les-donnees`, avec la carte, la base et les détecteurs si tu veux. À chaque moment de son tableau, ajoute la catégorie de la carte qui conviendrait, ou « aucune catégorie ».
|
||||
2. **Tes étiquettes** (ci-dessous) : une par ligne du tableau, dans le même ordre ; lance leur contrôle et corrige jusqu'à « bon ».
|
||||
3. **Events connus** : les events de la base proches de tes moments (`read-event` : l'index, puis au plus 3 fiches), consultés avant ou maintenant. Ce que la base connaît déjà, events « (appris) » compris.
|
||||
4. **Nouveautés** : ce que ni la carte ni l'index ne décrivent ; chacune avec son moment, ses capteurs, ce qui la montre et la figure.
|
||||
|
||||
## Le fichier
|
||||
|
||||
Écris-le exactement sur ce plan ; l'orchestrateur lit la ligne Verdict et le titre « Nouveautés » tels quels.
|
||||
Écris-le exactement sur ce plan ; le builder lit le titre « Nouveautés » tel quel.
|
||||
|
||||
```markdown
|
||||
# Lot NN : <STATION>, <début> → <fin> (UTC)
|
||||
|
||||
**Verdict** : d'accord | suggestions
|
||||
|
||||
## 1. Ma lecture
|
||||
| Début | Fin | Capteurs | Colonnes | Ce que je vois | Images | Catégorie |
|
||||
|
||||
## 2. Ce qu'ont trouvé les détecteurs
|
||||
<sortie de la commande du lot>
|
||||
|
||||
## 3. Comparaison
|
||||
| Événement ou moment | Jugement | Pourquoi |
|
||||
|
||||
## 4. Events connus
|
||||
|
||||
## 5. Suggestions
|
||||
### S1 : <titre>
|
||||
- **Défaut** : …
|
||||
- **Exemple** : …
|
||||
- **Détecteur** : …
|
||||
- **Ce qu'il faudrait** : …
|
||||
## 2. Events connus
|
||||
|
||||
## Nouveautés
|
||||
aucune | - <moment, capteurs, ce qui le montre, figure>
|
||||
@@ -71,7 +55,7 @@ aucune | - <ce qui a gêné ton travail : consigne floue, contradictoire ou abse
|
||||
## Sources lues
|
||||
```
|
||||
|
||||
La ligne Verdict porte un seul mot : `d'accord` ou `suggestions`. Sans suggestion, la partie 5 dit « aucune ». « Difficultés » ne parle que du processus (consignes, chemins, outils), pas des données ni des détecteurs : un releveur les note pour l'utilisateur (D-060). Les figures sont dans le dossier de sortie, citées par leur nom. Heures en UTC.
|
||||
« Ce que je vois » porte ce qu'un autre, qui ne voit pas les données, doit savoir pour juger les détecteurs : la forme, l'ampleur face au niveau habituel, le retour ou non, les capteurs témoins intacts, la caméra. « Difficultés » ne parle que du processus (consignes, chemins, outils), pas des données ni des détecteurs : un releveur les note pour l'utilisateur (D-060). Les figures sont dans le dossier de sortie, citées par leur nom. Heures en UTC.
|
||||
|
||||
## Les étiquettes
|
||||
|
||||
@@ -91,7 +75,8 @@ La ligne Verdict porte un seul mot : `d'accord` ou `suggestions`. Sans suggestio
|
||||
- `evenement` : le « Label du site » de la ligne de la section 1 de la carte qui dit la cause (`"Rain or fog"`, `"Spider web"`), ou `null` si la cause n'est pas établie.
|
||||
- `preuve` : `"vue"` si les images la montrent, `"deduite"` si elle vient des courbes seules.
|
||||
- `description` : ta colonne « Ce que je vois », en une ou deux phrases.
|
||||
- `apres_detecteurs` : `true` pour un moment que tu as trouvé grâce aux détecteurs (vu dans leur sortie, puis vérifié dans les données), `false` sinon.
|
||||
|
||||
## Ta réponse
|
||||
|
||||
Après avoir écrit le fichier, réponds en 3 lignes : le verdict, le nombre de suggestions, de nouveautés et d'étiquettes, le chemin du fichier.
|
||||
Après avoir écrit le fichier, réponds en 3 lignes : le nombre de moments (étiquettes), de nouveautés, le chemin du fichier.
|
||||
+3
-3
@@ -9,10 +9,10 @@ Un JSON par lot, <lot>/etiquettes.json :
|
||||
- categorie : une clé de la section 4 de la carte des événements, ou "aucune" ; evenement : le label du site d'une ligne
|
||||
de sa section 1 (« Rain or fog »), ou null si la cause n'est pas établie ; la carte est la seule source du vocabulaire ;
|
||||
- preuve : "vue" (sur les images) ou "deduite" (des courbes seules) ;
|
||||
- apres_detecteurs : true pour un moment ajouté à la comparaison, vu dans les données après la sortie des détecteurs.
|
||||
- apres_detecteurs : true pour un moment trouvé grâce aux détecteurs (vu dans leur sortie, puis vérifié dans les données).
|
||||
Un instant du lot sans moment : l'analyste n'y a rien vu.
|
||||
Usage : python3 .claude/skills/critiquer-lot/etiquettes.py <dossier de station> <etiquettes.json>
|
||||
python3 .claude/skills/critiquer-lot/etiquettes.py --test
|
||||
Usage : python3 .claude/skills/analyser-lot/etiquettes.py <dossier de station> <etiquettes.json>
|
||||
python3 .claude/skills/analyser-lot/etiquettes.py --test
|
||||
"""
|
||||
import json
|
||||
import os
|
||||
@@ -130,7 +130,7 @@ def etiquetage_md(chemin, texte):
|
||||
seance = os.path.basename(os.path.dirname(lot)).split("_")[0]
|
||||
lignes = [f"# Étiquetage de {e['station']}", "",
|
||||
f"Étiquettes de l'analyste de `/boucle`, séance {seance}, {os.path.basename(lot)} (sa lecture : section "
|
||||
f"« 1. Ma lecture » de `critique.md` du lot), recopiées par `anonymiser.py --etiquettes`, bornées à la "
|
||||
f"« 1. Ma lecture » de `analyse.md` du lot), recopiées par `anonymiser.py --etiquettes`, bornées à la "
|
||||
f"fenêtre de l'event ({e['debut']} → {e['fin']}) et codées (D-069). Pas relues contre la fiche : la fiche de l'"
|
||||
"event vient de la même lecture.", "",
|
||||
"| Début | Fin | Capteurs | Catégorie | Événement | Preuve | Description |", "|---|---|---|---|---|---|---|"]
|
||||
|
||||
@@ -1,13 +1,13 @@
|
||||
---
|
||||
name: boucle
|
||||
description: Séance automatique d'amélioration des détecteurs du journal du matin et de la base d'events, sur un lot d'une station, la plage choisie par l'utilisateur (D-057) — analyste, detectors-upgrader, detectors-control, builder. Lancé par l'utilisateur seulement, avec /boucle.
|
||||
description: Séance automatique d'amélioration des détecteurs du journal du matin et de la base d'events, sur un lot d'une station, la plage choisie par l'utilisateur (D-057) — analyste, detectors-critic, detectors-upgrader, detectors-control, builder. Lancé par l'utilisateur seulement, avec /boucle.
|
||||
disable-model-invocation: true
|
||||
argument-hint: "data/<STATION> [--du AAAA-MM-JJ] [--au AAAA-MM-JJ] [--ameliorer]"
|
||||
---
|
||||
|
||||
# La boucle automatique
|
||||
|
||||
Tu es l'orchestrateur. Tu appelles les quatre agents dans l'ordre, tu transmets leurs rendus et tu commites ; en fin de séance, le releveur note leurs difficultés. **Tu ne juges rien toi-même** : tu lis seulement les lignes de verdict. **Tu ne poses aucune question à l'utilisateur** : la séance tourne seule jusqu'au bout. Spec : `vues-deplacements/contexte/boucle-automatique.md`.
|
||||
Tu es l'orchestrateur. Tu appelles les cinq agents dans l'ordre, tu transmets leurs rendus et tu commites ; en fin de séance, le releveur note leurs difficultés. **Tu ne juges rien toi-même** : tu lis seulement les lignes de verdict. **Tu ne poses aucune question à l'utilisateur** : la séance tourne seule jusqu'au bout. Spec : `vues-deplacements/contexte/boucle-automatique.md`.
|
||||
|
||||
## 1. Mise en place
|
||||
|
||||
@@ -27,12 +27,14 @@ Un seul lot, numéroté `01` (`NN` ci-dessous) : de `--du` 00:00Z (sinon le prem
|
||||
|
||||
Chaque agent est appelé par l'outil Agent avec son `subagent_type` et la demande ci-dessous, rien d'autre. Un verdict se lit par `grep '^\*\*Verdict\*\* :' <rendu>`. Chaque commit se fait par chemin, `git add <chemins> && git commit -m "<message>" -- <chemins>`, après `git branch --show-current` : une autre session peut changer de branche pendant la séance ; si ce n'est plus `master`, ne commite plus rien (pas de `git switch`), passe au bilan, écrit sans commit, et note la branche trouvée sous « Erreurs ». Son message se termine par une ligne vide puis `Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>`.
|
||||
|
||||
1. **Analyste** (`analyste`) : `Dossier : <dossier>. Lot NN : <début> → <fin> (UTC). Commande du lot : <commande>. Écris <lot>/critique.md.`
|
||||
`python3 .claude/skills/critiquer-lot/etiquettes.py <dossier> <lot>/etiquettes.json` : sa dernière ligne va au bilan (colonne Étiquettes : « n moments », « absentes » ou « n défauts ») ; tu ne corriges rien et ne relances pas l'analyste pour elles (D-061).
|
||||
1. **Analyste** (`analyste`) : `Dossier : <dossier>. Lot NN : <début> → <fin> (UTC). Commande du lot : <commande>. Écris <lot>/analyse.md.`
|
||||
`python3 .claude/skills/analyser-lot/etiquettes.py <dossier> <lot>/etiquettes.json` : sa dernière ligne va au bilan (colonne Étiquettes : « n moments », « absentes » ou « n défauts ») ; tu ne corriges rien et ne relances pas l'analyste pour elles (D-061).
|
||||
`python3 .claude/skills/boucle/score.py <dossier> > <lot>/score-avant.txt 2>&1` : le score des détecteurs du début du lot sur toutes les étiquettes de la station, ce lot compris (D-062).
|
||||
`python3 .claude/skills/boucle/benchmark.py --seance <SEANCE> --etape "lot-NN avant" > <lot>/benchmark-avant.txt 2>&1` : le benchmark, les détecteurs face au diagnostic gardé dans chaque event de la base, ajouté à l'historique (D-069).
|
||||
Commit `<lot>/ vues-deplacements/benchmark/historique.csv`, message `Loop <STATION> lot NN: critique (<verdict>)`.
|
||||
2. Verdict `d'accord` : va à l'étape 5.
|
||||
Commit `<lot>/ vues-deplacements/benchmark/historique.csv`, message `Loop <STATION> lot NN: analysis`.
|
||||
2. **Detectors-critic** (`detectors-critic`), qui juge les détecteurs face à l'analyse, sans regarder les données (D-090) : `Dossier : <dossier>. Lot NN : <début> → <fin> (UTC). Commande du lot : <commande>. Analyse : <lot>/analyse.md. Score avant : <lot>/score-avant.txt. Écris <lot>/critique.md.`
|
||||
Commit `<lot>/`, message `Loop <STATION> lot NN: critique (<verdict>)`.
|
||||
Verdict `d'accord` : va à l'étape 5.
|
||||
3. **Detectors-upgrader** (`detectors-upgrader`), passage K = 1, 2 ou 3. Avant le passage 1, note la **base du lot** : `git rev-parse HEAD`.
|
||||
`Dossier : <dossier>. Lot NN : <début> → <fin> (UTC). Commande du lot : <commande>. Critique : <lot>/critique.md. Score avant : <lot>/score-avant.txt. Benchmark avant : <lot>/benchmark-avant.txt. [Contrôle précédent : <lot>/validation-(K-1).md.] Passage K. Écris <lot>/modification-K.md.`
|
||||
Commit `detectors/ vues-deplacements/contexte/seuils-du-journal.md <lot>/`, message `Loop <STATION> lot NN: modification K`.
|
||||
@@ -69,7 +71,7 @@ Benchmark sur la base d'events (D-069) : au début du lot `lot-01/benchmark-avan
|
||||
|
||||
Page : `out/boucle_<SEANCE>_<STATION>.html`, l'analyste face aux détecteurs sur toute la plage (D-066) ; la refaire : `python3 .claude/skills/boucle/comparaison.py <dossier> <séance>`.
|
||||
|
||||
| Lot | Dates (UTC) | Analyste | Étiquettes | Modification | Events créés |
|
||||
| Lot | Dates (UTC) | Critique | Étiquettes | Modification | Events créés |
|
||||
|---|---|---|---|---|---|
|
||||
| 01 | … → … | d'accord / suggestions (n) | n moments / absentes / n défauts | aucune / gardée (K passages) / annulée / erreur | E-xxx / aucun |
|
||||
|
||||
@@ -90,7 +92,7 @@ Commit `<séance>/bilan.md <séance>/score-fin.txt <séance>/benchmark-fin.txt v
|
||||
**Releveur** (`releveur`), une fois, même si tout s'est bien passé : `Processus : /boucle (.claude/skills/boucle/SKILL.md). Séance : <séance>/ : la section « Difficultés » de chaque rendu des lots, et « Erreurs » du bilan. Difficultés de l'orchestrateur : aucune | <une consigne de ce skill qui t'a fait deviner, une commande qui a échoué…>.` (D-060)
|
||||
Si `git status --short docs/ameliorations-processus.md` montre un changement : commit de ce chemin, message `Loop <STATION>: process difficulties`.
|
||||
|
||||
**Améliorateur** (`ameliorateur`), seulement avec `--ameliorer` et si le releveur a commité : `Processus : /boucle. Commit du releveur : <commit>.`, le commit pris par `git rev-parse HEAD` juste après celui du releveur (D-071). Puis commit des chemins qu'il a pu toucher, `.claude/skills/boucle/ .claude/skills/critiquer-lot/ .claude/agents/analyste.md .claude/agents/detectors-upgrader.md .claude/agents/detectors-control.md .claude/agents/builder.md .claude/agents/releveur.md .claude/agents/ameliorateur.md vues-deplacements/contexte/boucle-automatique.md run.md docs/ameliorations-processus.md`, seulement ceux que `git status --short` montre changés, message `Loop <STATION>: process fixes`. Garde la suite de ce skill telle que tu l'as lue au début.
|
||||
**Améliorateur** (`ameliorateur`), seulement avec `--ameliorer` et si le releveur a commité : `Processus : /boucle. Commit du releveur : <commit>.`, le commit pris par `git rev-parse HEAD` juste après celui du releveur (D-071). Puis commit des chemins qu'il a pu toucher, `.claude/skills/boucle/ .claude/skills/analyser-lot/ .claude/agents/analyste.md .claude/agents/detectors-critic.md .claude/agents/detectors-upgrader.md .claude/agents/detectors-control.md .claude/agents/builder.md .claude/agents/releveur.md .claude/agents/ameliorateur.md vues-deplacements/contexte/boucle-automatique.md run.md docs/ameliorations-processus.md`, seulement ceux que `git status --short` montre changés, message `Loop <STATION>: process fixes`. Garde la suite de ce skill telle que tu l'as lue au début.
|
||||
|
||||
## 7. Réponse finale
|
||||
|
||||
|
||||
@@ -23,7 +23,7 @@ from pathlib import Path
|
||||
|
||||
RACINE = os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "..", "..")
|
||||
sys.path.insert(0, os.path.join(RACINE, "detectors"))
|
||||
sys.path.insert(0, os.path.join(RACINE, ".claude", "skills", "critiquer-lot"))
|
||||
sys.path.insert(0, os.path.join(RACINE, ".claude", "skills", "analyser-lot"))
|
||||
import categories # noqa: E402 (il met lui-même agent-tools sur le chemin)
|
||||
from donnees import charger, instant, iso # noqa: E402
|
||||
from etiquettes import defauts, vocabulaire # noqa: E402
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
name: lire-les-donnees
|
||||
description: Lire un dossier de données de déplacement d'une station AIMsight, courbes et images, avec les outils de lecture — ce qu'ils rendent et comment s'en servir. Suivi par l'analyste (critiquer-lot), l'agent de diagnostic et le lecteur de /aiguiser ; amélioré par /aiguiser.
|
||||
description: Lire un dossier de données de déplacement d'une station AIMsight, courbes et images, avec les outils de lecture — ce qu'ils rendent et comment s'en servir. Suivi par l'analyste (analyser-lot), l'agent de diagnostic et le lecteur de /aiguiser ; amélioré par /aiguiser.
|
||||
---
|
||||
|
||||
# Lire les données
|
||||
|
||||
@@ -54,7 +54,7 @@ Le sous-agent reçoit la branche et les derniers messages de commit (§7 de la s
|
||||
- **Ligne d'index** : `| [E-xxx](E-xxx/event.md) | <événement, UTC> | <signature courte, observable> | <classification> | <cause, niveau de preuve> | <verdict court> |`, la signature d'environ 250 caractères, une indication et non une limite, le détail allant dans la fiche (D-085). Retire « *Base vide pour l'instant.* ».
|
||||
- **Validation du rapport à l'aveugle** : verdict accepté ou corrigé (en quoi) ; diagnostic final, celui de l'expert ; `Devient un event : oui (E-xxx)`.
|
||||
- **Anonymise** avec le skill `anonymize-event` (étape 3) : la station devient `E-xxx`, les capteurs `R1`, `C1`, et aucun nom réel ne reste (D-049, D-050).
|
||||
- **Étiquettes de l'event** (D-069), pour le benchmark des détecteurs : l'outil Agent, `subagent_type: analyste`, avec cette demande (`<lot>` : première mesure de l'event → dernière plus un pas, UTC) : `Étiquettes d'un event de la base (benchmark des détecteurs, D-069), pas un lot de la boucle. Dossier de station : events/E-xxx/ (noms codés). Lot : <lot>. Dossier de sortie, pour tes figures : out/benchmark/E-xxx/. Fais seulement l'étape 1 de critiquer-lot : ta lecture, sans les détecteurs, puis tes étiquettes (section « Les étiquettes », "station": "E-xxx"), contrôlées par python3 .claude/skills/critiquer-lot/etiquettes.py events/E-xxx events/E-xxx/etiquettes.json jusqu'à « bon ». Ensuite seulement, lis la fiche events/E-xxx/event.md, validée par l'expert, corrige les étiquettes qu'elle contredit (en réécrivant le fichier avec Write) et recontrôle. Écris events/E-xxx/etiquettes.json et `events/E-xxx/etiquetage.md`, dans cet ordre de sections : ta lecture (le tableau des moments de lire-les-donnees, avec la catégorie de chacun), « Ce que la fiche a changé », « Sources lues », « Difficultés » ; pas de verdict. Réponds en 3 lignes.` Le rendu, `etiquetage.md`, reste dans le dossier de l'event, à côté de ses étiquettes.
|
||||
- **Étiquettes de l'event** (D-069), pour le benchmark des détecteurs : l'outil Agent, `subagent_type: analyste`, avec cette demande (`<lot>` : première mesure de l'event → dernière plus un pas, UTC) : `Étiquettes d'un event de la base (benchmark des détecteurs, D-069), pas un lot de la boucle. Dossier de station : events/E-xxx/ (noms codés). Lot : <lot>. Dossier de sortie, pour tes figures : out/benchmark/E-xxx/. Fais les étapes 1 et 2 d'analyser-lot : ta lecture, sans les détecteurs ni la base d'events (les étiquettes du benchmark ne doivent rien leur devoir), puis tes étiquettes (section « Les étiquettes », "station": "E-xxx"), contrôlées par python3 .claude/skills/analyser-lot/etiquettes.py events/E-xxx events/E-xxx/etiquettes.json jusqu'à « bon ». Ensuite seulement, lis la fiche events/E-xxx/event.md, validée par l'expert, corrige les étiquettes qu'elle contredit (en réécrivant le fichier avec Write) et recontrôle. Écris events/E-xxx/etiquettes.json et `events/E-xxx/etiquetage.md`, dans cet ordre de sections : ta lecture (le tableau des moments de lire-les-donnees, avec la catégorie de chacun), « Ce que la fiche a changé », « Sources lues », « Difficultés ». Réponds en 3 lignes.` Le rendu, `etiquetage.md`, reste dans le dossier de l'event, à côté de ses étiquettes.
|
||||
- **Carte des événements** (D-087) : écris dans `events/carte-des-evenements.md` ce que l'event enseigne, général, sans code de capteur ni chiffre propre à l'event : l'event dans « Event / source » de son événement (section 1), un trait nouveau dans « Ce qu'on voit », ou une ligne de plus ; une ressemblance trompeuse dans la section 5, « Faux amis ».
|
||||
- **Montre la fiche, la ligne d'index et le diff de la carte à l'utilisateur, et attends son accord** : c'est l'expert qui valide un event, pas Claude.
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
name: read-event
|
||||
description: Consulter la base d'events des déplacements (events/) sans la lire en entier — la carte des événements et l'index d'abord, puis la fiche d'un event proche, puis ses données avec les outils de lecture. À utiliser dès qu'un agent ou une conversation veut savoir ce que la base connaît d'un événement ; suivi par l'agent de diagnostic (et /support), l'analyste (critiquer-lot) et le builder de /boucle.
|
||||
description: Consulter la base d'events des déplacements (events/) sans la lire en entier — la carte des événements et l'index d'abord, puis la fiche d'un event proche, puis ses données avec les outils de lecture. À utiliser dès qu'un agent ou une conversation veut savoir ce que la base connaît d'un événement ; suivi par l'agent de diagnostic (et /support), l'analyste (analyser-lot) et le builder de /boucle.
|
||||
---
|
||||
|
||||
# Consulter la base d'events
|
||||
|
||||
@@ -16,7 +16,7 @@ Le builder de `/boucle` ajoute des events sans l'avis de l'expert (D-057). L'exp
|
||||
## 2. Pour chaque event
|
||||
|
||||
1. Lance l'outil Agent, `subagent_type: revue`, prompt : `E-xxx, présenter`. Attends sa notification.
|
||||
2. La page de revue `out/review-event/E-xxx.html` s'est ouverte dans son navigateur : la présentation de l'agent, la page des détecteurs, la fiche, la critique du lot d'origine, toutes les figures. **Ne recopie pas la présentation dans la conversation** : dis en une ligne que la page est ouverte (avec son chemin, `python3 .claude/skills/review-event/page.py E-xxx --du … --au …` pour la rouvrir), puis la liste « À trancher » que l'agent rend.
|
||||
2. La page de revue `out/review-event/E-xxx.html` s'est ouverte dans son navigateur : la présentation de l'agent, la page des détecteurs, la fiche, l'analyse et la critique du lot d'origine, toutes les figures. **Ne recopie pas la présentation dans la conversation** : dis en une ligne que la page est ouverte (avec son chemin, `python3 .claude/skills/review-event/page.py E-xxx --du … --au …` pour la rouvrir), puis la liste « À trancher » que l'agent rend.
|
||||
3. Pose la question (AskUserQuestion), « E-xxx : ton avis ? » :
|
||||
- **Valider** : l'event est juste tel quel ;
|
||||
- **Corriger** : il écrit ses corrections (champ libre « Other », ou dans la conversation) ;
|
||||
@@ -25,7 +25,7 @@ Le builder de `/boucle` ajoute des events sans l'avis de l'expert (D-057). L'exp
|
||||
4. Selon sa réponse :
|
||||
- **Corriger** : envoie à l'agent (SendMessage, son identifiant ; à défaut, un nouvel agent `revue` avec le même début de prompt) `E-xxx, corriger : <ses mots, tels quels>`. Relaie son rendu, `git diff --stat events/` ; la page s'est rouverte, à jour ; puis repose la question 3 ;
|
||||
- **Valider** : envoie `E-xxx, valider`, relaie les deux lignes et le diff de la carte, puis commite par chemin `events/E-xxx/`, `events/INDEX.md` et `events/carte-des-evenements.md`, message `Validate event E-xxx` (ou `Validate case E-xxx with the expert's corrections`) ;
|
||||
- **Rejeter** : demande en une phrase s'il faut une trace (une ligne dans la critique du lot d'origine suffit), puis `git rm -r events/E-xxx/`, retire sa ligne d'index, commite par chemin, message `Remove learned case E-xxx rejected by the expert`. Le registre garde ses lignes (il ne fait que grandir) ; le numéro n'est pas réutilisé ;
|
||||
- **Rejeter** : demande en une phrase s'il faut une trace (une ligne dans l'analyse du lot d'origine suffit, sa critique avant D-090), puis `git rm -r events/E-xxx/`, retire sa ligne d'index, commite par chemin, message `Remove learned case E-xxx rejected by the expert`. Le registre garde ses lignes (il ne fait que grandir) ; le numéro n'est pas réutilisé ;
|
||||
- **Passer** : rien.
|
||||
5. Event suivant.
|
||||
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
En tête, la présentation de l'agent revue (out/review-event/E-xxx.md, si elle existe), puis la page des détecteurs sur la
|
||||
plage (detecteurs.py, sur data/<STATION>/, sinon sur le dossier de l'event) ; dessous, la fiche, l'étiquetage, le rendu du
|
||||
builder et la critique du lot d'origine, puis toutes les figures : celles de l'event et celles du lot de la séance.
|
||||
builder, l'analyse et la critique du lot d'origine, puis toutes les figures : celles de l'event et celles du lot de la séance.
|
||||
Les vrais noms y figurent (registre) : la page reste dans out/, hors de git.
|
||||
Usage : python3 .claude/skills/review-event/page.py E-xxx --du AAAA-MM-JJ --au AAAA-MM-JJ (--au exclu ; page ouverte)
|
||||
"""
|
||||
@@ -81,7 +81,9 @@ def page(event, du, au):
|
||||
annexe = bloc("Fiche de l'event (event.md, noms codés)", fiche)
|
||||
for titre, chemin in [("Étiquetage de l'event", os.path.join(dossier_event, "etiquetage.md")),
|
||||
("Rendu du builder", lot and os.path.join(lot, "builder.md")),
|
||||
("Critique de l'analyste, lot d'origine", lot and os.path.join(lot, "critique.md"))]:
|
||||
("Analyse de l'analyste, lot d'origine", lot and os.path.join(lot, "analyse.md")),
|
||||
# avant D-090, critique.md portait aussi la lecture de l'analyste
|
||||
("Critique des détecteurs, lot d'origine", lot and os.path.join(lot, "critique.md"))]:
|
||||
texte = chemin and lire(chemin)
|
||||
if texte:
|
||||
annexe += bloc(titre, texte, ouvert=False)
|
||||
|
||||
@@ -68,7 +68,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .
|
||||
### Lire sans saturer le contexte
|
||||
|
||||
- Fichier long (tailles en lignes ci-dessous) : lire son plan (`grep -n '^#' <fichier>`), puis la seule section utile (Read avec `offset` et `limit`).
|
||||
- `docs/decisions.md` (902 l, D-001 à D-089) : index par `grep -n '^## D-' docs/decisions.md`, puis l'entrée citée seulement ; son **Statut** dit si elle est remplacée.
|
||||
- `docs/decisions.md` (912 l, D-001 à D-090) : index par `grep -n '^## D-' docs/decisions.md`, puis l'entrée citée seulement ; son **Statut** dit si elle est remplacée.
|
||||
- `data/` : explorer par script (`common.stations.load_stations`, outils de `agent-tools/`), jamais en affichant les CSV.
|
||||
- Ne pas lire : `docs/superpowers/` (historique, sauf le plan vivant et la spec du support), `out/`, `.venv/`, `graphify-out/`.
|
||||
|
||||
@@ -112,7 +112,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .
|
||||
- Jeux de travail : VERMONT pour Energy (D-009, le plus long historique) ; WEISSHORN pour Storage (D-034) ; WEISSHORN et NORDEND pour Cellular (D-030, D-032) et Temperature (D-040) ; à pomper s'ils manquent.
|
||||
- WEISSHORN et NORDEND contiennent des identifiants (`SIM_CCID`, `ip`, `ip_*`) : ne pas les recopier.
|
||||
- Les données des events restent, codées, dans `events/`.
|
||||
- `.claude/` : `rules/analyses.md` ; `agents/` : `diagnostic`, ceux de `/boucle` (`analyste`, `detectors-upgrader`, `detectors-control`, `builder`), de `/aiguiser` (`lecteur`, `correcteur`, `optimiseur`), `revue` (`/review-event`), `releveur` et `ameliorateur` (D-060, D-071, D-076) ; `skills/` : `support`, `boucle`, `critiquer-lot`, `aiguiser`, `lire-les-donnees`, `read-event`, `new-event`, `review-event`, `anonymize-event` (D-049, D-050), `nouvelle-analyse`, `nouveau-domaine` ; `settings.json` (lecture de `.env` interdite).
|
||||
- `.claude/` : `rules/analyses.md` ; `agents/` : `diagnostic`, ceux de `/boucle` (`analyste`, `detectors-critic`, `detectors-upgrader`, `detectors-control`, `builder`), de `/aiguiser` (`lecteur`, `correcteur`, `optimiseur`), `revue` (`/review-event`), `releveur` et `ameliorateur` (D-060, D-071, D-076) ; `skills/` : `support`, `boucle`, `analyser-lot`, `aiguiser`, `lire-les-donnees`, `read-event`, `new-event`, `review-event`, `anonymize-event` (D-049, D-050), `nouvelle-analyse`, `nouveau-domaine` ; `settings.json` (lecture de `.env` interdite).
|
||||
- `.devcontainer/` : environnement de dev en conteneur (D-038), réseau de l'hôte pour joindre la caméra. `out/` : pages et JSON générés.
|
||||
- Tout est versionné (D-014), sauf `out/`, `data/`, `.venv/`, `__pycache__/`, `graphify-out/` et `.env`.
|
||||
|
||||
|
||||
@@ -1 +1 @@
|
||||
<mxfile host="drawio" version="24.7.17"><diagram id="p1" name="1. Vue d'ensemble"><mxGraphModel dx="1400" dy="900" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="1500" pageHeight="1000" math="0" shadow="0"><root><mxCell id="0"/><mxCell id="1" parent="0"/><mxCell id="p1_P1" value="<b>/aiguiser &lt;dossier&gt;</b><br>affine les outils de lecture (D-059)" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;arcSize=4;verticalAlign=top;spacingTop=6;" vertex="1" parent="1"><mxGeometry x="40" y="170" width="320" height="300" as="geometry"/></mxCell><mxCell id="p1_P2" value="<b>/boucle &lt;dossier&gt;</b><br>règle les détecteurs du journal (D-057)" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;arcSize=4;verticalAlign=top;spacingTop=6;" vertex="1" parent="1"><mxGeometry x="400" y="170" width="320" height="300" as="geometry"/></mxCell><mxCell id="p1_P3" value="<b>@agent-diagnostic data/… [question]</b><br>enquête à la demande sur un cas (D-058)" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;arcSize=4;verticalAlign=top;spacingTop=6;" vertex="1" parent="1"><mxGeometry x="760" y="170" width="320" height="300" as="geometry"/></mxCell><mxCell id="p1_P4" value="<b>/nouveau-cas</b><br>ajoute un cas validé (D-048)" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;arcSize=4;verticalAlign=top;spacingTop=6;" vertex="1" parent="1"><mxGeometry x="1120" y="170" width="320" height="300" as="geometry"/></mxCell><mxCell id="p1_lg" value="<b>Légende</b>" style="rounded=0;whiteSpace=wrap;html=1;fillColor=#ffffff;strokeColor=#cccccc;verticalAlign=top;align=left;spacingLeft=8;fontSize=11;" vertex="1" parent="1"><mxGeometry x="1130" y="790" width="330" height="165" as="geometry"/></mxCell><mxCell id="p1_t" value="<b>Processus IA du projet : vue d'ensemble</b><br><font style="font-size:12px">Qui lance quoi, et qui modifie quel bien partagé (au 2026-10-24). Tout est lancé à la main par l'utilisateur.</font>" style="text;html=1;align=left;verticalAlign=top;whiteSpace=wrap;fontSize=18;" vertex="1" parent="1"><mxGeometry x="40" y="20" width="900" height="50" as="geometry"/></mxCell><mxCell id="p1_u" value="<b>Utilisateur (l'expert)</b><br>lance chaque processus, fusionne les branches" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#ffe6cc;strokeColor=#d79b00;arcSize=12;" vertex="1" parent="1"><mxGeometry x="600" y="85" width="280" height="50" as="geometry"/></mxCell><mxCell id="p1_lecteur" value="<b>lecteur</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="55" y="235" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_correcteur" value="<b>correcteur</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="205" y="235" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_optimiseur" value="<b>optimiseur</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="55" y="289" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_P1f" value="Lit : data/ ; au contrôle final, les cas validés.<br>Garde une modification des outils seulement si la relecture est <i>mieux</i>." style="text;html=1;align=left;verticalAlign=top;whiteSpace=wrap;fontSize=11;" vertex="1" parent="1"><mxGeometry x="55" y="360" width="290" height="100" as="geometry"/></mxCell><mxCell id="p1_analyste" value="<b>analyste</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="415" y="235" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_upgrader" value="<b>detectors-upgrader</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="565" y="235" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_validateur" value="<b>detectors-control</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="415" y="289" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_builder" value="<b>builder</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="565" y="289" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_P2f" value="Lit : data/ par les outils de lecture ; la base de cas, après sa propre lecture." style="text;html=1;align=left;veLine truncated
|
||||
<mxfile host="drawio" version="24.7.17"><diagram id="p1" name="1. Vue d'ensemble"><mxGraphModel dx="1400" dy="900" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="1500" pageHeight="1000" math="0" shadow="0"><root><mxCell id="0"/><mxCell id="1" parent="0"/><mxCell id="p1_P1" value="<b>/aiguiser &lt;dossier&gt;</b><br>affine les outils de lecture (D-059)" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;arcSize=4;verticalAlign=top;spacingTop=6;" vertex="1" parent="1"><mxGeometry x="40" y="170" width="320" height="300" as="geometry"/></mxCell><mxCell id="p1_P2" value="<b>/boucle &lt;dossier&gt;</b><br>règle les détecteurs du journal (D-057)" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;arcSize=4;verticalAlign=top;spacingTop=6;" vertex="1" parent="1"><mxGeometry x="400" y="170" width="320" height="300" as="geometry"/></mxCell><mxCell id="p1_P3" value="<b>@agent-diagnostic data/… [question]</b><br>enquête à la demande sur un cas (D-058)" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;arcSize=4;verticalAlign=top;spacingTop=6;" vertex="1" parent="1"><mxGeometry x="760" y="170" width="320" height="300" as="geometry"/></mxCell><mxCell id="p1_P4" value="<b>/nouveau-cas</b><br>ajoute un cas validé (D-048)" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;arcSize=4;verticalAlign=top;spacingTop=6;" vertex="1" parent="1"><mxGeometry x="1120" y="170" width="320" height="300" as="geometry"/></mxCell><mxCell id="p1_lg" value="<b>Légende</b>" style="rounded=0;whiteSpace=wrap;html=1;fillColor=#ffffff;strokeColor=#cccccc;verticalAlign=top;align=left;spacingLeft=8;fontSize=11;" vertex="1" parent="1"><mxGeometry x="1130" y="790" width="330" height="165" as="geometry"/></mxCell><mxCell id="p1_t" value="<b>Processus IA du projet : vue d'ensemble</b><br><font style="font-size:12px">Qui lance quoi, et qui modifie quel bien partagé (au 2026-10-24). Tout est lancé à la main par l'utilisateur.</font>" style="text;html=1;align=left;verticalAlign=top;whiteSpace=wrap;fontSize=18;" vertex="1" parent="1"><mxGeometry x="40" y="20" width="900" height="50" as="geometry"/></mxCell><mxCell id="p1_u" value="<b>Utilisateur (l'expert)</b><br>lance chaque processus, fusionne les branches" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#ffe6cc;strokeColor=#d79b00;arcSize=12;" vertex="1" parent="1"><mxGeometry x="600" y="85" width="280" height="50" as="geometry"/></mxCell><mxCell id="p1_lecteur" value="<b>lecteur</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="55" y="235" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_correcteur" value="<b>correcteur</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="205" y="235" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_optimiseur" value="<b>optimiseur</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="55" y="289" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_P1f" value="Lit : data/ ; au contrôle final, les cas validés.<br>Garde une modification des outils seulement si la relecture est <i>mieux</i>." style="text;html=1;align=left;verticalAlign=top;whiteSpace=wrap;fontSize=11;" vertex="1" parent="1"><mxGeometry x="55" y="360" width="290" height="100" as="geometry"/></mxCell><mxCell id="p1_analyste" value="<b>analyste</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="415" y="235" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_upgrader" value="<b>detectors-upgrader</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="565" y="235" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_validateur" value="<b>detectors-control</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="415" y="289" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_builder" value="<b>builder</b>" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;arcSize=10;" vertex="1" parent="1"><mxGeometry x="565" y="289" width="140" height="44" as="geometry"/></mxCell><mxCell id="p1_P2f" value="Lit : data/ par les outils de lecture ; la base de cas, après sa propre lecture." style="text;html=1;align=left;veLine truncated
|
||||
@@ -900,3 +900,13 @@ Règles du journal :
|
||||
- **Pourquoi** : l'utilisateur, 2026-10-29 : des noms qui disent les responsabilités ; un contrepoids qui empêche de coller les détecteurs au lot courant et de perdre en précision sur les events de la base. Constat (point 52) : le validateur, qui jugeait le lot et la base à la fois et ne renvoyait que pour un défaut net, n'a jamais renvoyé une modification en quatre séances ; à WILDSTRUBEL, il a accepté +1 310 mesures signalées sur E-001 à E-005 sans une juste de plus (« des mesures, pas des événements ») ; sur ces cinq events, la part des mesures signalées qui sont justes est passée de 78 % à 50 % (surtout par D-074, hors de la boucle).
|
||||
- **Options écartées** : un critère sur la seule précision mesure par mesure, au lieu des événements (l'utilisateur : l'alignement n'a pas à être parfait) ; un contrôle qui regarde aussi le lot (il en épouserait le point de vue, ce qu'il doit contrebalancer) ; un garde-fou mécanique par seuil sur le benchmark, sans agent (un seuil sans source).
|
||||
- **Conséquence** : le contrôle peut renvoyer bien plus souvent qu'avant : des séances plus longues, des modifications plus souvent annulées. À observer à la prochaine séance.
|
||||
|
||||
## D-090 — 2026-10-29 — `/boucle` : l'analyste analyse, le `detectors-critic` critique
|
||||
- **Statut** : active. Modifie D-057 (rôles) et D-088 (l'analyste) ; point 53 du plan du journal du matin.
|
||||
- **Décision** :
|
||||
- un agent, une responsabilité (l'utilisateur) : l'analyste produit l'analyse la plus précise du lot, avec tous les outils à sa disposition, les détecteurs compris (une piste à vérifier sur les données, pas une conclusion) : sa lecture, ses étiquettes, les events connus, les nouveautés, dans `analyse.md` ; plus de verdict ni de suggestions. Son skill `critiquer-lot` devient `analyser-lot` (avec `etiquettes.py`) ;
|
||||
- un nouvel agent, `detectors-critic`, juge les détecteurs face à l'analyse, la vérité : la sortie de la commande du lot, le score, le code des détecteurs ; la comparaison événement par événement, le verdict et au plus deux suggestions, dans `critique.md`, le fichier que lit déjà le `detectors-upgrader` ; il ne regarde pas les données : il dit quoi et où, le pourquoi d'un défaut revient au `detectors-upgrader` ;
|
||||
- l'orchestrateur appelle l'analyste, puis le `detectors-critic`, puis la suite inchangée ; le builder lit les nouveautés dans `analyse.md` ; `/new-event` fait faire à l'analyste sa lecture et ses étiquettes sans les détecteurs ni la base (les étiquettes du benchmark ne leur doivent rien).
|
||||
- **Pourquoi** : l'utilisateur, 2026-10-29 : ne pas mêler plusieurs responsabilités dans un agent ; l'analyste servait déjà à la seule lecture (`/new-event`).
|
||||
- **Options écartées** : un seul agent dédié au processus des détecteurs, qui lit puis critique (l'option 1 de l'utilisateur) ; renommer l'analyste en `detectors-…` (son premier travail est les données, et `/new-event` l'appelle sans détecteurs) ; un critic qui regarde les données (il redeviendrait un analyste) ; dire au `detectors-upgrader` de regarder les données pour trouver le pourquoi (l'utilisateur ne sait pas : l'upgrader reste tel quel, ses rendus diront s'il en a besoin).
|
||||
- **Conséquence** : un appel d'agent de plus par séance. Pour une fausse alarme dont l'analyse ne dit rien, la critique dit quoi et où, sans le pourquoi ; le `detectors-upgrader`, qui ne reçoit pas de consigne pour regarder les données, devra le trouver par le code et la sortie des détecteurs : à observer. Les séances d'avant gardent leur `critique.md`, lecture et critique ensemble ; la page de `/review-event` montre les deux fichiers quand ils existent.
|
||||
@@ -106,6 +106,7 @@ Types : **Comprendre** (lire, expliquer, rien ne change), **Décider** (l'utilis
|
||||
| 50 | Une ligne Status : la compilation de tous les détecteurs | Décider, Coder | 47, 49 | ligne Status dans `detecteurs.py` le 2026-10-27, refaite le même jour : ce qui se passe, l'événement qui englobe ; ordre des catégories à confirmer |
|
||||
| 51 | Un analyste qui progresse de séance en séance | Décider | 45, 48 | idée du 2026-10-28 ; compilation dans `events/` (l'utilisateur), la carte apprend à chaque validation (D-087) ; l'analyste consulte la base quand il veut (D-088) ; pas de mesure ; écart E-011 ouvert |
|
||||
| 52 | Un upgrader et un validateur qui ne laissent pas dériver les détecteurs | Essayer | 51 | `detectors-upgrader` et `detectors-control` (D-089, 2026-10-29) ; à essayer sur une séance |
|
||||
| 53 | Un agent, une responsabilité : l'analyste lit, un autre critique les détecteurs | Essayer | 51, 52 | `analyser-lot` et `detectors-critic` (D-090, 2026-10-29) ; à essayer sur une séance |
|
||||
| | **VIII. Suivi du chantier** | | | |
|
||||
| 37 | Ménage : commit, `CLAUDE.md`, Mermaid, sorties | Lancer | — | validé le 2026-10-24 |
|
||||
|
||||
@@ -1136,6 +1137,41 @@ Rapport de l'agent : `vues-deplacements/contexte/donnees-et-boucle.md`. Script :
|
||||
|
||||
**Fini quand.** Une séance de `/boucle` améliore le lot sans abîmer la base d'events.
|
||||
|
||||
### Point 53 : Un agent, une responsabilité
|
||||
|
||||
**L'idée** (l'utilisateur, 2026-10-29). L'analyste mêle deux responsabilités : lire un lot et critiquer les détecteurs. Deux options :
|
||||
1. des agents dédiés à un processus, comme les `detectors-…`, qui suivent une liste de tâches (plusieurs responsabilités) ;
|
||||
2. des agents plus généraux, une seule responsabilité chacun : l'analyste lit une plage de données, et seulement ça ; la critique des détecteurs est une autre tâche.
|
||||
|
||||
**Avis de Claude (2026-10-29) : l'option 2 pour l'analyste, l'option 1 garde son sens pour le processus des détecteurs.**
|
||||
- L'analyste sert déjà à la seule lecture : `/new-event` l'appelle pour les étiquettes d'un event, étape 1 seulement, sans détecteurs.
|
||||
- Séparer rend la règle « ta lecture avant les détecteurs » structurelle : l'analyste ne voit jamais les détecteurs.
|
||||
- La critique devient un `detectors-critic` : `detectors-critic` → `detectors-upgrader` → `detectors-control`, chacun une responsabilité dans le processus des détecteurs. Il lit la lecture de l'analyste (son tableau, ses étiquettes) et la sortie des détecteurs, compare et rend au plus deux suggestions ; les nouveautés et les events connus restent à l'analyste (ils parlent des données).
|
||||
- Le prix : le critique ne voit pas les données. Un événement juste des détecteurs, absent de la lecture, ne peut plus être vérifié et ajouté aux étiquettes (`"apres_detecteurs"`, étape 3 de `critiquer-lot`) : l'analyste est la vérité, ce qu'il n'a pas vu compte « en trop ». Un appel d'agent de plus par séance.
|
||||
|
||||
**Questions à l'utilisateur.**
|
||||
1. L'option 2 pour l'analyste, avec un `detectors-critic` ?
|
||||
|
||||
**Réponse de l'utilisateur (2026-10-29).** Oui pour un nouvel agent `detectors-critic` ; l'analyste garde son nom. Son travail : produire l'analyse la plus précise, avec tous les outils à sa disposition, les détecteurs compris (le « prix » noté plus haut tombe : il peut encore vérifier et ajouter un événement que les détecteurs ont trouvé).
|
||||
|
||||
**Proposition de Claude (2026-10-29), à valider.**
|
||||
- L'analyste : sa lecture (tableau des moments), ses étiquettes, les events connus et les nouveautés, dans `analyse.md` ; plus de verdict ni de suggestions.
|
||||
- Le `detectors-critic` : l'analyse et la sortie des détecteurs (commande du lot, score) ; la comparaison événement par événement, le verdict, au plus deux suggestions, dans `critique.md` (le chemin que lit déjà le `detectors-upgrader`) ; sans regarder les données (à confirmer).
|
||||
- L'orchestrateur : analyste, puis `detectors-critic`, puis la suite inchangée ; le builder lit les nouveautés dans `analyse.md`.
|
||||
|
||||
**Le critic sans les données ? (question de l'utilisateur, avis de Claude, 2026-10-29).** Sur la dernière critique (NIEDERHORN, lot 01) :
|
||||
- S1, un saut durable manqué : tout vient de la ligne de la lecture (instant, capteur, ampleur en bruits, niveaux des nuits, voisines) : faisable sans les données.
|
||||
- S2, un saut bref signalé en trop au sommet de la vague thermique : la critique sait qu'il est en trop, mais le pourquoi (une mesure manquante au sommet de la vague, la caméra qui tourne au même pas) vient d'un regard sur les données à cet instant, que la lecture ne décrit pas (rien n'y est anormal).
|
||||
- Proposition : le critic dit quoi et où (le défaut, l'exemple, le détecteur en cause, en lisant son code), sans les données ; le pourquoi d'une fausse alarme, et la règle qui la corrige, reviennent au `detectors-upgrader`, qui a les données et le code.
|
||||
- Correction (question de l'utilisateur) : le `detectors-upgrader` a les données de fait (le dossier de station dans sa demande, Bash, la commande du lot qui les lit), mais sa consigne ne lui dit pas de les regarder ni avec quoi, et aucune des six modifications passées ne s'est servie des outils de lecture. Il faudrait lui ajouter : pour comprendre un défaut, regarder les données aux instants en cause avec les outils de `lire-les-donnees`.
|
||||
|
||||
**Fait le 2026-10-29 (D-090).** L'utilisateur : le `detectors-upgrader` reste tel quel (il ne sait pas s'il doit regarder les données) ; ajouter le `detectors-critic`. Skill `critiquer-lot` renommé `analyser-lot` et recentré sur l'analyse ; agent `detectors-critic` ; `/boucle` (étape 2), builder, revue et page de `/review-event`, `/new-event`, `score.py` (import), anonymiseur (texte d'`etiquetage.md`), spec de la boucle, `CLAUDE.md`, `run.md`, docs de `vues-deplacements/`, schéma des pipelines (retouché seulement : il parle encore de branche de séance et de cas).
|
||||
|
||||
**Étapes.**
|
||||
- [x] Les réponses de l'utilisateur (2026-10-29).
|
||||
- [x] L'analyste recentré, le `detectors-critic` ajouté (2026-10-29, D-090).
|
||||
- [ ] Une séance de `/boucle` qui les essaie : la critique sans les données suffit-elle au `detectors-upgrader` ?
|
||||
|
||||
---
|
||||
|
||||
## Partie VII — Idées gardées pour plus tard
|
||||
@@ -1348,3 +1384,7 @@ Une ligne par séance : date, point(s) traités, ce qui a changé, ce qui reste.
|
||||
- 2026-10-29 : point 52, précisions de l'utilisateur : `detectors-upgrader`, qui ajoute, retire ou modifie ; il vise les événements significatifs manqués ou mal bornés, pas l'alignement parfait ; le validateur, contrepoids contre le sur-apprentissage.
|
||||
- 2026-10-29 : point 52, l'utilisateur : `control-detectors` (le validateur), garde-fou sur la base seule, sans les données du lot, qui décide et renvoie ses remarques à l'upgrader.
|
||||
- 2026-10-29 : point 52, D-089 : `detectors-upgrader` (ajoute, retire, modifie ; vise les événements manqués ou mal bornés) et `detectors-control` (garde-fou sur la base seule, sans le lot) ; à essayer sur une séance.
|
||||
- 2026-10-29 : point 53 ajouté (idée de l'utilisateur : un agent, une responsabilité ; deux options) ; avis de Claude : l'analyste lit seulement, un `detectors-critic` critique.
|
||||
- 2026-10-29 : point 53, l'utilisateur : un nouvel agent `detectors-critic`, l'analyste garde son nom et peut se servir des détecteurs ; proposition de Claude pour le partage des tâches.
|
||||
- 2026-10-29 : point 53, le critic sans les données : faisable pour un événement manqué ou mal borné, pas pour le pourquoi d'une fausse alarme ; proposition : le critic dit quoi et où, l'upgrader cherche pourquoi.
|
||||
- 2026-10-29 : point 53, D-090 : l'analyste analyse (skill `analyser-lot`), le `detectors-critic` critique sans les données ; le `detectors-upgrader` reste tel quel ; à essayer sur une séance.
|
||||
@@ -73,7 +73,7 @@ Dans une session Claude Code neuve, **en mode auto**, à la racine de Support-Ag
|
||||
- `<DEBUT>`, `<FIN>` : jours UTC, `AAAA-MM-JJ`, `<FIN>` exclu (la plage s'arrête à `<FIN>` 00:00). La plage est le lot, sans découpe : sa longueur se choisit par les dates (4 jours : `--du 2026-09-01 --au 2026-09-05`), D-072.
|
||||
- Sans `--du` ni `--au` : toute la période du dossier, en un lot. Le lot est classé avec ses 3 jours d'avant : les pomper aussi.
|
||||
- Le modèle et l'effort choisis pour la session valent pour tous ses agents (D-063).
|
||||
- La séance tourne seule, sans question, à lancer sur `master`, où elle commite directement (D-070), un commit par étape : analyste, detectors-upgrader et detectors-control si l'analyste a des suggestions, builder s'il y a des nouveautés, puis le releveur, qui note les difficultés dans `docs/ameliorations-processus.md` (rien à demander). Avec `--ameliorer`, l'améliorateur corrige ensuite le skill `/boucle` et ses agents d'après ces relevés et marque les entrées **traité** ; ce qui sort de son périmètre (outils de lecture, détecteurs) ou change ce que fait la boucle reste à traiter à la main (D-071). Les fichiers modifiés et non commités restent sans être commités.
|
||||
- La séance tourne seule, sans question, à lancer sur `master`, où elle commite directement (D-070), un commit par étape : analyste, detectors-critic, puis detectors-upgrader et detectors-control si la critique a des suggestions, builder s'il y a des nouveautés, puis le releveur, qui note les difficultés dans `docs/ameliorations-processus.md` (rien à demander). Avec `--ameliorer`, l'améliorateur corrige ensuite le skill `/boucle` et ses agents d'après ces relevés et marque les entrées **traité** ; ce qui sort de son périmètre (outils de lecture, détecteurs) ou change ce que fait la boucle reste à traiter à la main (D-071). Les fichiers modifiés et non commités restent sans être commités.
|
||||
- Bilan dans `boucle/<séance>_<SERIE>/bilan.md` ; les étiquettes de l'analyste (`lot-*/etiquettes.json`) sont à garder même si on annule une modification. Ensuite : `git revert` des commits de la séance qu'on ne garde pas (la base de la séance est dans le bilan).
|
||||
- À la fin, la page `out/boucle_<séance>_<SERIE>.html` s'ouvre (D-066) : la page de `detecteurs.py` (ci-dessous) sur la plage, images et timelapse compris ; dessous les courbes, catégorie par catégorie, l'analyste (bleu) face aux détecteurs (orange) ; le score de la séance et le benchmark.
|
||||
- Le benchmark (D-069) : les détecteurs face au diagnostic gardé dans chaque event de la base (`events/E-*/etiquettes.json`), lancé au début de chaque lot, après chaque modification et en fin de séance ; chaque passage s'ajoute à `vues-deplacements/benchmark/historique.csv`, avec la version des détecteurs.
|
||||
|
||||
@@ -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