diff --git a/.claude/agents/ameliorateur.md b/.claude/agents/ameliorateur.md index f75966e..58e6ae6 100644 --- a/.claude/agents/ameliorateur.md +++ b/.claude/agents/ameliorateur.md @@ -16,14 +16,14 @@ Le processus (`/boucle` ou `/aiguiser`) et le commit du releveur : `git show events/E-xxx/ --du --au --etiquettes /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 events/E-xxx/ --du --au --etiquettes /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 , séance , non revalidé par l'expert`, `` é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 ; diff --git a/.claude/agents/detectors-critic.md b/.claude/agents/detectors-critic.md new file mode 100644 index 0000000..55fc6fd --- /dev/null +++ b/.claude/agents/detectors-critic.md @@ -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 ` : 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, , → (UTC) + +**Verdict** : d'accord | suggestions + +## 1. L'analyse + + +## 2. Ce qu'ont trouvé les détecteurs + + +## 3. Comparaison +| Événement ou moment | Jugement | Pourquoi | + +## 4. Score + + +## 5. Suggestions +### S1 : +- **Défaut** : … +- **Exemple** : … +- **Détecteur** : … +- **Ce qu'il faudrait** : … + +## Difficultés +aucune | - + +## 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. diff --git a/.claude/agents/detectors-upgrader.md b/.claude/agents/detectors-upgrader.md index 1283d2c..6b90ac9 100644 --- a/.claude/agents/detectors-upgrader.md +++ b/.claude/agents/detectors-upgrader.md @@ -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 diff --git a/.claude/agents/revue.md b/.claude/agents/revue.md index 17141b3..a912f8c 100644 --- a/.claude/agents/revue.md +++ b/.claude/agents/revue.md @@ -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 `,,E-xxx` de `.claude/skills/anonymize-event/registre.csv` ; les vrais noms des capteurs cités : les lignes `,,` 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/_/` ; 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/_/` ; 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/ --du --au --sans-ouvrir` (la page des détecteurs ne s'ouvre pas : l'utilisateur la retrouve dans la page de revue) (sans `data//`, 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 --au ` (mêmes dates qu'en 4). @@ -23,7 +23,7 @@ Un event `E-xxx`, et l'une de ces trois consignes : ### « corriger : » -- 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). diff --git a/.claude/skills/critiquer-lot/SKILL.md b/.claude/skills/analyser-lot/SKILL.md similarity index 50% rename from .claude/skills/critiquer-lot/SKILL.md rename to .claude/skills/analyser-lot/SKILL.md index 73d4a40..8df5ed7 100644 --- a/.claude/skills/critiquer-lot/SKILL.md +++ b/.claude/skills/analyser-lot/SKILL.md @@ -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: " [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 --du --au `), le chemin de ta critique. Le dossier de ta critique est `` 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 --du --au `), le chemin de ton analyse. Le dossier de ton analyse est `` 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 ` 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 /etiquettes.json`. N'écris aucun autre script. +Ceux de `lire-les-donnees`, avec `--debut` et `--fin` du lot et `--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 /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 : , → (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 - - -## 3. Comparaison -| Événement ou moment | Jugement | Pourquoi | - -## 4. Events connus - -## 5. Suggestions -### S1 : -- **Défaut** : … -- **Exemple** : … -- **Détecteur** : … -- **Ce qu'il faudrait** : … +## 2. Events connus ## Nouveautés aucune | - @@ -71,7 +55,7 @@ aucune | - /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 - python3 .claude/skills/critiquer-lot/etiquettes.py --test +Usage : python3 .claude/skills/analyser-lot/etiquettes.py + python3 .claude/skills/analyser-lot/etiquettes.py --test """ import json import os diff --git a/.claude/skills/anonymize-event/anonymiser.py b/.claude/skills/anonymize-event/anonymiser.py index 70d0f02..0a21d13 100644 --- a/.claude/skills/anonymize-event/anonymiser.py +++ b/.claude/skills/anonymize-event/anonymiser.py @@ -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 |", "|---|---|---|---|---|---|---|"] diff --git a/.claude/skills/boucle/SKILL.md b/.claude/skills/boucle/SKILL.md index b96a77b..014297f 100644 --- a/.claude/skills/boucle/SKILL.md +++ b/.claude/skills/boucle/SKILL.md @@ -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/ [--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\*\* :' `. Chaque commit se fait par chemin, `git add && git commit -m "" -- `, 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 `. -1. **Analyste** (`analyste`) : `Dossier : . Lot NN : → (UTC). Commande du lot : . Écris /critique.md.` - `python3 .claude/skills/critiquer-lot/etiquettes.py /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 : . Lot NN : → (UTC). Commande du lot : . Écris /analyse.md.` + `python3 .claude/skills/analyser-lot/etiquettes.py /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 > /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 --etape "lot-NN avant" > /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 `/ vues-deplacements/benchmark/historique.csv`, message `Loop lot NN: critique ()`. -2. Verdict `d'accord` : va à l'étape 5. + Commit `/ vues-deplacements/benchmark/historique.csv`, message `Loop lot NN: analysis`. +2. **Detectors-critic** (`detectors-critic`), qui juge les détecteurs face à l'analyse, sans regarder les données (D-090) : `Dossier : . Lot NN : → (UTC). Commande du lot : . Analyse : /analyse.md. Score avant : /score-avant.txt. Écris /critique.md.` + Commit `/`, message `Loop lot NN: critique ()`. + 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 : . Lot NN : → (UTC). Commande du lot : . Critique : /critique.md. Score avant : /score-avant.txt. Benchmark avant : /benchmark-avant.txt. [Contrôle précédent : /validation-(K-1).md.] Passage K. Écris /modification-K.md.` Commit `detectors/ vues-deplacements/contexte/seuils-du-journal.md /`, message `Loop 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__.html`, l'analyste face aux détecteurs sur toute la plage (D-066) ; la refaire : `python3 .claude/skills/boucle/comparaison.py `. -| 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 `/bilan.md /score-fin.txt /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 : / : la section « Difficultés » de chaque rendu des lots, et « Erreurs » du bilan. Difficultés de l'orchestrateur : aucune | .` (D-060) Si `git status --short docs/ameliorations-processus.md` montre un changement : commit de ce chemin, message `Loop : process difficulties`. -**Améliorateur** (`ameliorateur`), seulement avec `--ameliorer` et si le releveur a commité : `Processus : /boucle. Commit du releveur : .`, 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 : 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 : .`, 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 : process fixes`. Garde la suite de ce skill telle que tu l'as lue au début. ## 7. Réponse finale diff --git a/.claude/skills/boucle/score.py b/.claude/skills/boucle/score.py index 1b28f90..dd06833 100644 --- a/.claude/skills/boucle/score.py +++ b/.claude/skills/boucle/score.py @@ -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 diff --git a/.claude/skills/lire-les-donnees/SKILL.md b/.claude/skills/lire-les-donnees/SKILL.md index 8c5e426..53a1e0e 100644 --- a/.claude/skills/lire-les-donnees/SKILL.md +++ b/.claude/skills/lire-les-donnees/SKILL.md @@ -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 diff --git a/.claude/skills/new-event/SKILL.md b/.claude/skills/new-event/SKILL.md index ec05fea..97fd985 100644 --- a/.claude/skills/new-event/SKILL.md +++ b/.claude/skills/new-event/SKILL.md @@ -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> | | | | |`, 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 (`` : 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 : . 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 (`` : 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 : . 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. diff --git a/.claude/skills/read-event/SKILL.md b/.claude/skills/read-event/SKILL.md index a5d719f..591054a 100644 --- a/.claude/skills/read-event/SKILL.md +++ b/.claude/skills/read-event/SKILL.md @@ -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 diff --git a/.claude/skills/review-event/SKILL.md b/.claude/skills/review-event/SKILL.md index f74674d..7485a8e 100644 --- a/.claude/skills/review-event/SKILL.md +++ b/.claude/skills/review-event/SKILL.md @@ -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 : `. 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. diff --git a/.claude/skills/review-event/page.py b/.claude/skills/review-event/page.py index c69ce81..62244a7 100644 --- a/.claude/skills/review-event/page.py +++ b/.claude/skills/review-event/page.py @@ -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//, 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) diff --git a/CLAUDE.md b/CLAUDE.md index 5009b4c..5f61814 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -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 '^#' `), 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`. diff --git a/docs/agents/pipelines-ia.drawio b/docs/agents/pipelines-ia.drawio index fe27bfe..28ea1d0 100644 --- a/docs/agents/pipelines-ia.drawio +++ b/docs/agents/pipelines-ia.drawio @@ -1 +1 @@ - \ No newline at end of file + \ No newline at end of file diff --git a/docs/decisions.md b/docs/decisions.md index f27fc41..5373777 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -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. diff --git a/docs/superpowers/plans/2026-10-23-journal-du-matin.md b/docs/superpowers/plans/2026-10-23-journal-du-matin.md index ac439f1..80c2324 100644 --- a/docs/superpowers/plans/2026-10-23-journal-du-matin.md +++ b/docs/superpowers/plans/2026-10-23-journal-du-matin.md @@ -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. diff --git a/run.md b/run.md index a4c617b..d6fa7bd 100644 --- a/run.md +++ b/run.md @@ -73,7 +73,7 @@ Dans une session Claude Code neuve, **en mode auto**, à la racine de Support-Ag - ``, `` : jours UTC, `AAAA-MM-JJ`, `` exclu (la plage s'arrête à `` 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/_/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__.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. diff --git a/vues-deplacements/CLAUDE.md b/vues-deplacements/CLAUDE.md index c97fcfa..2c0f230 100644 --- a/vues-deplacements/CLAUDE.md +++ b/vues-deplacements/CLAUDE.md @@ -22,7 +22,7 @@ Détection mécanique des anomalies (D-055) : faire ressortir les courbes qui co Journal du matin du client (D-056), le cap actuel : onglet `Journal` de la maquette ; un détecteur élémentaire par fichier dans `detectors/` (`detect(mesures)` -> épisodes `start`, `end`, `kind`, `label`, `text`, `ignore`, `sensors`), chargés et classés en événements des douze catégories du journal (D-074) par `detectors/categories.py` (`python3 detectors/categories.py ` : 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 [--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/_/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_.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 [--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/_/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_.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 [--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/_/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`. diff --git a/vues-deplacements/contexte/aiguiser-la-lecture.md b/vues-deplacements/contexte/aiguiser-la-lecture.md index 5eda35d..4ced0ce 100644 --- a/vues-deplacements/contexte/aiguiser-la-lecture.md +++ b/vues-deplacements/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`. diff --git a/vues-deplacements/contexte/boucle-automatique.md b/vues-deplacements/contexte/boucle-automatique.md index 948d135..730356d 100644 --- a/vues-deplacements/contexte/boucle-automatique.md +++ b/vues-deplacements/contexte/boucle-automatique.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/_/` (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 [--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/` 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 : 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 : process fixes`). ## 6. Ce que l'utilisateur trouve à la fin