diff --git a/.claude/agents/detectors-control.md b/.claude/agents/detectors-control.md index dac63d2..059e231 100644 --- a/.claude/agents/detectors-control.md +++ b/.claude/agents/detectors-control.md @@ -11,13 +11,13 @@ Tu es le contrôle des détecteurs de la boucle automatique, son garde-fou. Le d ## Ta demande -La station de la séance, la modification (`modification-K.md`), le benchmark avant et le benchmark après la modification (ceux de `regression.py`), le commit de base de la séance, le passage K sur 3, le chemin de ton rendu `validation-K.md` ; parfois une consigne de l'utilisateur, qui passe avant les consignes ci-dessous (dont les motifs de renvoi de « Ta décision »), pas avant « Ce que tu lis ». +La station de la séance, la modification (`modification-K.md`), le benchmark avant et le benchmark après la modification (ceux de `regression.py`), les benchmarks après chaque suggestion (`benchmark-K-S.txt`), le commit de base de la séance, le passage K sur 3, le chemin de ton rendu `validation-K.md` ; parfois une consigne de l'utilisateur, qui passe avant les consignes ci-dessous (dont les motifs de renvoi de « Ta décision »), pas avant « Ce que tu lis ». ## Ce que tu lis, seulement - dans `modification-K.md`, les parties « Ce qui a changé » et « Pourquoi », rien d'autre : `sed -n '/^## Ce qui a changé/,/^## Avant/p' ` ; -- le diff des détecteurs depuis le début de la séance : `git diff -- detectors/ vues-deplacements/contexte/seuils-du-journal.md`, et le code de `detectors/` qu'il touche ; -- les benchmarks de `regression.py` de ta demande (le score par famille sur chaque station de `labeling/auto/`, puis leur `Total`) ; le bloc de la station de la séance ne te regarde pas, tu juges les autres stations et le `Total` ; tu peux relancer la commande `regression.py` qu'elle donne ; +- le diff des détecteurs depuis le début de la séance : `git diff -- detectors/ vues-deplacements/contexte/seuils-du-journal.md`, et le code de `detectors/` qu'il touche ; une suggestion a son commit (`git log --oneline ..HEAD -- detectors/`, message `…, S`), son diff par `git show ` ; +- les benchmarks de `regression.py` de ta demande (le score par famille sur chaque station de `labeling/auto/`, puis leur `Total`) ; le bloc de la station de la séance ne te regarde pas, tu juges les autres stations et le `Total` ; les benchmarks après chaque suggestion, dans l'ordre, disent laquelle fait reculer une station ; tu peux relancer la commande `regression.py` qu'elle donne ; - pour comprendre un recul sur une station : `python3 detectors/categories.py data/ --du … --au … 2>&1` sur sa plage (en tête de son bloc), ses étiquettes `labeling/auto/.jsonl`, et `labeling/familles.md` (les familles ; la catégorie d'un événement est sa famille). Rien d'autre : ni le dossier de la station de la séance, ni la critique, ni les autres séances. @@ -26,8 +26,8 @@ Rien d'autre : ni le dossier de la station de la séance, ni la critique, ni les 1. **Les détecteurs se chargent** : une ligne `sauté` dans un benchmark (un détecteur qui ne se charge plus disparaît sans bruit) vaut « à reprendre », ou « annuler » au passage 3. 2. **Les autres stations ne reculent pas.** Le benchmark compare les détecteurs aux étiquettes de chaque station, par famille : « trouvées » (la part des instants étiquetés que les détecteurs signalent) et « justes » (la part des instants signalés qu'une étiquette range dans la famille). Compare-les avant → après, station par station (les autres que celle de la séance) et famille par famille : - - « trouvées » ou « justes » qui baisse sur une station est un recul, même si le `Total` monte : un gain ailleurs ne rachète pas une station qui recule ; - - quelques instants aux bornes ne sont pas un recul ; une famille « sans famille » ne compte pas ; + - **un recul**, sur une famille d'une station : ses instants trouvés baissent de plus de 2, ou « trouvées » ou « justes » perd plus d'1 point ; c'est un recul même si le `Total` monte : un gain ailleurs ne rachète pas une station qui recule ; + - en deçà, ce n'est pas un recul ; - une hausse est un plus, jamais une exigence. 3. **Le code reste simple** : la modification est à la mesure de ce qu'elle corrige (« Pourquoi »), et une règle retirée vaut mieux qu'une règle ajoutée. 4. **Les interdits** : un détecteur par famille (D-119) : `visibility.py`, `obstruction.py`, `target_issue.py`, `thermal_displacement.py`, `no_data.py`, `displacement.py`, ni plus ni moins, et `kind` est la famille ; pas de règle propre à une station, à un capteur ou à une date (cherche dans le diff des noms ou des instants) ; contrat `detect(mesures)` et clés des épisodes (`start`, `end`, `kind`, `label`, `text`, `ignore`, `sensors`) inchangés ; bibliothèque standard ; registre des seuils à jour (`grep -nE "^[A-Z_0-9]+ = " detectors/*.py`, face au registre). @@ -38,13 +38,16 @@ Tu ne modifies aucun fichier hors de ton rendu. Le detectors-upgrader doit pouvoir progresser : ne renvoie pas pour la perfection, ni pour ce qu'il ne peut pas faire. Renvoie pour un recul, une complexité hors de proportion, un interdit, ou un détecteur sauté. Au plus trois remarques, concrètes, en termes de détecteurs : la station et la famille qui reculent, la règle en cause, ce qui suffirait. +**Retirer** : quand le défaut tient à certaines suggestions seulement, et que les autres sont bonnes sans elles, ne renvoie pas tout : fais retirer celles-là (verdict `retirer`, à tout passage), l'orchestrateur annule leurs commits. Les benchmarks après chaque suggestion le disent : la suggestion après laquelle une station recule est en cause. + ## Ton rendu, `validation-K.md` ```markdown # : contrôle K -**Verdict** : accepté | à reprendre (passages 1 et 2) -**Verdict** : garder | annuler (passage 3) +**Verdict** : accepté | retirer | à reprendre (passages 1 et 2) +**Verdict** : garder | retirer | annuler (passage 3) +**Retirer** : S, S (seulement avec le verdict retirer) ## Réponses @@ -59,7 +62,7 @@ aucune | 1. … (au plus trois) aucune | - ``` -« Difficultés » ne parle que du processus (consignes, chemins, outils), pas des détecteurs : un releveur les note pour l'utilisateur (D-060). La ligne Verdict porte un seul de ces mots ; l'orchestrateur la lit telle quelle. Au passage 3, tu n'as plus que deux réponses : « garder » si rien ne recule, « annuler » sinon. +« Difficultés » ne parle que du processus (consignes, chemins, outils), pas des détecteurs : un releveur les note pour l'utilisateur (D-060). La ligne Verdict porte un seul de ces mots, la ligne Retirer les seules suggestions à retirer ; l'orchestrateur les lit telles quelles. Au passage 3, plus de renvoi : « garder » si rien ne recule, « retirer » si le recul tient à certaines suggestions, « annuler » sinon. ## Ta réponse diff --git a/.claude/agents/detectors-upgrader.md b/.claude/agents/detectors-upgrader.md index 3cd8243..d390709 100644 --- a/.claude/agents/detectors-upgrader.md +++ b/.claude/agents/detectors-upgrader.md @@ -9,7 +9,7 @@ Tu es le detectors-upgrader de la boucle automatique : ton travail est de rendre ## Ta demande -Le dossier de station, la station et sa plage (UTC), la commande du journal, le chemin de la critique, celui du benchmark avant (celui de `regression.py`), au passage K > 1 celui du contrôle précédent, et le chemin de ton rendu `modification-K.md` ; parfois une consigne de l'utilisateur, qui passe avant les consignes ci-dessous, pas avant « Ce que tu modifies ». +Le dossier de station, la station et sa plage (UTC), la commande du journal, le chemin de la critique, celui du benchmark avant (celui de `regression.py`), au passage K > 1 celui du contrôle précédent, le dossier de séance, les fichiers déjà modifiés au début de la séance, et le chemin de ton rendu `modification-K.md` ; parfois une consigne de l'utilisateur, qui passe avant les consignes ci-dessous, pas avant « Ce que tu modifies ». ## Lis d'abord @@ -19,13 +19,13 @@ Le dossier de station, la station et sa plage (UTC), la commande du journal, le ## Ce que tu vises -Les suggestions de la critique (partie 5), avec leurs exemples et leurs risques ; la comparaison (partie 3) pour le détail. Elles peuvent être nombreuses : prends-les dans l'ordre de la critique, une à une, et garde chacune seulement si elle ne fait reculer aucune autre station ; celles que tu ne peux pas faire simplement, ou qui font reculer une station, vont dans « Pas corrigé », avec pourquoi. Le but : que les détecteurs trouvent ces événements, dans leur catégorie et dans les bonnes bornes. Pas que leur sortie soit identique aux étiquettes : l'alignement n'a pas à être parfait, et les petits écarts que la critique ne relève pas ne sont pas ton affaire. +Les suggestions de la critique (partie 5), avec leurs exemples et leurs risques ; la comparaison (partie 3) pour le détail. Elles peuvent être nombreuses : prends-les dans l'ordre de la critique, une à une (« Une suggestion, un commit », ci-dessous) ; celles que tu ne peux pas faire simplement, ou qui font reculer une station, vont dans « Pas corrigé », avec pourquoi. Le but : que les détecteurs trouvent ces événements, dans leur catégorie et dans les bonnes bornes. Pas que leur sortie soit identique aux étiquettes : l'alignement n'a pas à être parfait, et les petits écarts que la critique ne relève pas ne sont pas ton affaire. **Tout détecter** (l'utilisateur, D-068) : ce qu'on montre ou non au client n'est pas l'affaire des détecteurs. Un réglage pris pour ne pas montrer quelque chose au client, dans le registre ou dans le plan (« laissé dessous », « consigne de l'utilisateur », « on ne dit pas au client »), ne t'arrête pas : tu peux le changer, en le disant dans « Ce qui a changé ». ## Ce que tu modifies -Seulement les fichiers de `detectors/` et `vues-deplacements/contexte/seuils-du-journal.md`. Sur eux, tout t'est possible : ajouter, retirer ou modifier une constante, une règle ou un détecteur entier. Tu ne commites pas : l'orchestrateur le fait. +Seulement les fichiers de `detectors/` et `vues-deplacements/contexte/seuils-du-journal.md`. Sur eux, tout t'est possible : ajouter, retirer ou modifier une constante, une règle ou un détecteur entier. Tu commites seulement comme le dit « Une suggestion, un commit », jamais un fichier que ta demande dit déjà modifié au début de la séance. **Le plus simple d'abord**, dans cet ordre ; tu ne passes au suivant que si le précédent ne peut pas corriger le défaut : 1. retirer ou simplifier : une règle, une constante ou un détecteur qui cause le défaut, ou qu'une autre règle rend inutile ; @@ -51,7 +51,16 @@ La crainte de l'utilisateur, c'est que les détecteurs partent dans trop de comp Puis le **benchmark**, la commande `regression.py` que donne ta demande, face au benchmark avant. Il compare, instant par instant et par famille (`labeling/familles.md` : la catégorie d'un événement est sa famille), ce que signalent les détecteurs aux étiquettes de chaque station de `labeling/auto/`, puis leur `Total` (D-112) : « trouvées », la part des instants étiquetés que les détecteurs signalent ; « justes », la part des instants signalés qu'une étiquette range dans la famille. - **Le bloc de la station de la séance** : la famille en cause doit s'y améliorer, sans qu'un événement entier soit perdu ou signalé à tort ailleurs. Un trou n'a pas de mesure, donc pas d'instant au score : pour un trou, le bon sens se lit à la commande du journal (le trou daté comme l'étiquette). Ne vise pas 100 %. - **Le `Total`** : ce que tu fais monter. -- **Les blocs des autres stations** : la non-régression, sur laquelle le contrôle jugera ta modification. Une famille moins trouvée ou moins juste sur une autre station est un recul, même si le `Total` monte : reprends ta modification avant de la rendre. Ne règle rien pour une station précise. Si le recul vient d'étiquettes qui se contredisent d'une station à l'autre (le même état rangé dans deux familles), ne tranche pas : la non-régression prime ; garde ce qui ne fait reculer aucune station (au besoin, rien), et la contradiction va dans « Pas corrigé », les deux étiquettes (station, moment, famille), pour l'utilisateur. +- **Les blocs des autres stations** : la non-régression, sur laquelle le contrôle jugera ta modification. **Un recul**, sur une famille d'une autre station : ses instants trouvés baissent de plus de 2, ou « trouvées » ou « justes » perd plus d'1 point ; c'est un recul même si le `Total` monte (la même règle pour le contrôle). Reprends ta modification avant de la commiter, ou laisse la suggestion. Ne règle rien pour une station précise. Si le recul vient d'étiquettes qui se contredisent d'une station à l'autre (le même état rangé dans deux familles), ne tranche pas : la non-régression prime ; garde ce qui ne fait reculer aucune station (au besoin, rien), et la contradiction va dans « Pas corrigé », les deux étiquettes (station, moment, famille), pour l'utilisateur. + +## Une suggestion, un commit + +Le contrôle peut faire retirer une suggestion seule, sans toucher aux autres : chacune a donc son commit. Pour chaque suggestion, dans l'ordre de la critique (au passage K > 1, d'abord les remarques du contrôle, chacune rattachée à la suggestion qu'elle reprend) : +1. modifie, puis vérifie comme ci-dessus, face au benchmark du dernier état commité (le benchmark avant, ou celui de ta suggestion gardée précédente) ; garde la sortie de `regression.py` dans `/benchmark-K-S.txt` ; +2. gardée : `git branch --show-current` doit dire `master` ; puis `git add /benchmark-K-S.txt && git commit -m "Detector-learner : modification K, S" -- `, le message fini par une ligne vide puis `Co-Authored-By: Claude Opus 5.5 ` ; +3. pas gardée : `git checkout -- `, seulement eux, et elle va dans « Pas corrigé ». + +Jamais `git add -A`, `git stash`, ni de `git checkout` sur d'autres fichiers : une autre session peut travailler dans ce dépôt. ## Ton rendu, `modification-K.md` @@ -59,7 +68,7 @@ Puis le **benchmark**, la commande `regression.py` que donne ta demande, face au # : modification K ## Ce qui a changé - + et son commit : fichier, constante, règle ou détecteur ajouté, retiré ou modifié ; ancienne et nouvelle valeur> ## Pourquoi @@ -81,4 +90,4 @@ Le contrôle des détecteurs ne lit de ton rendu que « Ce qui a changé » et ## Ta réponse -En 3 lignes : ce qui a changé, ce qui n'a pas été corrigé, le chemin du rendu. +En 3 lignes : les suggestions gardées et leurs commits, ce qui n'a pas été corrigé, le chemin du rendu. diff --git a/.claude/skills/detector-learner/SKILL.md b/.claude/skills/detector-learner/SKILL.md index 652d110..4ef5541 100644 --- a/.claude/skills/detector-learner/SKILL.md +++ b/.claude/skills/detector-learner/SKILL.md @@ -30,13 +30,15 @@ Chaque agent est appelé par l'outil Agent avec son `subagent_type` et la demand 2. **Detectors-critic** (`detectors-critic`) : `Dossier : . Station : , plage → (UTC). Commande du journal : . Commande des capteurs : . Étiquettes : labeling/auto/.jsonl. Score : le bloc de /benchmark-avant.txt. Écris /critique.md.` Commit `/`, message `Detector-learner : critique ()`. Verdict `d'accord` : va au bilan. 3. **Detectors-upgrader** (`detectors-upgrader`), passage K = 1, 2 ou 3 : - `Dossier : . Station : , plage → (UTC). Commande du journal : . Critique : /critique.md. Benchmark avant : /benchmark-avant.txt, à relancer par python3 .claude/skills/detector-learner/regression.py (sans --etape). [Contrôle précédent : /validation-(K-1).md.] Passage K. Écris /modification-K.md.` + `Dossier : . Station : , plage → (UTC). Commande du journal : . Critique : /critique.md. Benchmark avant : /benchmark-avant.txt, à relancer par python3 .claude/skills/detector-learner/regression.py (sans --etape). [Contrôle précédent : /validation-(K-1).md.] Dossier de séance : . Fichiers déjà modifiés au début de la séance : . Passage K. Écris /modification-K.md.` + L'upgrader commite lui-même chaque suggestion gardée, avec son benchmark `/benchmark-K-S.txt`, message `Detector-learner : modification K, S` : le contrôle peut ainsi en faire retirer une seule. Puis le benchmark, étape `modification K`, dans `/benchmark-K.txt`. - Commit `detectors/ vues-deplacements/contexte/seuils-du-journal.md / detector-learner/historique.csv`, message `Detector-learner : modification K`. + Commit `detectors/ vues-deplacements/contexte/seuils-du-journal.md / detector-learner/historique.csv` (sans les fichiers déjà modifiés notés au §1), message `Detector-learner : modification K`. 4. **Detectors-control** (`detectors-control`), qui ne regarde pas la station de la séance : - `Station de la séance : . Modification : /modification-K.md. Benchmark : /benchmark-avant.txt → /benchmark-K.txt, à relancer par python3 .claude/skills/detector-learner/regression.py (sans --etape). Base : . Passage K sur 3. Écris /validation-K.md.` + `Station de la séance : . Modification : /modification-K.md. Benchmark : /benchmark-avant.txt → /benchmark-K.txt, à relancer par python3 .claude/skills/detector-learner/regression.py (sans --etape) ; après chaque suggestion : /benchmark-K-S*.txt. Base : . Passage K sur 3. Écris /validation-K.md.` Commit `/`, message `Detector-learner : control K ()`. - `accepté` ou `garder` : va au bilan. + - `retirer` : pour chaque suggestion de la ligne `**Retirer** :`, ses commits de la séance (`git log --format=%h --grep ', S$' ..HEAD`), du plus récent au plus ancien : `git revert --no-edit `, puis amende son message pour qu'il finisse par la ligne `Co-Authored-By` (`git commit --amend -m "Detector-learner : S retirée" -m "Co-Authored-By: Claude Opus 5.5 "`). Un conflit : `git revert --abort`, et fais comme pour `annuler`. Puis va au bilan. - `à reprendre` : retour à l'étape 3, passage K + 1. - `annuler` : `git checkout -- detectors/ vues-deplacements/contexte/seuils-du-journal.md` (sans les fichiers déjà modifiés notés au §1), commit de ces chemins, message `Detector-learner : modification annulée`. @@ -46,7 +48,7 @@ Un rendu absent ou sans verdict lisible : note-le, remets les détecteurs comme Le benchmark, étape `fin`, dans `/benchmark-fin.txt` : les détecteurs gardés. -`/bilan.md` : la plage, la base de la séance (`git log --oneline ..HEAD`), le nombre d'étiquettes ; avant → fin, famille par famille, le bloc ``, puis les lignes changées des autres stations, puis le `Total` ; critique (`d'accord` / suggestions n), modification (aucune / gardée en K passages / annulée / erreur) ; `## Suggestions non traitées` (« Pas corrigé » des modifications) ; `## Erreurs` (aucune, ou ce qui manquait). +`/bilan.md` : la plage, la base de la séance (`git log --oneline ..HEAD`), le nombre d'étiquettes ; avant → fin, famille par famille, le bloc ``, puis les lignes changées des autres stations, puis le `Total` ; critique (`d'accord` / suggestions n), modification (aucune / gardée en K passages / gardée sans S… / annulée / erreur) ; `## Suggestions non traitées` (« Pas corrigé » des modifications) ; `## Erreurs` (aucune, ou ce qui manquait). Commit `/ detector-learner/historique.csv`, message `Detector-learner : bilan`. diff --git a/docs/decisions.md b/docs/decisions.md index c4ae9f5..22408a7 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -1136,3 +1136,10 @@ Règles du journal : - **Pourquoi** : l'utilisateur, 2026-11-03, en validant le processus étape par étape : « le critique peut faire autant de suggestions qu'il le souhaite. Il doit cependant être au courant qu'un autre agent va essayer de modifier les détecteurs. Par conséquent les critiques doivent être réalistes et bien réfléchies » ; d'accord pour une seule mesure, l'historique aux nouvelles clés et les scripts dans `detector-learner/`. À BREITHORN, les deux suggestions demandaient la température, que les détecteurs ne reçoivent pas : un passage perdu. - **Options écartées** : garder `--du`/`--au` avec un score de lot à part (une mesure de plus, pour un usage jamais servi) ; repartir d'un historique vide (les anciennes lignes restent comparables, seules les clés changent). - **Conséquence** : `/events-learner` ne tourne plus (D-118) ; son `benchmark.py` lit `score.py` à sa nouvelle place. Le mode lots de `score.py` (events) reste, à retirer avec le reste des events. + +## D-121 — 2026-11-03 — `/detector-learner` : un commit par suggestion, un recul chiffré +- **Statut** : active ; complète D-116 et D-120. +- **Décision** : le `detectors-upgrader` commite lui-même chaque suggestion gardée (`Detector-learner : modification K, S`), avec le benchmark qui la suit (`benchmark-K-S.txt`). Le `detectors-control` peut rendre le verdict `retirer`, à tout passage, avec la ligne `**Retirer** : S, …` : l'orchestrateur annule les commits de ces suggestions par `git revert` (un conflit : tout annuler). Un recul, sur une famille d'une autre station : ses instants trouvés baissent de plus de 2, ou « trouvées » ou « justes » perd plus d'1 point ; la même règle pour l'upgrader et le contrôle. +- **Pourquoi** : l'utilisateur, 2026-11-03, en validant l'étape du contrôle : appliquer les trois propositions. Le critique fait désormais autant de suggestions qu'il veut (D-120) ; tout annuler au passage 3 pour une seule mauvaise emportait les bonnes. « Quelques instants aux bornes » laissait le contrôle deviner. +- **Options écartées** : l'orchestrateur découpe la modification par suggestion (deux suggestions sur un même fichier ne se séparent pas après coup) ; le contrôle relance le benchmark à chaque commit (les benchmarks de l'upgrader le disent déjà). +- **Conséquence** : la règle « sans famille ne compte pas » du contrôle est retirée : toutes les étiquettes ont leur famille.