diff --git a/.claude/agents/builder.md b/.claude/agents/builder.md index 51e3cf1..98d9191 100644 --- a/.claude/agents/builder.md +++ b/.claude/agents/builder.md @@ -14,7 +14,7 @@ Le dossier de station, le lot (UTC), le dossier du lot (ses rendus : `critique.m ## Ce que tu fais 1. Lis la partie `## Nouveautés` de chaque rendu du lot, et ce que la critique en dit (parties 1 et 3, figures). -2. Lis `agents/diagnostic/cas/INDEX.md`. **Un cas par genre d'événement, pas par occurrence** : une nouveauté dont un cas a déjà la signature (même rôle des capteurs, même forme, même moment de la journée, même durée à peu près) ne donne rien. Ouvre la fiche d'un cas proche si tu hésites. +2. Lis `agents/diagnostic/cas/INDEX.md`. **Un cas par genre d'événement, pas par occurrence** : une nouveauté dont un cas a déjà la signature (même rôle des capteurs, même forme, même moment de la journée, même durée à peu près) ne donne rien. La signature d'un cas, c'est sa ligne d'index **ou** sa fiche : ouvre la fiche des cas proches, un phénomène peut n'être que dans la fiche. Une nouveauté qui contredit le diagnostic d'un cas (un même état étiqueté autrement) est « déjà connue (C-00x) », avec la contradiction en une phrase, pour l'utilisateur. 3. Pour chaque nouveauté vraiment nouvelle, un cas : - **numéro** : le plus grand `C-xxx` de l'index, plus un ; dossier `agents/diagnostic/cas/C-xxx/` ; - **données et diagnostic** : `python3 .claude/skills/anonymiser-cas/anonymiser.py agents/diagnostic/cas/C-xxx/ --du --au --etiquettes /etiquettes.json` (instants `AAAA-MM-JJTHH:MMZ`) : seulement la fenêtre de l'événement et sa marge ; les étiquettes de l'analyste dans cette fenêtre, codées, deviennent `etiquettes.json` du cas, 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 agents/diagnostic/cas/C-xxx agents/diagnostic/cas/C-xxx/etiquettes.json`, « bon » ; diff --git a/.claude/agents/upgrader.md b/.claude/agents/upgrader.md index 3a13e5e..6dbc9fd 100644 --- a/.claude/agents/upgrader.md +++ b/.claude/agents/upgrader.md @@ -43,9 +43,9 @@ La crainte de l'utilisateur, c'est que les détecteurs partent dans trop de comp Lance la commande du lot avec `2>&1`, **avant** de modifier et **après**. Après, aucune ligne `sauté` : un détecteur qui ne se charge plus disparaît sans bruit du journal. Le défaut relevé doit avoir bougé dans le bon sens, sans casser les autres événements du lot. -Puis le **score** : `python3 .claude/skills/boucle/score.py `, face au score avant. Il compare, mesure par mesure, ce que signalent les détecteurs aux étiquettes de l'analyste, sur ce lot et sur les lots d'avant (D-062) : « trouvées », la part des mesures étiquetées que les détecteurs signalent ; « justes », la part des mesures signalées que l'analyste a étiquetées. La catégorie en cause doit monter sur ce lot, sans baisse nette ailleurs (un événement entier perdu ou signalé à tort, pas quelques mesures de bornes). Ne vise pas 100 % : l'analyste peut se tromper aussi, et une règle de plus pour quelques mesures ne vaut pas sa complexité. +Puis le **score** : `python3 .claude/skills/boucle/score.py `, face au score avant. Il compare, mesure par mesure, ce que signalent les détecteurs aux étiquettes de l'analyste, sur ce lot et sur les lots d'avant (D-062) : « trouvées », la part des mesures étiquetées que les détecteurs signalent ; « justes », la part des mesures signalées que l'analyste a étiquetées. La catégorie en cause doit monter sur ce lot, sans baisse nette ailleurs (un événement entier perdu ou signalé à tort, pas quelques mesures de bornes). Un trou n'a pas de mesure, donc pas de case au score : pour une suggestion sur un trou, le bon sens se lit à la commande du lot (le trou daté comme l'analyste), et le score et le benchmark ne doivent pas baisser net. Ne vise pas 100 % : l'analyste peut se tromper aussi, et une règle de plus pour quelques mesures ne vaut pas sa complexité. -Puis le **benchmark**, `python3 .claude/skills/boucle/benchmark.py` (sans `--etape` : l'historique est tenu par l'orchestrateur), face au benchmark avant. Il compare de la même façon les détecteurs au diagnostic gardé dans chaque cas de la base (`agents/diagnostic/cas/C-*/etiquettes.json`, D-069) : ce sont les cas de régression, et au premier lot d'une station le score n'a pas de lot d'avant. Un recul net sur un cas (un événement entier perdu ou signalé à tort) est un recul ; une hausse est un plus, **pas un but** : ne règle rien pour un cas précis. C-004 est un vrai mouvement : sa ligne `a_verifier` ne doit pas baisser. +Puis le **benchmark**, `python3 .claude/skills/boucle/benchmark.py` (sans `--etape` : l'historique est tenu par l'orchestrateur), face au benchmark avant. Il compare de la même façon les détecteurs au diagnostic gardé dans chaque cas de la base (`agents/diagnostic/cas/C-*/etiquettes.json`, D-069) : ce sont les cas de régression, et au premier lot d'une station le score n'a pas de lot d'avant. Un recul net sur un cas (un événement entier perdu ou signalé à tort) est un recul ; une hausse est un plus, **pas un but** : ne règle rien pour un cas précis. C-004 est un vrai mouvement : sa ligne `a_verifier` ne doit pas baisser. Si la critique étiquette un état que le diagnostic figé d'un cas étiquette autrement (son `etiquettes.json`, son `etiquetage.md`), ne tranche pas : le benchmark prime (pas de recul net), et la contradiction va dans « Pas corrigé », pour l'utilisateur. ## Ton rendu, `modification-K.md` @@ -65,7 +65,7 @@ Puis le **benchmark**, `python3 .claude/skills/boucle/benchmark.py` (sans `--eta ## Benchmark - + ## Pas corrigé aucune | diff --git a/.claude/agents/validateur.md b/.claude/agents/validateur.md index 5e249ec..b086b1e 100644 --- a/.claude/agents/validateur.md +++ b/.claude/agents/validateur.md @@ -19,7 +19,7 @@ Le dossier de station, le lot (UTC), la commande du lot, la critique, le score a 4. Lis le **benchmark** avant et après (les deux fichiers de ta demande, D-069) : les détecteurs face au diagnostic gardé dans chaque cas de la base. Puis lance le **score**, `python3 .claude/skills/boucle/score.py `, et compare-le au score avant. Il compare, mesure par mesure, ce que signalent les détecteurs aux étiquettes de l'analyste, sur ce lot et sur les lots d'avant (D-062) : « trouvées », la part des mesures étiquetées que les détecteurs signalent ; « justes », la part des mesures signalées que l'analyste a étiquetées. C'est un fait, pas un verdict : l'analyste peut se tromper aussi. 5. Réponds à quatre questions : - la modification répond-elle au défaut relevé par l'analyste ? - - va-t-elle dans le bon sens ? Le score le dit : la catégorie en cause monte sur ce lot, sans baisse nette sur les lots d'avant ; + - va-t-elle dans le bon sens ? Le score le dit : la catégorie en cause monte sur ce lot, sans baisse nette sur les lots d'avant ; pour un trou, sans case au score (pas de mesure), la commande du lot le dit (le trou daté comme l'analyste), sans baisse nette du score ni du benchmark ; - est-elle simple, à la mesure du gain ? - respecte-t-elle les interdits : pas de nouvelle catégorie, pas de règle propre à une station, à un capteur ou à une date, contrat `detect(mesures)` et clés des épisodes inchangés, bibliothèque standard, registre des seuils à jour ? diff --git a/.claude/skills/boucle/SKILL.md b/.claude/skills/boucle/SKILL.md index cf2f9e3..dc8cb27 100644 --- a/.claude/skills/boucle/SKILL.md +++ b/.claude/skills/boucle/SKILL.md @@ -11,7 +11,7 @@ Tu es l'orchestrateur. Tu découpes la plage en lots, tu appelles les quatre age ## 1. Mise en place -- Arguments : le dossier de station ; un nom de station seul (« Nordend ») désigne `data//` (D-065) ; `--du`, `--au` (jours UTC, facultatifs : sans eux, toute la période ; **`--au` est exclu** : la plage s'arrête à `--au` 00:00Z, `--du 2026-09-01 --au 2026-09-05` fait 4 jours) ; `--lot` (jours, 4 par défaut) ; `--ameliorer` (facultatif : en fin de séance, l'améliorateur corrige le processus d'après les relevés du releveur, §6, D-071). L'utilisateur choisit ses lots : `--du` / `--au` sur la plage d'un lot n'en traite qu'un. Des dates écrites autrement (« 2026-09.01 », deux dates sans option) se lisent comme `--du` puis `--au` ; écris dans le bilan, sous « Erreurs », comment tu as lu un argument qui n'était pas net. +- Arguments : le dossier de station ; un nom de station seul (« Nordend ») désigne `data//` (D-065) ; `--du`, `--au` (jours UTC, facultatifs : sans eux, toute la période ; **`--au` est exclu** : la plage s'arrête à `--au` 00:00Z, `--du 2026-09-01 --au 2026-09-05` fait 4 jours) ; `--lot` (jours, 4 par défaut) ; `--ameliorer` (facultatif : en fin de séance, l'améliorateur corrige le processus d'après les relevés du releveur, §6, D-071). L'utilisateur choisit ses lots : `--du` / `--au` sur la plage d'un lot n'en traite qu'un. Des dates écrites autrement (« 2026-09.01 », deux dates sans option) se lisent comme `--du` puis `--au` ; une option entre crochets (`[--ameliorer]`, la syntaxe d'usage recopiée) vaut l'option sans crochets ; écris dans le bilan, sous « Erreurs », comment tu as lu un argument qui n'était pas net. - `python3 agents/diagnostic/outils/inventaire.py ` : dossier absent ou sans export « advanced », dis-le et arrête-toi. - `STATION` = le nom du dossier de station (`NORDEND`) ; `SEANCE` = `date -u +%Y-%m-%dT%H%MZ`. - La séance se commite directement sur `master` (D-070) : `git branch --show-current` doit dire `master`, sinon dis-le et arrête-toi (pas de `git switch` : une autre session peut travailler dans ce dépôt). Note la **base de la séance** : `git rev-parse HEAD`. Les fichiers modifiés de l'utilisateur restent sans être commités : tu commites toujours par chemin. Une autre session peut travailler dans le même dépôt pendant la séance (fichiers modifiés, index déjà chargé, même ce skill) : `git commit -- ` ne prend que tes chemins ; n'indexe rien d'autre, jamais de `git add -A`, `git stash` ni `git checkout` hors de tes chemins ; garde les consignes lues au début et note le changement dans tes difficultés. @@ -65,7 +65,7 @@ Commits : sur `master`, depuis (`git log --oneline → . +Benchmark sur la base de cas (D-069) : au début de chaque lot `lot-NN/benchmark-avant.txt`, après chaque modification `lot-NN/benchmark-K.txt`, en fin de séance `benchmark-fin.txt` ; historique `vues-deplacements/benchmark/historique.csv`. Total : → . Page : `out/boucle__.html`, l'analyste face aux détecteurs sur toute la plage (D-066) ; la refaire : `python3 .claude/skills/boucle/comparaison.py `. @@ -96,4 +96,4 @@ Si `git status --short docs/ameliorations-processus.md` montre un changement : c `python3 .claude/skills/boucle/comparaison.py ` : la page de fin de séance, `out/boucle__.html`, qui s'ouvre dans le navigateur (D-066). En haut, `corr_x` et `corr_y` de tous les capteurs sur toute la plage de la séance ; dessous, une ligne par catégorie : la lecture de l'analyste (ses étiquettes) au-dessus des événements des détecteurs tels qu'ils sont en fin de séance, et en gris ses moments hors catégorie ; sous la figure, le score de la séance et le benchmark sur la base de cas. Le but, séance après séance : que les deux coïncident. Un échec du script va dans la réponse, sans relance. -En 8 lignes au plus : la page, la base de la séance, le chemin du bilan, le benchmark (ligne `total toutes`, début → fin), le nombre de modifications gardées et de cas créés, le nombre d'étiquettes (`/lot-*/etiquettes.json`, à garder même si l'utilisateur annule des modifications : elles ne dépendent pas des détecteurs), les erreurs, les difficultés relevées et, avec `--ameliorer`, celles corrigées. Tout est sur `master`, rien n'est poussé : l'utilisateur annule ce qu'il ne garde pas par `git revert`. +En 8 lignes au plus : la page, la base de la séance, le chemin du bilan, le benchmark (ligne `total` / `toutes`, `grep -E '^total +toutes'`, début → fin), le nombre de modifications gardées et de cas créés, le nombre d'étiquettes (`/lot-*/etiquettes.json`, à garder même si l'utilisateur annule des modifications : elles ne dépendent pas des détecteurs), les erreurs, les difficultés relevées et, avec `--ameliorer`, celles corrigées. Tout est sur `master`, rien n'est poussé : l'utilisateur annule ce qu'il ne garde pas par `git revert`. diff --git a/docs/ameliorations-processus.md b/docs/ameliorations-processus.md index 5d110bc..45dce06 100644 --- a/docs/ameliorations-processus.md +++ b/docs/ameliorations-processus.md @@ -40,19 +40,19 @@ Séance de référence des entrées ci-dessous : 2026-10-26T1414Z, NORDEND, lot Séance de référence des entrées ci-dessous : 2026-10-26T1618Z, CLARIDEN, un lot (lot 01, 2026-09-12T00:00Z → 2026-09-15T00:00Z), avec `--ameliorer` (B2 dans les occurrences). Une difficulté de B2 a la même cause qu'une entrée de `/aiguiser` et y est notée comme occurrence : `vues-deplacements/CLAUDE.md` injecté (analyste). -- **Option écrite entre crochets** (2026-10-26, *consigne absente*) : l'argument est arrivé sous la forme `[--ameliorer]`, la syntaxe d'usage recopiée telle quelle ; le skill dit comment lire des dates mal écrites, pas une option entre crochets. L'orchestrateur l'a lue comme active et l'a écrit sous « Erreurs » du bilan. *En cause* : `.claude/skills/boucle/SKILL.md:5` (`argument-hint`, options entre crochets), `:14` (règles de lecture des arguments). *Occurrences* : B2, orchestrateur. +- **Option écrite entre crochets** (2026-10-26, *consigne absente*) : l'argument est arrivé sous la forme `[--ameliorer]`, la syntaxe d'usage recopiée telle quelle ; le skill dit comment lire des dates mal écrites, pas une option entre crochets. L'orchestrateur l'a lue comme active et l'a écrit sous « Erreurs » du bilan. *En cause* : `.claude/skills/boucle/SKILL.md:5` (`argument-hint`, options entre crochets), `:14` (règles de lecture des arguments). *Occurrences* : B2, orchestrateur. **traité** (2026-10-26 : une option entre crochets vaut l'option sans crochets, `.claude/skills/boucle/SKILL.md:14` ; crochets à ne pas taper, `run.md`, section `/boucle`). -- **Ligne `total toutes` du benchmark : plusieurs espaces** (2026-10-26, *format*) : le skill et l'upgrader citent la ligne `total toutes`, mais `benchmark.py` aligne ses colonnes (`{cas:8}{k:24}`, vérifié : `.claude/skills/boucle/benchmark.py:67`) et écrit `total toutes` (vérifié dans `benchmark-fin.txt`) ; un `grep 'total toutes'` ne la trouve pas. *En cause* : `.claude/skills/boucle/SKILL.md:68`, `:99` ; `.claude/agents/upgrader.md:68` ; `.claude/skills/boucle/benchmark.py:67`. *Occurrences* : B2, orchestrateur. +- **Ligne `total toutes` du benchmark : plusieurs espaces** (2026-10-26, *format*) : le skill et l'upgrader citent la ligne `total toutes`, mais `benchmark.py` aligne ses colonnes (`{cas:8}{k:24}`, vérifié : `.claude/skills/boucle/benchmark.py:67`) et écrit `total toutes` (vérifié dans `benchmark-fin.txt`) ; un `grep 'total toutes'` ne la trouve pas. *En cause* : `.claude/skills/boucle/SKILL.md:68`, `:99` ; `.claude/agents/upgrader.md:68` ; `.claude/skills/boucle/benchmark.py:67`. *Occurrences* : B2, orchestrateur. **traité** (2026-10-26 : ligne `total` de la catégorie `toutes`, lue par `grep -E '^total +toutes'`, `.claude/skills/boucle/SKILL.md` §5 et §7, `.claude/agents/upgrader.md` « Benchmark » ; script inchangé). - **`inventaire.py --debut/--fin` : un trou en bord de fenêtre n'est pas compté** (2026-10-26, *commande*) : la fenêtre affichée va de la première à la dernière mesure présente, et les pas absents ne sont cherchés qu'« entre deux instants présents » (vérifié : `agents/diagnostic/outils/inventaire.py:81-86`) ; sur le lot, la fenêtre s'est affichée « → 2026-09-13T04:00Z », avec « Pas absents… (aucun) », alors que les 44 dernières heures du lot sont sans mesure. Le skill de lecture promet « les pas absents datés » de la fenêtre, sans cette réserve. L'analyste a daté le trou par la ligne des mesures manquantes de toute la période et par `ls` des images. *En cause* : `agents/diagnostic/outils/inventaire.py:82`, `:84-85` ; `.claude/skills/lire-les-donnees/SKILL.md:21`. *Occurrences* : B2 lot 01 analyste. -- **« La catégorie en cause doit monter au score » : impossible pour un trou** (2026-10-26, *contradiction*) : upgrader et validateur jugent une modification à la catégorie en cause qui monte au score ; or `score.py` ne compte pas les trous (« Un trou n'a pas de mesure, donc pas de case », vérifié : `.claude/skills/boucle/score.py:11`). Pour la suggestion S1 (un trou en fin de lot), les deux ont jugé sur la sortie de la commande du lot et sur le benchmark. *En cause* : `.claude/agents/upgrader.md:46` ; `.claude/agents/validateur.md:22` ; `.claude/skills/boucle/score.py:11`. *Occurrences* : B2 lot 01 upgrader ; B2 lot 01 validateur. +- **« La catégorie en cause doit monter au score » : impossible pour un trou** (2026-10-26, *contradiction*) : upgrader et validateur jugent une modification à la catégorie en cause qui monte au score ; or `score.py` ne compte pas les trous (« Un trou n'a pas de mesure, donc pas de case », vérifié : `.claude/skills/boucle/score.py:11`). Pour la suggestion S1 (un trou en fin de lot), les deux ont jugé sur la sortie de la commande du lot et sur le benchmark. *En cause* : `.claude/agents/upgrader.md:46` ; `.claude/agents/validateur.md:22` ; `.claude/skills/boucle/score.py:11`. *Occurrences* : B2 lot 01 upgrader ; B2 lot 01 validateur. **traité** (2026-10-26 : pour un trou, sans case au score, le bon sens se lit à la commande du lot, sans baisse nette du score ni du benchmark : `.claude/agents/upgrader.md` « Vérifie », `.claude/agents/validateur.md` question 2, spec `boucle-automatique.md` « Score »). - **Contrat `detect(mesures)` inchangé, mais le détecteur a besoin de la fin de la fenêtre** (2026-10-26, *contradiction*) : pour dater un trou qui court jusqu'à la fin du lot (S1), `trous` doit connaître la fin de la fenêtre, que `detect(mesures)` ne reçoit pas. L'upgrader a ajouté un paramètre facultatif `fin=None` à `trous.detect` et à `categories.evenements` (selon l'agent ; `categories` ne le passe qu'à `trous`), sans savoir si c'est un changement de contrat ; le validateur a accepté. *En cause* : `.claude/agents/upgrader.md:37` ; `.claude/agents/validateur.md:24`. *Occurrences* : B2 lot 01 upgrader. -- **Étiquettes du lot contraires au diagnostic figé d'un cas : aucune règle** (2026-10-26, *consigne absente*) : l'analyste du lot étiquette `cible_masquee` une cible rejetée à toutes les mesures (S2), alors que C-001 et C-005 étiquettent le même état « aucune catégorie » (selon l'upgrader : `etiquetage.md` de chaque cas, et `agents/diagnostic/cas/C-005/cas.md:32`). Ni l'upgrader ni le builder n'ont de consigne pour ce cas : l'upgrader a suivi « pas de recul net du benchmark » et annulé ; le builder n'a créé aucun cas, jugeant que c'est à l'utilisateur de trancher. Le fond (événement ou état à ne pas dire) est une question d'étiquetage pour l'utilisateur ; la difficulté du processus est l'absence de conduite à tenir. *En cause* : `.claude/agents/upgrader.md:46`, `:48` ; `.claude/agents/builder.md:17`. *Occurrences* : B2 lot 01 upgrader ; B2 lot 01 builder. +- **Étiquettes du lot contraires au diagnostic figé d'un cas : aucune règle** (2026-10-26, *consigne absente*) : l'analyste du lot étiquette `cible_masquee` une cible rejetée à toutes les mesures (S2), alors que C-001 et C-005 étiquettent le même état « aucune catégorie » (selon l'upgrader : `etiquetage.md` de chaque cas, et `agents/diagnostic/cas/C-005/cas.md:32`). Ni l'upgrader ni le builder n'ont de consigne pour ce cas : l'upgrader a suivi « pas de recul net du benchmark » et annulé ; le builder n'a créé aucun cas, jugeant que c'est à l'utilisateur de trancher. Le fond (événement ou état à ne pas dire) est une question d'étiquetage pour l'utilisateur ; la difficulté du processus est l'absence de conduite à tenir. *En cause* : `.claude/agents/upgrader.md:46`, `:48` ; `.claude/agents/builder.md:17`. *Occurrences* : B2 lot 01 upgrader ; B2 lot 01 builder. **traité** (2026-10-26 : conduite écrite, sans trancher le fond : l'upgrader laisse le benchmark primer et met la contradiction dans « Pas corrigé » (`.claude/agents/upgrader.md` « Vérifie ») ; le builder la note « déjà connue (C-00x) » avec la contradiction (`.claude/agents/builder.md:17`, spec « Le builder ») ; l'étiquetage reste à l'utilisateur). -- **« Un cas a déjà la signature » : celle de l'index ou celle de la fiche ?** (2026-10-26, *consigne floue*) : la consigne fait comparer la nouveauté à l'index, la fiche seulement « si tu hésites » ; ici le phénomène n'est que dans la fiche de C-005 (« État sur toute la période »), pas dans sa ligne d'index. Le builder a compté la fiche, et vérifié sur les données du cas. *En cause* : `.claude/agents/builder.md:17`. *Occurrences* : B2 lot 01 builder. +- **« Un cas a déjà la signature » : celle de l'index ou celle de la fiche ?** (2026-10-26, *consigne floue*) : la consigne fait comparer la nouveauté à l'index, la fiche seulement « si tu hésites » ; ici le phénomène n'est que dans la fiche de C-005 (« État sur toute la période »), pas dans sa ligne d'index. Le builder a compté la fiche, et vérifié sur les données du cas. *En cause* : `.claude/agents/builder.md:17`. *Occurrences* : B2 lot 01 builder. **traité** (2026-10-26 : la signature est celle de la ligne d'index ou de la fiche, fiche des cas proches à ouvrir : `.claude/agents/builder.md:17`, spec `boucle-automatique.md` « Le builder »). ## /aiguiser diff --git a/run.md b/run.md index 46f0a5e..dd941aa 100644 --- a/run.md +++ b/run.md @@ -37,6 +37,7 @@ Dans une session Claude Code neuve, **en mode auto**, à la racine de Support-Ag /boucle data/ --du --au [--ameliorer] ``` +- Les crochets marquent une option facultative : taper `--ameliorer` sans eux (avec, l'orchestrateur la lit quand même comme active). - ``, `` : jours UTC, `AAAA-MM-JJ`, `` exclu (la plage s'arrête à `` 00:00). Découpée en lots de 4 jours (`--lot ` pour changer) ; un seul lot : sa plage seule, par exemple `--du 2026-09-01 --au 2026-09-05`. - Sans `--du` ni `--au` : toute la période du dossier. Chaque 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). diff --git a/vues-deplacements/contexte/boucle-automatique.md b/vues-deplacements/contexte/boucle-automatique.md index 9e71395..3ff0780 100644 --- a/vues-deplacements/contexte/boucle-automatique.md +++ b/vues-deplacements/contexte/boucle-automatique.md @@ -79,7 +79,7 @@ La critique est un skill à part, à la demande de l'utilisateur ; on peut aussi **Étiquettes** (D-061, ajoutées le 2026-10-25) : juste après sa lecture, avant la sortie des détecteurs, l'analyste écrit aussi `etiquettes.json`, une entrée par moment de sa lecture (début, fin, capteurs, catégorie du journal, événement de la carte s'il est établi, preuve vue ou déduite), contrôlée par `.claude/skills/critiquer-lot/etiquettes.py` ; le format est dans `critiquer-lot`. Elles ne dépendent pas des détecteurs : ce sont les labels d'un futur modèle appris (point 44 du plan), à garder même si une modification est annulée. Toutes les étiquettes : `vues-deplacements/boucle/*/lot-*/etiquettes.json`. -**Score** (D-062, point 45 du plan, ajouté le 2026-10-25) : le but de la boucle est la précision de la détection sur tout le lot (l'utilisateur). `python3 .claude/skills/boucle/score.py ` 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`) ; l'upgrader et le validateur le relancent après une modification : la catégorie en cause monte sur ce lot, sans baisse nette sur les lots d'avant. 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/` : l'upgrader ne peut pas le modifier. +**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`) ; l'upgrader et le validateur le relancent après une modification : la catégorie en cause monte sur ce lot, sans baisse nette sur 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/` : l'upgrader ne peut pas le modifier. **Benchmark** (D-069, point 48 du plan, ajouté le 2026-10-26 à la demande de l'utilisateur) : chaque cas 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 cas 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) ; l'upgrader le relance et le validateur le lit : un recul net est un défaut, une hausse un plus, pas un but (sur une dizaine de cas, les détecteurs se régleraient sur eux, choix de l'utilisateur). Le builder donne ses étiquettes à chaque cas créé (`anonymiser.py --etiquettes`) ; C-001 à C-005 ont reçu les leurs d'un passage unique de l'analyste, corrigé par leur fiche (leur `etiquetage.md`). Limite : un cas appris ne contient que l'événement ± 6 h, sans les 3 jours d'historique d'un lot. @@ -108,7 +108,7 @@ Il sait que l'upgrader est passé : il lit la critique, la modification et le di 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 l'upgrader et le validateur peuvent en noter aussi (l'utilisateur : « pendant toutes ces phases »). - **Une seule base** (l'utilisateur) : `agents/diagnostic/cas/`, à côté de C-001 à C-005 ; numéro suivant de l'index (`C-006`…), comme `/nouveau-cas`. -- **Un cas par genre d'événement, pas par occurrence** *(choix de Claude)* : si l'index a déjà un cas de même signature, rien. +- **Un cas par genre d'événement, pas par occurrence** *(choix de Claude)* : si un cas 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 cas est « déjà connue », la contradiction dite pour l'utilisateur. - Sinon, un cas de la même forme que C-001 à C-005 : données de la fenêtre de l'événement, avec une marge, copiées et codées par `anonymiser-cas` ; fiche du §11.3 (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 cas existants. Il ne passe pas par `/nouveau-cas` (ni passage à l'aveugle, ni validation) : les cas appris s'ajoutent sans attendre (l'utilisateur : « ça ne peut pas vraiment faire de mal »).