From 79d83be3ffffb430fc398b7926be4af512647b7e Mon Sep 17 00:00:00 2001 From: maxime Date: Thu, 29 Oct 2026 10:17:54 +0100 Subject: [PATCH] Loop: the builder becomes the event-builder, called every batch (D-091) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - event-builder: called at every batch, reads the whole analysis and decides on its own, against the event base, what is new; an event keeps the bounds of the event, not of the batch (plus 6 h). - the "Nouveautés" section leaves the analysis and the upgrader's output; the summary lists contradictions with the base. Co-Authored-By: Claude Opus 5.5 --- .claude/agents/ameliorateur.md | 2 +- .claude/agents/analyste.md | 2 +- .claude/agents/builder.md | 51 ------------------ .claude/agents/detectors-upgrader.md | 3 -- .claude/agents/event-builder.md | 53 +++++++++++++++++++ .claude/agents/revue.md | 2 +- .claude/skills/analyser-lot/SKILL.md | 14 ++--- .claude/skills/anonymize-event/SKILL.md | 2 +- .claude/skills/boucle/SKILL.md | 12 ++--- .claude/skills/read-event/SKILL.md | 2 +- .claude/skills/review-event/SKILL.md | 4 +- .claude/skills/review-event/page.py | 6 +-- CLAUDE.md | 6 +-- docs/agents/agent-diagnostic.md | 2 +- docs/agents/pipelines-ia.drawio | 2 +- docs/decisions.md | 11 ++++ .../plans/2026-10-23-journal-du-matin.md | 25 +++++++++ run.md | 2 +- vues-deplacements/CLAUDE.md | 2 +- .../contexte/boucle-automatique.md | 24 ++++----- 20 files changed, 129 insertions(+), 98 deletions(-) delete mode 100644 .claude/agents/builder.md create mode 100644 .claude/agents/event-builder.md diff --git a/.claude/agents/ameliorateur.md b/.claude/agents/ameliorateur.md index 58e6ae6..7bd2898 100644 --- a/.claude/agents/ameliorateur.md +++ b/.claude/agents/ameliorateur.md @@ -23,7 +23,7 @@ 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 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 ; - - **ligne d'index**, au format des autres ; sa Signature vise environ 250 caractères, une indication et non une limite : le détail va dans la fiche (D-085) ; son Verdict commence par `(appris)`. -4. La classification et la cause se rangent dans les listes fermées du §11.3 ; ce que les données ne tranchent pas se dit (« déduite », « inconnue »). Un fait que les listes ne prévoient pas (un fait de configuration, par exemple) prend la plus proche, souvent « problème système » et « inconnue », précisée d'un mot entre parenthèses et d'une phrase dans la fiche. - -## Règles - -- Ne modifie jamais un event existant, ni `agent-diagnostic/instructions.md`, ni rien hors de tes nouveaux dossiers d'events, de l'index et de ton rendu (le registre `registre.csv` grandit tout seul par `anonymiser.py`). -- Ne passe pas par `/new-event` : pas de passage à l'aveugle, pas de validation par l'utilisateur ; les events appris s'ajoutent sans attendre : l'utilisateur les revoit ensuite avec `/review-event`, qui cherche la phrase exacte `non revalidé par l'expert` de l'en-tête (D-075). -- Aucun nom réel de station ou de capteur ne reste dans un cas (l'étape 3 d'`anonymize-event` le vérifie) ; aucun identifiant (`SIM_CCID`, `ip`). -- Ne commite pas : l'orchestrateur le fait. - -## Ton rendu, `builder.md` - -```markdown -# Lot NN : builder - -**Events créés** : E-006, E-007 | aucun - -- : créée (E-006) | déjà connue (E-00x) - -## Difficultés -aucune | - -``` - -« Difficultés » ne parle que du processus (consignes, chemins, outils), pas des données : un releveur les note pour l'utilisateur (D-060). - -## Ta réponse - -En 2 lignes : les events créés, le chemin du rendu. diff --git a/.claude/agents/detectors-upgrader.md b/.claude/agents/detectors-upgrader.md index 6b90ac9..025582c 100644 --- a/.claude/agents/detectors-upgrader.md +++ b/.claude/agents/detectors-upgrader.md @@ -76,9 +76,6 @@ Puis le **benchmark**, `python3 .claude/skills/boucle/benchmark.py 2>&1` (sans ` ## Pas corrigé aucune | -## Nouveautés -aucune | - - ## Difficultés aucune | - ``` diff --git a/.claude/agents/event-builder.md b/.claude/agents/event-builder.md new file mode 100644 index 0000000..69d2a50 --- /dev/null +++ b/.claude/agents/event-builder.md @@ -0,0 +1,53 @@ +--- +name: event-builder +description: Event-builder de la boucle automatique (/boucle) — à chaque lot, lit l'analyse de l'analyste, décide face à la base d'events ce qu'elle apprend de nouveau, et en fait des events « appris » (events/), bornés à l'événement. Appelé par l'orchestrateur avec le dossier de station, le lot, l'analyse, le dossier du lot et celui de la séance. +tools: Read, Bash, Write, Edit +model: inherit +--- + +Tu es l'event-builder de la boucle automatique : tu construis la base de connaissances. L'analyste a lu un lot en expert ; son analyse est la vérité. C'est à toi de décider, face à la base d'events, ce que ce lot lui apprend de nouveau, et d'en faire des events, de la même forme que ceux de la base. L'expert les revoit ensuite avec `/review-event`. + +## Ta demande + +Le dossier de station, le lot (UTC), l'analyse (`analyse.md` ; à côté, ses étiquettes `etiquettes.json` et ses figures), le dossier du lot, le dossier de la séance, le chemin de ton rendu `builder.md`. + +## Ce que tu fais + +1. Lis l'analyse : chaque moment de sa lecture, ses étiquettes, ses figures, et les events connus qu'elle cite. +2. Consulte la base comme le dit `.claude/skills/read-event/SKILL.md` (la carte et l'index, puis les fiches des events proches, au besoin leurs données). Pour chaque moment de l'analyse, décide s'il apprend à la base quelque chose qu'elle ne connaît pas : c'est ta responsabilité, à ton jugement. Ce que la base connaît se juge sur ses events, qui ont leurs données : un événement que la carte décrit sans event (« hypothétique ») n'est pas connu, et son premier exemple réel peut devenir un event. Un moment qui contredit le diagnostic d'un event (un même état étiqueté autrement) ne donne pas d'event : tu le notes, avec la contradiction en une phrase, pour l'utilisateur. +3. Pour chaque event à créer : + - **bornes** : celles de l'événement, pas celles du lot (l'utilisateur) : le lot peut couvrir des jours, l'event ne garde que le moment où l'événement se produit. Pars des bornes du moment dans l'analyse (première et dernière mesure touchées), vérifie-les sur les données avec les outils de `lire-les-donnees`, puis ajoute une marge de 6 h de part et d'autre, pour voir le niveau habituel avant et le retour après. Un état qui couvre tout le lot (permanent) se copie sur un moment qui le montre (celui que cite l'analyse) ± 6 h, pas des centaines d'images ; la fiche donne les deux plages, la copiée et celle de l'événement. Cette fenêtre vaut pour tout l'event : données, étiquettes, figures, commandes de la signature ; + - **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 events/E-xxx/ --du --au --etiquettes /etiquettes.json` (instants `AAAA-MM-JJTHH:MMZ`) ; 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 ; + - **ligne d'index**, au format des autres ; sa Signature vise environ 250 caractères, une indication et non une limite : le détail va dans la fiche (D-085) ; son Verdict commence par `(appris)`. +4. La classification et la cause se rangent dans les listes fermées du §11.3 ; ce que les données ne tranchent pas se dit (« déduite », « inconnue »). Un fait que les listes ne prévoient pas (un fait de configuration, par exemple) prend la plus proche, souvent « problème système » et « inconnue », précisée d'un mot entre parenthèses et d'une phrase dans la fiche. + +## Règles + +- Ne modifie jamais un event existant, ni la carte des événements, ni `agent-diagnostic/instructions.md`, ni rien hors de tes nouveaux dossiers d'events, de l'index et de ton rendu (le registre `registre.csv` grandit tout seul par `anonymiser.py`). +- Ne passe pas par `/new-event` : pas de passage à l'aveugle, pas de validation par l'utilisateur ; les events appris s'ajoutent sans attendre : l'utilisateur les revoit ensuite avec `/review-event`, qui cherche la phrase exacte `non revalidé par l'expert` de l'en-tête (D-075). +- Aucun nom réel de station ou de capteur ne reste dans un event (l'étape 3 d'`anonymize-event` le vérifie) ; aucun identifiant (`SIM_CCID`, `ip`). +- Ne commite pas : l'orchestrateur le fait. + +## Ton rendu, `builder.md` + +```markdown +# Lot NN : event-builder + +**Events créés** : E-015, E-016 | aucun + +- : créé (E-015), fenêtre +- : contredit E-00x : + +## Difficultés +aucune | - +``` + +La ligne « Events créés » est lue telle quelle par l'orchestrateur et par `/review-event`. Les moments que la base connaît déjà ne sont pas listés. « Difficultés » ne parle que du processus (consignes, chemins, outils), pas des données : un releveur les note pour l'utilisateur (D-060). + +## Ta réponse + +En 2 lignes : les events créés, le chemin du rendu. diff --git a/.claude/agents/revue.md b/.claude/agents/revue.md index a912f8c..86b005b 100644 --- a/.claude/agents/revue.md +++ b/.claude/agents/revue.md @@ -5,7 +5,7 @@ tools: Read, Bash, Write, Edit model: inherit --- -Tu es l'agent de revue. Le builder de `/boucle` a ajouté un event à la base sans l'avis de l'expert (en-tête `non revalidé par l'expert`). L'expert, c'est l'utilisateur : tu lui présentes l'event pour qu'il le valide ou le corrige. Tu ne lui parles pas directement : ta présentation va dans une page web, avec la page des détecteurs, la fiche, la critique du lot et toutes les figures ; l'orchestrateur lui pose la question et te renvoie sa réponse. +Tu es l'agent de revue. L'event-builder de `/boucle` a ajouté un event à la base sans l'avis de l'expert (en-tête `non revalidé par l'expert`). L'expert, c'est l'utilisateur : tu lui présentes l'event pour qu'il le valide ou le corrige. Tu ne lui parles pas directement : ta présentation va dans une page web, avec la page des détecteurs, la fiche, la critique du lot et toutes les figures ; l'orchestrateur lui pose la question et te renvoie sa réponse. ## Ta demande diff --git a/.claude/skills/analyser-lot/SKILL.md b/.claude/skills/analyser-lot/SKILL.md index 8df5ed7..90e702c 100644 --- a/.claude/skills/analyser-lot/SKILL.md +++ b/.claude/skills/analyser-lot/SKILL.md @@ -1,12 +1,12 @@ --- 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. +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. 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]" --- # Analyser un lot -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. +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 l'`event-builder` y cherche ce qui est nouveau pour la base d'events. Tu ne juges pas les détecteurs. Tu ne modifies rien d'autre que ton fichier, tes étiquettes et tes figures. ## La demande @@ -32,11 +32,10 @@ Ceux de `lire-les-donnees`, avec `--debut` et `--fin` du lot et `--sortie , → (UTC) @@ -46,16 +45,13 @@ Ceux de `lire-les-donnees`, avec `--debut` et `--fin` du lot et `--sortie - ## Difficultés aucune | - ## Sources lues ``` -« 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. +« Ce que je vois » porte ce qu'un autre doit savoir pour juger les détecteurs sans voir les données, ou pour en faire un event : 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 @@ -79,4 +75,4 @@ aucune | - / events/E-xxx/" L'agent lit la base d'events. Un nom de site ou de capteur l'ancrerait sur le nom plutôt que sur la signature (D-049). La station prend donc le numéro de l'event (`E-001`), une référence devient `R1`, une cible `C1`, numérotées par station. L'event porte ses données, déjà codées (D-050). Le registre `registre.csv`, à côté de ce fichier, garde les codes des capteurs d'un event à l'autre et la station de chaque event. -1. **Données** : `python3 .claude/skills/anonymize-event/anonymiser.py data// events/E-xxx/` copie `displacement/`, `camera/` (poses de la caméra, dossier pompé) et `images/` dans le dossier de l'event, noms codés dans les CSV et les noms de fichiers, et imprime `NOM → CODE`. Un capteur inconnu reçoit le code suivant et entre dans le registre. Avec `--du T --au T` (`2026-10-07T12:00Z`), seules les mesures et les images de [du, au) sont copiées (un CSV sans mesure dans la fenêtre ne l'est pas) ; avec `--etiquettes /etiquettes.json` en plus, les moments de l'analyste dans la fenêtre, bornés et codés, deviennent `etiquettes.json` de l'event, et `etiquetage.md` dit d'où elles viennent (D-069, le builder de `/boucle`) : pour un event pris dans un long export (le builder de `/boucle`), la fenêtre de l'événement et sa marge, pas des centaines d'images ; repasse la même fenêtre aux étapes suivantes. +1. **Données** : `python3 .claude/skills/anonymize-event/anonymiser.py data// events/E-xxx/` copie `displacement/`, `camera/` (poses de la caméra, dossier pompé) et `images/` dans le dossier de l'event, noms codés dans les CSV et les noms de fichiers, et imprime `NOM → CODE`. Un capteur inconnu reçoit le code suivant et entre dans le registre. Avec `--du T --au T` (`2026-10-07T12:00Z`), seules les mesures et les images de [du, au) sont copiées (un CSV sans mesure dans la fenêtre ne l'est pas) ; avec `--etiquettes /etiquettes.json` en plus, les moments de l'analyste dans la fenêtre, bornés et codés, deviennent `etiquettes.json` de l'event, et `etiquetage.md` dit d'où elles viennent (D-069, l'event-builder de `/boucle`) : pour un event pris dans un long export (le builder de `/boucle`), la fenêtre de l'événement et sa marge, pas des centaines d'images ; repasse la même fenêtre aux étapes suivantes. 2. **Figures** : fais chaque figure de l'event avec sa commande (`graphique.py`, `vignettes.py`) sur `events/E-xxx/`, avec `--sortie events/E-xxx/` : titres, légendes et noms de fichiers sont codés d'emblée. Dans la fiche, cite le fichier qu'elle imprime. 3. **Textes** : une fois la fiche et la ligne d'index écrites, relance la commande de l'étape 1 : - dans les `.md` de l'event et `events/INDEX.md`, `data//` devient `events/E-xxx/` et chaque nom son code ; diff --git a/.claude/skills/boucle/SKILL.md b/.claude/skills/boucle/SKILL.md index 014297f..2c36d4c 100644 --- a/.claude/skills/boucle/SKILL.md +++ b/.claude/skills/boucle/SKILL.md @@ -1,6 +1,6 @@ --- 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-critic, 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, event-builder. Lancé par l'utilisateur seulement, avec /boucle. disable-model-invocation: true argument-hint: "data/ [--du AAAA-MM-JJ] [--au AAAA-MM-JJ] [--ameliorer]" --- @@ -44,8 +44,8 @@ Chaque agent est appelé par l'outil Agent avec son `subagent_type` et la demand - `accepté` ou `garder` : va à l'étape 5. - `à reprendre` : retour à l'étape 3, passage K + 1. - `annuler` : `git checkout -- detectors/ vues-deplacements/contexte/seuils-du-journal.md`, commit de ces deux chemins, message `Loop lot NN: modification annulée`. -5. **Builder** (`builder`), seulement si l'un des rendus du lot a, sous `## Nouveautés`, autre chose que `aucune` : `Dossier : . Lot NN : → (UTC). Dossier du lot : /. Séance : /. Écris /builder.md.` - Si sa ligne `**Events créés** :` n'est pas `aucun` : commit `events/ .claude/skills/anonymize-event/registre.csv /`, message `Loop lot NN: events E-xxx, …` ; sinon commit `/`, message `Loop lot NN: builder (aucun event)`. +5. **Event-builder** (`event-builder`), à chaque lot : il décide seul, face à la base d'events, ce que l'analyse lui apprend de nouveau (D-091) : `Dossier : . Lot NN : → (UTC). Analyse : /analyse.md. Dossier du lot : /. Séance : /. Écris /builder.md.` + Si sa ligne `**Events créés** :` n'est pas `aucun` : commit `events/ .claude/skills/anonymize-event/registre.csv /`, message `Loop lot NN: events E-xxx, …` ; sinon commit `/`, message `Loop lot NN: event-builder (aucun event)`. L'analyste ne relit pas les lots des séances d'avant ; le score les rejoue, sur leurs étiquettes, et le benchmark rejoue les events de la base, les events créés au lot compris (leur `etiquettes.json`). @@ -78,8 +78,8 @@ Page : `out/boucle__.html`, l'analyste face aux détecteurs sur ## Suggestions non traitées <« Pas corrigé » des modifications ; suggestions d'un lot sans modification gardée> -## Nouveautés déjà connues - +## Contradictions avec la base + ## Erreurs aucune | @@ -92,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/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. +**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/event-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/read-event/SKILL.md b/.claude/skills/read-event/SKILL.md index 591054a..b1b9ec1 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 (analyser-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 l'event-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 7485a8e..b20159f 100644 --- a/.claude/skills/review-event/SKILL.md +++ b/.claude/skills/review-event/SKILL.md @@ -7,7 +7,7 @@ argument-hint: "[E-xxx ...]" # Revue des events appris -Le builder de `/boucle` ajoute des events sans l'avis de l'expert (D-057). L'expert, c'est l'utilisateur : chaque event qu'il n'a pas validé passe par cette revue. Tu es l'orchestrateur : l'agent `revue` présente et modifie, toi tu relaies, poses la question et commites. **Tu ne juges pas l'event toi-même.** +L'event-builder de `/boucle` ajoute des events sans l'avis de l'expert (D-057). L'expert, c'est l'utilisateur : chaque event qu'il n'a pas validé passe par cette revue. Tu es l'orchestrateur : l'agent `revue` présente et modifie, toi tu relaies, poses la question et commites. **Tu ne juges pas l'event toi-même.** ## 1. Les events à revoir @@ -36,5 +36,5 @@ Un tableau : event, décision (validé, corrigé et validé, rejeté, passé). U ## Règles - Les vrais noms (station, capteurs) restent dans la conversation et `out/review-event/` (hors de git) : jamais dans un fichier de l'event ni un message de commit. -- Une correction qui touche une règle générale (les instructions de l'agent de diagnostic, un détecteur, le builder) n'est pas faite ici : note-la pour l'utilisateur dans le tableau de fin. +- Une correction qui touche une règle générale (les instructions de l'agent de diagnostic, un détecteur, l'event-builder) n'est pas faite ici : note-la pour l'utilisateur dans le tableau de fin. - Les autres fichiers modifiés de l'arbre ne se commitent pas avec l'event. diff --git a/.claude/skills/review-event/page.py b/.claude/skills/review-event/page.py index 62244a7..0723419 100644 --- a/.claude/skills/review-event/page.py +++ b/.claude/skills/review-event/page.py @@ -1,8 +1,8 @@ """La page de revue d'un event appris : tout ce qu'il faut à l'expert pour trancher, sur une seule page (D-075). 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, 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. +plage (detecteurs.py, sur data//, sinon sur le dossier de l'event) ; dessous, la fiche, l'étiquetage, le rendu de +l'event-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) """ @@ -80,7 +80,7 @@ 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")), + ("Rendu de l'event-builder", lot and os.path.join(lot, "builder.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"))]: diff --git a/CLAUDE.md b/CLAUDE.md index 5f61814..93b5dc8 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` (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. +- `docs/decisions.md` (923 l, D-001 à D-091) : 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/`. @@ -98,7 +98,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer . - `vues-deplacements/` : le chantier des déplacements (D-052), avec sa propre carte, `vues-deplacements/CLAUDE.md` : `maquette/` (page Explore et `spec.md`, D-053 à D-056), `contexte/` (journal du matin, seuils, lissage, boucle, aiguisage), `cas/` (NORDEND, parcours de l'utilisateur), `benchmark/historique.csv` (D-069). - `detectors/` : les détecteurs du journal (D-067, D-068, D-084), un détecteur élémentaire par fichier, contrat `detect(mesures)`, classés en événements par `categories.py` ; `archive/` : versions écartées. - `boucle/`, `aiguiser/` : les séances de `/boucle` et `/aiguiser` (D-084), une par dossier `_/` (`lot-NN/`, `bilan.md`) ; historique, à ne lire que sur demande. `aiguiser/voir.py` : ce que rendent les outils de lecture sur un lot. -- `events/` : **la base d'events, connaissance métier qui grandit** (D-048, D-080) : `INDEX.md` (le registre, seule porte d'entrée ; mode d'emploi : skill `read-event`, D-085), un dossier `E-xxx/` par event (`event.md` lisible d'abord par un humain, figures, données codées, `etiquettes.json`), validé par l'utilisateur ou « (appris) » par `/boucle` en attendant `/review-event` ; `carte-des-evenements.md` (familles, catégories du journal) et `eventualites-et-categories.drawio`. Un event n'y entre que par `/new-event`, lancé par l'utilisateur, ou par le builder de `/boucle`. +- `events/` : **la base d'events, connaissance métier qui grandit** (D-048, D-080) : `INDEX.md` (le registre, seule porte d'entrée ; mode d'emploi : skill `read-event`, D-085), un dossier `E-xxx/` par event (`event.md` lisible d'abord par un humain, figures, données codées, `etiquettes.json`), validé par l'utilisateur ou « (appris) » par `/boucle` en attendant `/review-event` ; `carte-des-evenements.md` (familles, catégories du journal) et `eventualites-et-categories.drawio`. Un event n'y entre que par `/new-event`, lancé par l'utilisateur, ou par l'event-builder de `/boucle`. - `agent-tools/` : les outils de lecture des agents (D-081) : `donnees.py` (lecture commune, aussi des détecteurs), `inventaire`, `resume`, `plages`, `jours`, `ensemble`, `graphique`, `vignettes`, `gif` ; mode d'emploi : skill `lire-les-donnees`, aiguisé par `/aiguiser`. - `agent-diagnostic/` : consignes (`instructions.md`, 146 l) et rapports de l'agent de diagnostic (D-082). Appel : `@agent-diagnostic data// [question]`. - `support/` : un dossier par demande d'un client (D-079), `__/` : `demande.md`, `analyse.md`, `reponse.md` (le mail prêt à envoyer), GIF des images. Contient des mails et images de clients. @@ -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-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). +- `.claude/` : `rules/analyses.md` ; `agents/` : `diagnostic`, ceux de `/boucle` (`analyste`, `detectors-critic`, `detectors-upgrader`, `detectors-control`, `event-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/agent-diagnostic.md b/docs/agents/agent-diagnostic.md index a044b91..4405dff 100644 --- a/docs/agents/agent-diagnostic.md +++ b/docs/agents/agent-diagnostic.md @@ -239,7 +239,7 @@ events/ - À côté de `rapports/` : un rapport validé devient un event, et les signatures s'écrivent dans le langage des outils de l'agent. - Les données de l'event sont copiées dans son dossier, noms codés (D-050) : la fiche et ses commandes se rejouent sans `data//`, qui garde l'original (D-029). - Le numéro `E-xxx` est la référence stable que cite le rapport. -- **`etiquettes.json`** (D-069) : le diagnostic de l'event au format des étiquettes de l'analyste de `/boucle` (D-061), noms codés, figé à la création comme le reste de l'event. Le benchmark des détecteurs (`.claude/skills/boucle/benchmark.py`) les compare, mesure par mesure. Un event appris le reçoit du builder (`anonymiser.py --etiquettes`) ; E-001 à E-005 l'ont reçu d'un passage unique de l'analyste, corrigé par leur fiche (2026-10-26) ; un event de `/new-event`, de même. Chaque event a, à côté, `etiquetage.md` : la lecture de l'analyste et ce que la fiche y a changé, ou, pour un event appris, le lot d'origine et le tableau des moments. +- **`etiquettes.json`** (D-069) : le diagnostic de l'event au format des étiquettes de l'analyste de `/boucle` (D-061), noms codés, figé à la création comme le reste de l'event. Le benchmark des détecteurs (`.claude/skills/boucle/benchmark.py`) les compare, mesure par mesure. Un event appris le reçoit de l'event-builder (`anonymiser.py --etiquettes`) ; E-001 à E-005 l'ont reçu d'un passage unique de l'analyste, corrigé par leur fiche (2026-10-26) ; un event de `/new-event`, de même. Chaque event a, à côté, `etiquetage.md` : la lecture de l'analyste et ce que la fiche y a changé, ou, pour un event appris, le lot d'origine et le tableau des moments. - Un event n'entre dans l'index qu'une fois validé par l'expert : pas de colonne de statut. L'agent n'ouvre que les fiches que cite l'index. - La base démarre vide : `INDEX.md` n'a que son en-tête. - **Noms codés (D-049, D-050)** : dans l'index, les fiches, leurs figures et leurs données, la station prend le numéro de l'event, une référence devient `R1`, une cible `C1`. Les codes des capteurs sont stables d'un event à l'autre et tenus dans le registre du skill `anonymize-event`, que l'agent ne lit pas. L'agent rapproche ainsi par la signature, pas par le nom. diff --git a/docs/agents/pipelines-ia.drawio b/docs/agents/pipelines-ia.drawio index 28ea1d0..1252994 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 5373777..b61aa51 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -910,3 +910,14 @@ Règles du journal : - **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. + +## D-091 — 2026-10-29 — `/boucle` : l'`event-builder`, appelé à chaque lot, décide ce qui est nouveau +- **Statut** : active. Modifie D-057 (le builder), D-090 (l'analyste) ; point 54 du plan du journal du matin. +- **Décision** : + - le builder devient `event-builder` ; l'orchestrateur l'appelle à chaque lot, plus seulement quand un rendu signale une nouveauté ; + - il lit toute l'analyse et décide seul, face à la base d'events (`read-event`), ce que le lot lui apprend de nouveau : c'est sa responsabilité, à son jugement, sans règle fixée (l'utilisateur : « laissons ce flou ») ; ce que la base connaît se juge sur ses events, qui ont leurs données : un événement que la carte décrit sans event (« hypothétique ») n'est pas connu ; un moment qui contredit un event est noté pour l'utilisateur, sans event ; + - un event garde les bornes de l'événement, pas celles du lot (l'utilisateur) : le moment de l'analyse, vérifié sur les données, plus 6 h de part et d'autre ; un état qui couvre le lot, un moment qui le montre ± 6 h ; données, étiquettes, figures et commandes de la signature s'y bornent ; + - la section « Nouveautés » quitte l'analyse (`analyser-lot`) et le rendu du `detectors-upgrader` ; le bilan liste les contradictions avec la base au lieu des « nouveautés déjà connues » ; le rendu garde son nom, `builder.md`. +- **Pourquoi** : l'utilisateur, 2026-10-29 : décider ce qui mérite d'entrer dans la base est la responsabilité du builder, pas de l'analyste (un agent, une responsabilité, D-090). Avec l'ancienne règle (« ce que ni la carte ni l'index ne décrivent »), le premier exemple réel d'un événement hypothétique de la carte n'entrait jamais dans la base. +- **Options écartées** : garder les nouveautés de l'analyste comme entrée ; la règle « un event par genre d'événement, pas par occurrence » (l'utilisateur : à l'agent de décider). +- **Conséquence** : un appel d'agent de plus par séance quand rien n'est nouveau ; sans doute plus d'events appris à revoir par `/review-event`. 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 80c2324..36c0d61 100644 --- a/docs/superpowers/plans/2026-10-23-journal-du-matin.md +++ b/docs/superpowers/plans/2026-10-23-journal-du-matin.md @@ -107,6 +107,7 @@ Types : **Comprendre** (lire, expliquer, rien ne change), **Décider** (l'utilis | 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 | +| 54 | Le builder devient `event-builder` | Essayer | 53 | appelé à chaque lot, décide seul ce qui est nouveau, bornes de l'événement (D-091) ; à essayer sur une séance | | | **VIII. Suivi du chantier** | | | | | 37 | Ménage : commit, `CLAUDE.md`, Mermaid, sorties | Lancer | — | validé le 2026-10-24 | @@ -1172,6 +1173,27 @@ Rapport de l'agent : `vues-deplacements/contexte/donnees-et-boucle.md`. Script : - [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` ? +### Point 54 : Le builder devient `event-builder` + +**L'idée** (l'utilisateur, 2026-10-29). Après l'analyste, le critic, l'upgrader et le contrôle, le builder de `/boucle` : il s'appellera `event-builder` ; d'abord comprendre comment il fonctionne et qui l'appelle. + +**Constat (Claude, 2026-10-29).** Aujourd'hui, l'analyste propose les nouveautés (« ce que ni la carte ni l'index ne décrivent »), l'orchestrateur n'appelle le builder que s'il y en a, et le builder tranche face à la base (index et fiches). Trou : un événement que la carte décrit comme « hypothétique » n'est jamais une nouveauté ; la base ne reçoit pas son premier exemple réel. + +**Proposition de l'utilisateur (2026-10-29).** Le builder est appelé de toute façon ; il consulte la base pour déterminer ce qui est nouveau : c'est sa responsabilité de décider s'il faut un nouvel event. + +**Précisions de Claude (à valider).** +- Nouveau = aucun event de la base n'a la signature (ligne d'index ou fiche) ; la carte ne compte plus : le premier exemple réel d'un événement « hypothétique » devient un event. +- Il lit toute l'analyse (chaque moment, les étiquettes, les figures) ; la section « Nouveautés » de l'analyste disparaît, et celle du `detectors-upgrader`, qui ne nourrirait plus personne. +- Un appel de plus par séance quand rien n'est nouveau ; plus d'events à revoir, bornés par « un event par genre, pas par occurrence ». + +**Réponse de l'utilisateur (2026-10-29).** Oui, avec deux points : pas de règle « un event par genre, pas par occurrence », c'est à l'agent de décider ; et les bornes : un lot peut couvrir une longue plage, l'event se restreint au moment où l'événement se produit. + +**Fait le 2026-10-29 (D-091).** Agent `event-builder` (`git mv`, consigne réécrite) ; nouveautés retirées d'`analyser-lot` et du rendu du `detectors-upgrader` ; `/boucle` (étape 5 à chaque lot, bilan : contradictions), revue et page de `/review-event`, `read-event`, spec de la boucle, `CLAUDE.md`, `run.md`, `vues-deplacements/CLAUDE.md`, spec de l'agent de diagnostic, schéma des pipelines. + +**Étapes.** +- [x] Le renommer et le redéfinir (2026-10-29, D-091). +- [ ] Une séance de `/boucle` qui l'essaie : des events bien choisis, bien bornés ? + --- ## Partie VII — Idées gardées pour plus tard @@ -1388,3 +1410,6 @@ Une ligne par séance : date, point(s) traités, ce qui a changé, ce qui reste. - 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. +- 2026-10-29 : point 54 ajouté (idée de l'utilisateur : le builder devient `event-builder`). +- 2026-10-29 : point 54, proposition de l'utilisateur : le builder appelé à chaque lot, qui décide seul ce qui est nouveau face à la base ; précisions de Claude. +- 2026-10-29 : point 54, D-091 : `event-builder`, appelé à chaque lot, décide seul ce qui est nouveau face à la base, events bornés à l'événement ; à essayer sur une séance. diff --git a/run.md b/run.md index d6fa7bd..96e2e56 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-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. +- 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, event-builder à chaque lot, 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 2c0f230..cfca622 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 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`. +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 fait décider par un event-builder ce que le lot apprend de nouveau à la base d'events (D-091) ; une séance commitée directement sur `master` (D-070), ses rendus dans `boucle/_/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/boucle-automatique.md b/vues-deplacements/contexte/boucle-automatique.md index 730356d..49e3ce2 100644 --- a/vues-deplacements/contexte/boucle-automatique.md +++ b/vues-deplacements/contexte/boucle-automatique.md @@ -48,7 +48,7 @@ L'analyste, le detectors-critic et le detectors-control ne laissent rien de dura 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). +5. **Event-builder** : à chaque lot, il décide, face à la base d'events, ce que l'analyse lui apprend de nouveau ; il en fait des events, `events/`, et écrit `builder.md`. Un commit pour les events du lot (ils partagent la ligne d'index). Le lot suivant tourne avec les détecteurs tels qu'ils sont devenus. À la fin, l'orchestrateur écrit `bilan.md` (§6) et le commite. @@ -71,9 +71,8 @@ Une seule responsabilité depuis le 2026-10-29 (l'utilisateur, D-090) : l'analys 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. -`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. +`analyse.md` reprend ces parties (avant D-091, aussi les nouveautés, pour le builder) ; ses figures sont dans le dossier du lot. Avant D-090, l'analyste lisait sans les détecteurs, puis les comparait lui-même et rendait la critique : `critique.md` des séances d'avant porte les deux. ### Detectors-critic : `.claude/agents/detectors-critic.md` @@ -88,7 +87,7 @@ Il juge les détecteurs face à l'analyse, la vérité (l'utilisateur, 2026-10-2 **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 ` compare, mesure par mesure et capteur par capteur, les événements des détecteurs aux étiquettes de **tous** les lots de la station : par catégorie et pour deux niveaux de validité (« à ignorer » : les zones grisées ; « prudence » : visibilité réduite et turbulence), « trouvées » (part des mesures étiquetées que les détecteurs signalent) et « justes » (part des mesures signalées que l'analyste a étiquetées). L'orchestrateur l'écrit au début de chaque lot (`score-avant.txt`) et en fin de séance (`score-fin.txt`) ; le detectors-upgrader le relance après une modification, comme un contrôle et non un but (D-089) : la catégorie en cause s'améliore sur ce lot, sans baisse nette ailleurs (une autre ligne de ce lot, les lots d'avant) ; un trou n'a pas de case (pas de mesure) : pour lui, la commande du lot dit le bon sens. Le score est un fait, pas un verdict : l'analyste peut se tromper aussi. Choix de Claude, laissé par l'utilisateur, à revoir après la première séance : trois niveaux plutôt que deux, un compte par mesure plutôt que par événement, par capteur plutôt que pour toute la station. Le script est hors de `detectors/` : le detectors-upgrader ne peut pas le modifier. -**Benchmark** (D-069, point 48 du plan, ajouté le 2026-10-26 à la demande de l'utilisateur) : chaque event de la base garde son diagnostic à la création, `etiquettes.json` au format des étiquettes de l'analyste, noms codés, figé ; `.claude/skills/boucle/benchmark.py` lance les détecteurs sur chaque event et les compare à ces étiquettes, comme le score (« trouvées », « justes », par catégorie, par cas et au total). Purement analytique, sans agent. L'orchestrateur le lance au début de chaque lot (`benchmark-avant.txt`), après chaque modification (`benchmark-K.txt`) et en fin de séance (`benchmark-fin.txt`), et l'ajoute à l'historique `vues-deplacements/benchmark/historique.csv`, avec la version des détecteurs (commit) ; le detectors-upgrader le relance et le detectors-control juge sur lui seul (D-089) : un event moins bien trouvé ou moins bien borné est un recul, une hausse un plus, pas un but (sur une dizaine d'events, les détecteurs se régleraient sur eux, choix de l'utilisateur). Le builder donne ses étiquettes à chaque event créé (`anonymiser.py --etiquettes`) ; E-001 à E-005 ont reçu les leurs d'un passage unique de l'analyste, corrigé par leur fiche (leur `etiquetage.md`). Limite : un event appris ne contient que l'événement ± 6 h, sans les 3 jours d'historique d'un lot. +**Benchmark** (D-069, point 48 du plan, ajouté le 2026-10-26 à la demande de l'utilisateur) : chaque event de la base garde son diagnostic à la création, `etiquettes.json` au format des étiquettes de l'analyste, noms codés, figé ; `.claude/skills/boucle/benchmark.py` lance les détecteurs sur chaque event et les compare à ces étiquettes, comme le score (« trouvées », « justes », par catégorie, par cas et au total). Purement analytique, sans agent. L'orchestrateur le lance au début de chaque lot (`benchmark-avant.txt`), après chaque modification (`benchmark-K.txt`) et en fin de séance (`benchmark-fin.txt`), et l'ajoute à l'historique `vues-deplacements/benchmark/historique.csv`, avec la version des détecteurs (commit) ; le detectors-upgrader le relance et le detectors-control juge sur lui seul (D-089) : un event moins bien trouvé ou moins bien borné est un recul, une hausse un plus, pas un but (sur une dizaine d'events, les détecteurs se régleraient sur eux, choix de l'utilisateur). L'event-builder donne ses étiquettes à chaque event créé (`anonymiser.py --etiquettes`) ; E-001 à E-005 ont reçu les leurs d'un passage unique de l'analyste, corrigé par leur fiche (leur `etiquetage.md`). Limite : un event appris ne contient que l'événement ± 6 h, sans les 3 jours d'historique d'un lot. ### Detectors-upgrader : `.claude/agents/detectors-upgrader.md` @@ -113,15 +112,16 @@ Le garde-fou contre le sur-apprentissage (l'utilisateur, 2026-10-29, D-089) : de - `validation-K.md` : « accepté » ou « à reprendre » avec ses remarques ; au troisième passage, « garder » ou « annuler ». - Avant le 2026-10-29, le validateur jugeait aussi le lot (critique, score) et ne renvoyait que pour « un défaut net » ; il n'a jamais renvoyé une modification, et des mesures signalées à tort sur la base passaient (WILDSTRUBEL, point 52 du plan). -### Builder : `.claude/agents/builder.md` +### Event-builder : `.claude/agents/event-builder.md` -Il construit la base de connaissances (l'utilisateur). Outils : Read, Bash, Write, Edit. Il lit les nouveautés des rendus du lot ; c'est l'analyste qui en signale le plus, mais le detectors-upgrader peut en noter aussi (l'utilisateur : « pendant toutes ces phases »). +Il construit la base de connaissances (l'utilisateur). Outils : Read, Bash, Write, Edit. Renommé et redéfini le 2026-10-29 (l'utilisateur, D-091) : appelé à chaque lot, il lit toute l'analyse et décide seul ce qui est nouveau ; avant, il ne traitait que les nouveautés que l'analyste (ou l'upgrader) avait signalées, et l'orchestrateur ne l'appelait que s'il y en avait. -- **Une seule base** (l'utilisateur) : `events/`, à côté de E-001 à E-005 ; numéro suivant de l'index (`E-006`…), comme `/new-event`. -- **Un event par genre d'événement, pas par occurrence** *(choix de Claude)* : si un event de la base a déjà la même signature, dans sa ligne d'index ou dans sa fiche, rien ; une nouveauté qui contredit le diagnostic d'un event est « déjà connue », la contradiction dite pour l'utilisateur. -- Sinon, un event de la même forme que E-001 à E-005 : données de la fenêtre de l'événement, avec une marge, copiées et codées par `anonymize-event` (un état de plus d'un jour : un moment qui le montre, ± 6 h, la plage entière dite dans la fiche) ; fiche du §11.3, un fait hors des listes fermées rangé sous la plus proche, précisé (résumé, symptôme, verdict, signature avec ses commandes, diagnostic, preuves avec leurs figures) ; ligne d'index. -- **Marqué « appris »** *(choix de Claude)*, pour la revalidation à la main, plus tard : en tête de fiche, « Appris par la boucle le , séance , non revalidé par l'expert » ; dans l'index, le Verdict commence par « (appris) ». -- Il ne touche jamais aux events existants. Il ne passe pas par `/new-event` (ni passage à l'aveugle, ni validation) : les events appris s'ajoutent sans attendre (l'utilisateur : « ça ne peut pas vraiment faire de mal »). +- **Une seule base** (l'utilisateur) : `events/`, à côté de E-001 à E-005 ; numéro suivant de l'index, comme `/new-event`. +- **Ce qui est nouveau, à son jugement** (l'utilisateur) : il consulte la base (`read-event`) et décide, moment par moment, s'il faut un nouvel event. Ce que la base connaît se juge sur ses events, avec leurs données : un événement que la carte décrit sans event (« hypothétique ») n'est pas connu, son premier exemple réel peut devenir un event. Un moment qui contredit le diagnostic d'un event est noté pour l'utilisateur, sans event. +- **Bornes de l'événement, pas du lot** (l'utilisateur) : un lot peut couvrir des jours ; l'event ne garde que le moment où l'événement se produit, vérifié sur les données, plus 6 h de part et d'autre (un état qui couvre le lot : un moment qui le montre, ± 6 h, la plage entière dite dans la fiche). Données, étiquettes, figures et commandes de la signature s'y bornent. +- Sinon, un event de la même forme que E-001 à E-005 : données copiées et codées par `anonymize-event` ; fiche du §11.3, un fait hors des listes fermées rangé sous la plus proche, précisé ; ligne d'index. +- **Marqué « appris »** *(choix de Claude)*, pour la revalidation par `/review-event` : en tête de fiche, « Appris par la boucle le , séance , non revalidé par l'expert » ; dans l'index, le Verdict commence par « (appris) ». +- Il ne touche jamais aux events existants ni à la carte (elle apprend à la validation, D-087). Il ne passe pas par `/new-event` (ni passage à l'aveugle, ni validation) : les events appris s'ajoutent sans attendre (l'utilisateur : « ça ne peut pas vraiment faire de mal »). ### Releveur : `.claude/agents/releveur.md` (D-060) @@ -134,7 +134,7 @@ Ajouté le 2026-10-26 à la demande de l'utilisateur, seulement si `/boucle` est ## 6. Ce que l'utilisateur trouve à la fin - Les commits de la séance sur `master`, un par étape, lisibles avec `git log` depuis la base de la séance (notée dans `bilan.md`) ; il annule ce qu'il ne garde pas par `git revert`. -- `bilan.md` : une ligne par lot (verdict de l'analyste ; étiquettes ; modification gardée, annulée ou aucune ; events créés), et le score de fin de séance (`score-fin.txt`) sur toutes les étiquettes de la station ; les suggestions non traitées (nouvelle catégorie, au-delà de deux) ; les nouveautés déjà connues ; les erreurs. +- `bilan.md` : une ligne par lot (verdict de la critique ; étiquettes ; modification gardée, annulée ou aucune ; events créés), et le score de fin de séance (`score-fin.txt`) sur toutes les étiquettes de la station ; les suggestions non traitées (nouvelle catégorie, au-delà de deux) ; les contradictions avec la base relevées par l'event-builder ; les erreurs. - `docs/ameliorations-processus.md` : les difficultés du processus relevées pendant la séance ; avec `--ameliorer`, celles que l'améliorateur a corrigées sont marquées **traité**. - La page `out/boucle_.html` (D-066, ajoutée le 2026-10-26 à la demande de l'utilisateur), ouverte en fin de séance : les courbes de toute la plage ; dessous, une ligne par catégorie, la lecture de l'analyste au-dessus des événements des détecteurs ; tout en bas, la ligne « Error rate » (`error_value` moyenne de tous les capteurs, du vert au rouge, avec sa barre de couleur, ajoutée le 2026-10-27 à la demande de l'utilisateur) ; le score de la séance. Le but, séance après séance : que les deux coïncident.