Detectors, loop and sharpening sessions moved to the repo root (D-084)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-28 17:19:51 +01:00
1 parent be8897e38e
commit 4d99585474
691 files changed
+122 -109

No files matched your search

+2 -2
View File
@@ -16,7 +16,7 @@ Le processus (`/boucle` ou `/aiguiser`) et le commit du releveur : `git show <co
1. Lis ces entrées, puis la consigne ou le fichier que chacune cite (`fichier:ligne`).
2. Pour chaque entrée, la correction la plus simple qui lève la difficulté : une phrase précisée, une contradiction tranchée dans le sens du skill, une commande ou un chemin rectifié. La piste de l'entrée, s'il y en a une, est un point de départ, pas un ordre.
3. Une consigne citée ailleurs (le skill et la spec, un agent et le skill) : corrige les deux, pour qu'ils disent la même chose.
4. Un script modifié (`.claude/skills/boucle/*.py`, `.claude/skills/critiquer-lot/*.py`, `vues-deplacements/aiguiser/voir.py`) : relance une fois la commande en cause et vérifie qu'elle passe.
4. Un script modifié (`.claude/skills/boucle/*.py`, `.claude/skills/critiquer-lot/*.py`, `aiguiser/voir.py`) : relance une fois la commande en cause et vérifie qu'elle passe.
5. Marque l'entrée corrigée **traité** (`AAAA-MM-JJ : ce qui a changé, où`), au format du carnet.
## Ce que tu peux modifier
@@ -24,7 +24,7 @@ Le processus (`/boucle` ou `/aiguiser`) et le commit du releveur : `git show <co
Ceux du processus de ta demande, et, pour les mentions **traité**, `docs/ameliorations-processus.md`. Rien d'autre.
- `/boucle` : `.claude/skills/boucle/`, `.claude/skills/critiquer-lot/`, les agents de la boucle (`.claude/agents/analyste.md`, `upgrader.md`, `validateur.md`, `builder.md`, `releveur.md`, `ameliorateur.md`), la spec `vues-deplacements/contexte/boucle-automatique.md`, `run.md` (section `/boucle`).
- `/aiguiser` : `.claude/skills/aiguiser/`, ses agents (`.claude/agents/lecteur.md`, `correcteur.md`, `optimiseur.md`, `releveur.md`, `ameliorateur.md`), `vues-deplacements/aiguiser/voir.py`, la spec `vues-deplacements/contexte/aiguiser-la-lecture.md`, `run.md` (section `/aiguiser`).
- `/aiguiser` : `.claude/skills/aiguiser/`, ses agents (`.claude/agents/lecteur.md`, `correcteur.md`, `optimiseur.md`, `releveur.md`, `ameliorateur.md`), `aiguiser/voir.py`, la spec `vues-deplacements/contexte/aiguiser-la-lecture.md`, `run.md` (section `/aiguiser`).
## Ce que tu laisses
+1 -1
View File
@@ -19,7 +19,7 @@ Tu es le correcteur de `/aiguiser`. Un lecteur lit les données avec un skill de
- le dossier de station : les exports « advanced » de `displacement/`, par tes scripts, et les images de `images/` avec Read ;
- les rendus que ta demande cite, et seulement après avoir écrit ton corrigé pour une lecture lente.
**Tu n'utilises pas** `agent-tools/`, pas même `donnees.py` : ni lancé, ni importé, ni lu ; une erreur de lecture commune passerait inaperçue. Tu ne lis pas `.claude/skills/lire-les-donnees/SKILL.md`, ni les détecteurs (`vues-deplacements/detectors/`), ni la base de cas, ni `CLAUDE.md`, `docs/decisions.md`, les plans, ni rien dans `vues-deplacements/` hors du dossier de station et des rendus que ta demande cite. Si l'environnement t'a fourni un contexte que tu n'as pas ouvert (ex. `CLAUDE.md`), signale-le dans « Sources lues » et ne t'en sers pas.
**Tu n'utilises pas** `agent-tools/`, pas même `donnees.py` : ni lancé, ni importé, ni lu ; une erreur de lecture commune passerait inaperçue. Tu ne lis pas `.claude/skills/lire-les-donnees/SKILL.md`, ni les détecteurs (`detectors/`), ni la base de cas, ni `CLAUDE.md`, `docs/decisions.md`, les plans, ni rien dans `vues-deplacements/`, `aiguiser/` ou `boucle/` hors du dossier de station et des rendus que ta demande cite. Si l'environnement t'a fourni un contexte que tu n'as pas ouvert (ex. `CLAUDE.md`), signale-le dans « Sources lues » et ne t'en sers pas.
## La lecture lente
+1 -1
View File
@@ -18,7 +18,7 @@ Le dossier de station, le lot (début et fin, UTC) ou « toute la période », l
- les deux notes de `docs/domaine/` qu'il cite ;
- le dossier de station, par les outils du skill, et ses images avec Read.
**Rien d'autre** : ni les détecteurs (`vues-deplacements/detectors/`) ni leur sortie, ni la base de cas (`events/`), ni la carte des événements, ni `CLAUDE.md`, `docs/decisions.md`, les plans, ni rien dans `vues-deplacements/` hors du dossier de station. Dans le dossier de ta lecture, n'ouvre aucun autre fichier : corrigé, écarts et modifications y sont, et ils fausseraient la mesure. Si l'environnement t'a fourni un contexte que tu n'as pas ouvert (ex. `CLAUDE.md`), signale-le dans « Sources lues » et ne t'en sers pas. Tu n'écris aucun script.
**Rien d'autre** : ni les détecteurs (`detectors/`) ni leur sortie, ni la base de cas (`events/`), ni la carte des événements, ni `CLAUDE.md`, `docs/decisions.md`, les plans, ni rien dans `vues-deplacements/` hors du dossier de station, ni les autres rendus de `aiguiser/` et `boucle/`. Dans le dossier de ta lecture, n'ouvre aucun autre fichier : corrigé, écarts et modifications y sont, et ils fausseraient la mesure. Si l'environnement t'a fourni un contexte que tu n'as pas ouvert (ex. `CLAUDE.md`), signale-le dans « Sources lues » et ne t'en sers pas. Tu n'écris aucun script.
## Ta lecture
+1 -1
View File
@@ -29,7 +29,7 @@ L'écart (ses défauts d'abord) ; `<lot>/corrige.md` et les scripts du correcteu
- **Interdits** :
- aucun jugement dans ce que rend un outil : ni seuil, ni catégorie, ni « anomalie », ni « normal » ; un outil rend des valeurs, le lecteur juge ;
- rien de propre à une station, à un capteur ou à une date ;
- aucun import des détecteurs (`vues-deplacements/detectors/`) ;
- aucun import des détecteurs (`detectors/`) ;
- bibliothèque standard ; matplotlib, par `.venv/bin/python`, pour les figures seulement.
- **Ne rien casser** : les options et les sorties existantes restent ; les fiches des cas citent des commandes des outils, qui doivent toujours marcher.
- Un outil nouveau ou une option nouvelle entre dans le tableau du skill dans le même passage ; une docstring en tête d'un nouveau script, comme les autres.
+1 -1
View File
@@ -15,7 +15,7 @@ Un cas `C-xxx`, et l'une de ces trois consignes :
1. Lis `events/C-xxx/cas.md`, sa ligne de `events/INDEX.md` et `etiquetage.md` à côté.
2. La station réelle : la ligne `<STATION>,<STATION>,C-xxx` de `.claude/skills/anonymiser-cas/registre.csv` ; les vrais noms des capteurs cités : les lignes `<STATION>,<nom>,<code>` du même registre. Ils sont pour l'utilisateur seulement : jamais dans un fichier du cas.
3. La séance : l'horodatage de l'en-tête de la fiche, dossier `vues-deplacements/boucle/<horodatage>_<STATION>/` ; le lot dont le `builder.md` cite le cas. Lis ce `builder.md` et, dans la `critique.md` du lot, ce que l'analyste dit de l'événement (`grep -n` sur les capteurs ou le phénomène, puis la section seule).
3. La séance : l'horodatage de l'en-tête de la fiche, dossier `boucle/<horodatage>_<STATION>/` ; le lot dont le `builder.md` cite le cas. Lis ce `builder.md` et, dans la `critique.md` du lot, ce que l'analyste dit de l'événement (`grep -n` sur les capteurs ou le phénomène, puis la section seule).
4. Les détecteurs, sur la plage de l'événement (ligne **Événement** de la fiche ; `--au` exclu, donc le jour de fin plus un) : `python3 .claude/skills/boucle/detecteurs.py data/<STATION> --du <AAAA-MM-JJ> --au <AAAA-MM-JJ> --sans-ouvrir` (la page des détecteurs ne s'ouvre pas : l'utilisateur la retrouve dans la page de revue) (sans `data/<STATION>/`, hors de git, sur `events/C-xxx/`). Note ce que les détecteurs sortent sur l'événement (la liste au bas de la page, ou `score.py` si besoin) : le voient-ils, sous quelle catégorie ?
5. Regarde chaque PNG de la fiche : montre-t-il ce que dit sa légende ?
6. Écris la présentation (format ci-dessous) dans `out/revue-cas/C-xxx.md`, puis fais la page de revue, qui s'ouvre chez l'utilisateur : `python3 .claude/skills/revue-cas/page.py C-xxx --du <AAAA-MM-JJ> --au <AAAA-MM-JJ>` (mêmes dates qu'en 4).
+4 -4
View File
@@ -14,18 +14,18 @@ Le dossier de station, le lot (UTC), la commande du lot, le chemin de la critiqu
## Lis d'abord
1. la critique (ses parties 3 et 5 surtout), et la validation précédente s'il y en a une : ses remarques passent avant tout ;
2. `vues-deplacements/CLAUDE.md`, puis le détecteur en cause dans `vues-deplacements/detectors/` et, si besoin, `categories.py` (comment les épisodes deviennent des événements) ;
2. `vues-deplacements/CLAUDE.md`, puis le détecteur en cause dans `detectors/` et, si besoin, `categories.py` (comment les épisodes deviennent des événements) ;
3. `vues-deplacements/contexte/seuils-du-journal.md`, le registre des seuils.
## Ce que tu modifies
Seulement les fichiers de `vues-deplacements/detectors/` et `vues-deplacements/contexte/seuils-du-journal.md`. Rien d'autre. Tu ne commites pas : l'orchestrateur le fait.
Seulement les fichiers de `detectors/` et `vues-deplacements/contexte/seuils-du-journal.md`. Rien d'autre. Tu ne commites pas : l'orchestrateur le fait.
**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. changer une constante ;
2. ajuster une règle existante ;
3. ajouter une règle nouvelle et courte ;
4. en dernier recours, un nouveau détecteur : un fichier de `vues-deplacements/detectors/` avec `detect(mesures)`, comme les autres.
4. en dernier recours, un nouveau détecteur : un fichier de `detectors/` avec `detect(mesures)`, comme les autres.
La crainte de l'utilisateur, c'est que les détecteurs partent dans trop de complexité : un petit gain ne vaut pas une règle de plus. Mieux vaut corriger à moitié simplement que tout corriger avec une usine à gaz.
@@ -37,7 +37,7 @@ La crainte de l'utilisateur, c'est que les détecteurs partent dans trop de comp
- Le contrat `detect(mesures)` et les clés des épisodes (`start`, `end`, `kind`, `label`, `text`, `ignore`, `sensors`) ne changent pas.
- Bibliothèque standard seulement.
**Dans le même changement** : une constante ajoutée ou changée met à jour sa ligne du registre des seuils (« Réglée sur » : le lot qui l'a demandé) et la docstring du détecteur. Contrôle : `grep -nE "^[A-Z_0-9]+ = " vues-deplacements/detectors/*.py`.
**Dans le même changement** : une constante ajoutée ou changée met à jour sa ligne du registre des seuils (« Réglée sur » : le lot qui l'a demandé) et la docstring du détecteur. Contrôle : `grep -nE "^[A-Z_0-9]+ = " detectors/*.py`.
## Vérifie
+1 -1
View File
@@ -14,7 +14,7 @@ Le dossier de station, le lot (UTC), la commande du lot, la critique, le score a
## Ce que tu fais
1. Lis la critique (parties 3 et 5), puis la modification.
2. Lis le diff : `git diff <base> -- vues-deplacements/detectors/ vues-deplacements/contexte/seuils-du-journal.md`.
2. Lis le diff : `git diff <base> -- detectors/ vues-deplacements/contexte/seuils-du-journal.md`.
3. Lance la commande du lot avec `2>&1`. Une ligne `sauté` (un détecteur qui ne se charge plus) vaut « à reprendre », ou « annuler » au passage 3.
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 <dossier>`, 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 :
+3 -3
View File
@@ -15,7 +15,7 @@ Tu es l'orchestrateur. Tu appelles les trois agents dans l'ordre, tu transmets l
- `python3 agent-tools/inventaire.py <dossier>` : 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-077, comme `/boucle`, 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, jamais de `git add -A`, `git stash` ni `git checkout` hors de tes chemins.
- Dossier de séance : `vues-deplacements/aiguiser/<SEANCE>_<STATION>/`, ci-dessous `<séance>`.
- Dossier de séance : `aiguiser/<SEANCE>_<STATION>/`, ci-dessous `<séance>`.
## 2. Le lot
@@ -55,7 +55,7 @@ Rien n'est annulé d'office : le bilan le dit, l'utilisateur décide.
## 4 bis. Ce que rendent les outils
Après les commandes des fiches, avec les outils tels qu'ils sont devenus, sur le lot : `python3 vues-deplacements/aiguiser/voir.py <dossier> --debut <début du lot> --fin <fin du lot> --sortie <lot>/outils` (une page `index.html` : le texte et les figures des cinq outils, la version des outils en tête ; sans agent). Une page en échec ne bloque rien : note-le pour le bilan. Commit `<séance>/`, message `Sharpen <STATION>: pages des outils`.
Après les commandes des fiches, avec les outils tels qu'ils sont devenus, sur le lot : `python3 aiguiser/voir.py <dossier> --debut <début du lot> --fin <fin du lot> --sortie <lot>/outils` (une page `index.html` : le texte et les figures des cinq outils, la version des outils en tête ; sans agent). Une page en échec ne bloque rien : note-le pour le bilan. Commit `<séance>/`, message `Sharpen <STATION>: pages des outils`.
## 5. Imprévus
@@ -98,7 +98,7 @@ Commit `<séance>/bilan.md`, message `Sharpen <STATION>: bilan`.
**Releveur** (`releveur`), une fois, même si tout s'est bien passé : `Processus : /aiguiser (.claude/skills/aiguiser/SKILL.md). Séance : <séance>/ : la section « Difficultés » de chaque rendu du lot, et « Erreurs » du bilan. Difficultés de l'orchestrateur : aucune | <une consigne de ce skill qui t'a fait deviner, une commande qui a échoué…>.` (D-060)
Si `git status --short docs/ameliorations-processus.md` montre un changement : commit de ce chemin, message `Sharpen <STATION>: process difficulties`.
**Améliorateur** (`ameliorateur`), seulement avec `--ameliorer` et si le releveur a commité : `Processus : /aiguiser. Commit du releveur : <commit>.`, le commit pris par `git rev-parse HEAD` juste après celui du releveur (D-076). Puis commit des chemins qu'il a pu toucher, `.claude/skills/aiguiser/ .claude/agents/lecteur.md .claude/agents/correcteur.md .claude/agents/optimiseur.md .claude/agents/releveur.md .claude/agents/ameliorateur.md vues-deplacements/aiguiser/voir.py vues-deplacements/contexte/aiguiser-la-lecture.md run.md docs/ameliorations-processus.md`, seulement ceux que `git status --short` montre changés, message `Sharpen <STATION>: process fixes`. Garde la suite de ce skill telle que tu l'as lue au début.
**Améliorateur** (`ameliorateur`), seulement avec `--ameliorer` et si le releveur a commité : `Processus : /aiguiser. Commit du releveur : <commit>.`, le commit pris par `git rev-parse HEAD` juste après celui du releveur (D-076). Puis commit des chemins qu'il a pu toucher, `.claude/skills/aiguiser/ .claude/agents/lecteur.md .claude/agents/correcteur.md .claude/agents/optimiseur.md .claude/agents/releveur.md .claude/agents/ameliorateur.md aiguiser/voir.py vues-deplacements/contexte/aiguiser-la-lecture.md run.md docs/ameliorations-processus.md`, seulement ceux que `git status --short` montre changés, message `Sharpen <STATION>: process fixes`. Garde la suite de ce skill telle que tu l'as lue au début.
## 8. Réponse finale
+5 -5
View File
@@ -14,14 +14,14 @@ Tu es l'orchestrateur. Tu appelles les quatre agents dans l'ordre, tu transmets
- Arguments : le dossier de station ; un nom de station seul (« Nordend ») désigne `data/<NOM EN MAJUSCULES>/` (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) ; `--ameliorer` (facultatif : en fin de séance, l'améliorateur corrige le processus d'après les relevés du releveur, §6, D-071). **La plage est le lot** (D-072) : une séance traite un seul lot, de la longueur que l'utilisateur a choisie par `--du` / `--au`, sans découpe ; un `--lot` ou `--tranche` donné quand même est ignoré (note-le sous « Erreurs »). 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 agent-tools/inventaire.py <dossier>` : 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 -- <chemins>` 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. Le commit par chemin ne protège pas un fichier que tu commites toi-même : note donc, au début, les fichiers déjà modifiés sur les chemins que la séance commite ou fait tourner, `git status --porcelain -- vues-deplacements/detectors/ vues-deplacements/contexte/seuils-du-journal.md agent-diagnostic/ .claude/skills/anonymiser-cas/registre.csv` ; s'il y en a, liste-les au bilan sous « Erreurs » (les mesures tournent sur eux), ne les commite pas et ne les annule pas : aux étapes 3 et 4 (`annuler`), donne tes chemins fichier par fichier, sans eux (`git diff --name-only <base du lot> HEAD -- <chemins>` liste ceux de la séance).
- Dossier de séance : `vues-deplacements/boucle/<SEANCE>_<STATION>/`, ci-dessous `<séance>`.
- 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 -- <chemins>` 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. Le commit par chemin ne protège pas un fichier que tu commites toi-même : note donc, au début, les fichiers déjà modifiés sur les chemins que la séance commite ou fait tourner, `git status --porcelain -- detectors/ vues-deplacements/contexte/seuils-du-journal.md agent-diagnostic/ .claude/skills/anonymiser-cas/registre.csv` ; s'il y en a, liste-les au bilan sous « Erreurs » (les mesures tournent sur eux), ne les commite pas et ne les annule pas : aux étapes 3 et 4 (`annuler`), donne tes chemins fichier par fichier, sans eux (`git diff --name-only <base du lot> HEAD -- <chemins>` liste ceux de la séance).
- Dossier de séance : `boucle/<SEANCE>_<STATION>/`, ci-dessous `<séance>`.
## 2. Le lot
Un seul lot, numéroté `01` (`NN` ci-dessous) : de `--du` 00:00Z (sinon le premier jour de la « Période des mesures » de l'inventaire, 00:00Z) à `--au` 00:00Z (sinon la fin de cette période). Une date qui déborde cette période y est ramenée (`--du` au premier jour de la période, `--au` au lendemain de son dernier jour), dans les bornes du lot comme dans sa commande, et dite sous « Erreurs » du bilan : hors de la période, il n'y a rien à lire ni à étiqueter. Dossier du lot : `<séance>/lot-01/`, ci-dessous `<lot>`.
**Commande du lot**, donnée telle quelle aux agents : `python3 vues-deplacements/detectors/categories.py <dossier>`, plus `--du` et `--au` s'ils sont donnés. Exemple : `--du 2026-10-05 --au 2026-10-09`.
**Commande du lot**, donnée telle quelle aux agents : `python3 detectors/categories.py <dossier>`, plus `--du` et `--au` s'ils sont donnés. Exemple : `--du 2026-10-05 --au 2026-10-09`.
## 3. Le lot, dans l'ordre
@@ -35,13 +35,13 @@ Chaque agent est appelé par l'outil Agent avec son `subagent_type` et la demand
2. Verdict `d'accord` : va à l'étape 5.
3. **Upgrader** (`upgrader`), passage K = 1, 2 ou 3. Avant le passage 1, note la **base du lot** : `git rev-parse HEAD`.
`Dossier : <dossier>. Lot NN : <début> → <fin> (UTC). Commande du lot : <commande>. Critique : <lot>/critique.md. Score avant : <lot>/score-avant.txt. Benchmark avant : <lot>/benchmark-avant.txt. [Validation précédente : <lot>/validation-(K-1).md.] Passage K. Écris <lot>/modification-K.md.`
Commit `vues-deplacements/detectors/ vues-deplacements/contexte/seuils-du-journal.md <lot>/`, message `Loop <STATION> lot NN: modification K`.
Commit `detectors/ vues-deplacements/contexte/seuils-du-journal.md <lot>/`, message `Loop <STATION> lot NN: modification K`.
Puis, les détecteurs commités : `python3 .claude/skills/boucle/benchmark.py --seance <SEANCE> --etape "lot-NN modification K" > <lot>/benchmark-K.txt 2>&1` (commité avec la validation).
4. **Validateur** (`validateur`) : `Dossier : <dossier>. Lot NN : <début> → <fin> (UTC). Commande du lot : <commande>. Critique : <lot>/critique.md. Score avant : <lot>/score-avant.txt. Modification : <lot>/modification-K.md. Benchmark : <lot>/benchmark-avant.txt → <lot>/benchmark-K.txt. Base : <base du lot>. Passage K sur 3. Écris <lot>/validation-K.md.`
Commit `<lot>/ vues-deplacements/benchmark/historique.csv`, message `Loop <STATION> lot NN: validation K (<verdict>)`.
- `accepté` ou `garder` : va à l'étape 5.
- `à reprendre` : retour à l'étape 3, passage K + 1.
- `annuler` : `git checkout <base du lot> -- vues-deplacements/detectors/ vues-deplacements/contexte/seuils-du-journal.md`, commit de ces deux chemins, message `Loop <STATION> lot NN: modification annulée`.
- `annuler` : `git checkout <base du lot> -- detectors/ vues-deplacements/contexte/seuils-du-journal.md`, commit de ces deux chemins, message `Loop <STATION> 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 : <dossier>. Lot NN : <début> → <fin> (UTC). Dossier du lot : <lot>/. Séance : <séance>/. Écris <lot>/builder.md.`
Si sa ligne `**Cas créés** :` n'est pas `aucun` : commit `events/ .claude/skills/anonymiser-cas/registre.csv <lot>/`, message `Loop <STATION> lot NN: cas C-xxx, …` ; sinon commit `<lot>/`, message `Loop <STATION> lot NN: builder (aucun cas)`.
+2 -2
View File
@@ -7,7 +7,7 @@ que les détecteurs signalent) et « justes » (part des mesures signalées que
somme les catégories (pas les deux niveaux de validité, qui les regroupent). Le benchmark garde les détecteurs
d'un recul : il n'est pas un but (sur une dizaine de cas, les détecteurs se régleraient sur eux).
Avec --etape, chaque ligne entre dans l'historique, vues-deplacements/benchmark/historique.csv, avec la version des
détecteurs (le commit, suivi de « + » si vues-deplacements/detectors/ a des changements non commités) : le score
détecteurs (le commit, suivi de « + » si detectors/ a des changements non commités) : le score
dans le temps, version par version.
Usage : python3 .claude/skills/boucle/benchmark.py [--seance <séance> --etape <étape>]
"""
@@ -33,7 +33,7 @@ TOUTES = "toutes"
def version():
def git(*a):
return subprocess.run(["git", "-C", RACINE, *a], capture_output=True, text=True).stdout.strip()
return git("rev-parse", "--short", "HEAD") + ("+" if git("status", "--porcelain", "--", "vues-deplacements/detectors") else "")
return git("rev-parse", "--short", "HEAD") + ("+" if git("status", "--porcelain", "--", "detectors") else "")
def mesurer():
+3 -3
View File
@@ -11,7 +11,7 @@ section 4) ; « prudence » : visibilité réduite et turbulence ; « fiable »
jamais grisées), et sans catégorie. Un trou n'a pas de mesure, donc pas de case ; un moment « aucune » n'est pas compté.
Le score est un fait, pas un verdict : l'analyste peut se tromper aussi.
Usage : python3 .claude/skills/boucle/score.py <dossier de station> [etiquettes.json ...]
(défaut : vues-deplacements/boucle/*/lot-*/etiquettes.json de la station)
(défaut : boucle/*/lot-*/etiquettes.json de la station)
python3 .claude/skills/boucle/score.py --test
"""
import glob
@@ -22,7 +22,7 @@ from datetime import timedelta
from pathlib import Path
RACINE = os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "..", "..")
sys.path.insert(0, os.path.join(RACINE, "vues-deplacements", "detectors"))
sys.path.insert(0, os.path.join(RACINE, "detectors"))
sys.path.insert(0, os.path.join(RACINE, ".claude", "skills", "critiquer-lot"))
import categories # noqa: E402 (il met lui-même agent-tools sur le chemin)
from donnees import charger, instant, iso # noqa: E402
@@ -152,7 +152,7 @@ if __name__ == "__main__":
test()
elif len(sys.argv) >= 2:
explicites = sys.argv[2:]
tous = sorted(glob.glob(os.path.join(RACINE, "vues-deplacements", "boucle", "*", "lot-*", "etiquettes.json")))
tous = sorted(glob.glob(os.path.join(RACINE, "boucle", "*", "lot-*", "etiquettes.json")))
lots(sys.argv[1], explicites or tous, bool(explicites))
else:
sys.exit(__doc__)
+3 -3
View File
@@ -6,11 +6,11 @@ argument-hint: "<dossier> <début> <fin> <fichier de sortie> [commande du lot]"
# Critiquer un lot
Tu juges, comme un expert, ce que les détecteurs du journal du matin (`vues-deplacements/detectors/`) ont trouvé sur un lot de quelques jours d'une station AIMsight. Une caméra suit des cibles fixées sur un ouvrage ; son propre mouvement est compensé grâce à des références, supposées fixes. Une anomalie, c'est tout ce qui rend les courbes non plates : presque toujours un moment où il ne faut pas se fier aux données (pluie, buée, passage, toile, turbulence…), parfois un vrai mouvement. Tu te fais **ta propre idée d'abord**, puis tu compares : sinon tu ne trouverais jamais ce que les détecteurs ratent. Tu ne modifies rien d'autre que ton fichier et tes figures.
Tu juges, comme un expert, ce que les détecteurs du journal du matin (`detectors/`) ont trouvé sur un lot de quelques jours d'une station AIMsight. Une caméra suit des cibles fixées sur un ouvrage ; son propre mouvement est compensé grâce à des références, supposées fixes. Une anomalie, c'est tout ce qui rend les courbes non plates : presque toujours un moment où il ne faut pas se fier aux données (pluie, buée, passage, toile, turbulence…), parfois un vrai mouvement. Tu te fais **ta propre idée d'abord**, puis tu compares : sinon tu ne trouverais jamais ce que les détecteurs ratent. Tu ne modifies rien d'autre que ton fichier et tes figures.
## La demande
Tu reçois : le dossier de station, le lot (début et fin, UTC), la commande du lot (sinon : `python3 vues-deplacements/detectors/categories.py <dossier> --du <jour du début> --au <jour de la fin>`), le chemin de ta critique. Le dossier de ta critique est `<dossier de sortie>` ci-dessous.
Tu reçois : le dossier de station, le lot (début et fin, UTC), la commande du lot (sinon : `python3 detectors/categories.py <dossier> --du <jour du début> --au <jour de la fin>`), le chemin de ta critique. Le dossier de ta critique est `<dossier de sortie>` ci-dessous.
## Ce que tu as le droit de lire, seulement
@@ -20,7 +20,7 @@ Tu reçois : le dossier de station, le lot (début et fin, UTC), la commande du
- `events/carte-des-evenements.md` : ce qui peut arriver, en familles, et les catégories du journal (section 4 : définition de chacune, éventualités du terrain qui la font, détecteurs ; D-074) ;
- à l'étape 4 seulement, jamais avant : `events/INDEX.md`, puis les fiches `cas.md` qu'il cite et leurs figures.
Rien d'autre : ni `CLAUDE.md`, ni `docs/decisions.md`, ni les plans, ni rien dans `vues-deplacements/` hors du dossier de station (pas de `parcours.md`, pas de `plateforme/`), ni les critiques et bilans d'autres lots, ni le code des détecteurs. Ils contiennent des conclusions sur ces données ; ton jugement doit partir des données. Tu listes tout ce que tu as lu dans « Sources lues ».
Rien d'autre : ni `CLAUDE.md`, ni `docs/decisions.md`, ni les plans, ni rien dans `vues-deplacements/` hors du dossier de station (pas de `parcours.md`, pas de `plateforme/`), ni les séances de `aiguiser/`, ni les critiques et bilans d'autres lots dans `boucle/`, ni le code des détecteurs. Ils contiennent des conclusions sur ces données ; ton jugement doit partir des données. Tu listes tout ce que tu as lu dans « Sources lues ».
## Tes outils
+2 -2
View File
@@ -37,10 +37,10 @@ def station_du_cas(cas):
def lot_d_origine(cas, fiche, station):
m = re.search(r"séance `?(?:vues-deplacements/boucle/)?(\d{4}-\d\d-\d\dT\d{4}Z)", fiche)
m = re.search(r"séance `?(?:boucle/)?(\d{4}-\d\d-\d\dT\d{4}Z)", fiche)
if not m:
return None
for builder in sorted(glob.glob(os.path.join(ROOT, "vues-deplacements", "boucle", f"{m[1]}_{station}", "lot-*", "builder.md"))):
for builder in sorted(glob.glob(os.path.join(ROOT, "boucle", f"{m[1]}_{station}", "lot-*", "builder.md"))):
if re.search(rf"\*\*Cas créés\*\*.*\b{cas}\b", lire(builder)):
return os.path.dirname(builder)
return None
+1 -1
View File
@@ -11,7 +11,7 @@ Un client écrit au support à propos d'un de ses systèmes, souvent avec une ca
Lecture seule : tu n'écris que dans le dossier du cas (§3). Tu ne télécharges aucune donnée, tu n'ajoutes rien à la base de cas, tu ne modifies ni détecteur ni outil.
Commandes : celles de `.claude/skills/lire-les-donnees/SKILL.md` (mêmes conventions : une commande par appel, depuis la racine du dépôt), plus `python3 vues-deplacements/detectors/categories.py <dossier>`, `gif.py` (§4), `mkdir`, `cp` (la capture), `date`, et à la fin `git add`/`git commit` du seul dossier du cas.
Commandes : celles de `.claude/skills/lire-les-donnees/SKILL.md` (mêmes conventions : une commande par appel, depuis la racine du dépôt), plus `python3 detectors/categories.py <dossier>`, `gif.py` (§4), `mkdir`, `cp` (la capture), `date`, et à la fin `git add`/`git commit` du seul dossier du cas.
## 1. Comprendre la demande
+5 -3
View File
@@ -51,7 +51,7 @@ python3 src/energy/focus_jour.py JJ.MM[.AAAA] [données] # un jour et sa veille
python3 maquettes/user/summary.py [début] [fin] # maquette client, une page par station de data/
python3 maquettes/support/home.py [début] [fin] # maquette support
python3 vues-deplacements/maquette/explore.py [dossier] # page Explore : View, Diagnosis, Displacements, Journal
python3 vues-deplacements/detectors/categories.py <dossier> # événements du journal, une ligne chacun
python3 detectors/categories.py <dossier> # événements du journal, une ligne chacun
python3 .claude/skills/boucle/detecteurs.py data/<STATION> [--du D --au F] # page des détecteurs seuls
python3 .claude/skills/boucle/benchmark.py # détecteurs face à la base de cas
pdftotext -layout "docs/aimsight/<fichier>.pdf" - # lire un PDF AIMsight
@@ -68,7 +68,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .
### Lire sans saturer le contexte
- Fichier long (tailles en lignes ci-dessous) : lire son plan (`grep -n '^#' <fichier>`), puis la seule section utile (Read avec `offset` et `limit`).
- `docs/decisions.md` (850 l, D-001 à D-083) : 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` (860 l, D-001 à D-084) : 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/`.
@@ -95,7 +95,9 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .
### Déplacements
- `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), `detectors/` (un détecteur élémentaire par fichier, contrat `detect(mesures)`, classés par `categories.py`, D-067, D-068), `contexte/` (journal du matin, seuils, lissage, boucle, aiguisage), `cas/` (NORDEND, parcours de l'utilisateur), séances `boucle/` et `aiguiser/`, `benchmark/historique.csv` (D-069).
- `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 `<séance>_<STATION>/` (`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 de cas, connaissance métier qui grandit** (D-048, D-080) : `INDEX.md` (le registre), un dossier `C-xxx/` par cas (`cas.md` lisible d'abord par un humain, figures, données codées, `etiquettes.json`), validé par l'utilisateur ou « (appris) » par `/boucle` en attendant `/revue-cas` ; `carte-des-evenements.md` (familles, catégories du journal) et `eventualites-et-categories.drawio`. Un cas n'y entre que par `/nouveau-cas`, lancé par l'utilisateur, ou par le 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/<STATION>/ [question]`.
+3 -1
View File
@@ -43,6 +43,8 @@ Chaque script bascule seul sur `.venv` et ouvre sa page dans le navigateur ; les
| Ce que fait chaque analyse, ses seuils et ses limites | `docs/<domaine>/analyses/<règle>.md` |
| Guides de lecture pour le client et le support | `docs/<domaine>/guide/` |
| Journal du matin : plan de travail, point par point | `docs/superpowers/plans/2026-10-23-journal-du-matin.md` |
| Déplacements : maquette Explore, détecteurs, contexte, séances | `vues-deplacements/` (carte : `vues-deplacements/CLAUDE.md`) |
| Déplacements : maquette Explore, contexte | `vues-deplacements/` (carte : `vues-deplacements/CLAUDE.md`) |
| Détecteurs du journal | `detectors/` |
| Séances de `/boucle` et `/aiguiser` | `boucle/`, `aiguiser/` |
| Base de cas | `events/INDEX.md` |
| Réponses aux clients | `support/` |
+2 -2
View File
@@ -23,7 +23,7 @@ Toute la connaissance du projet sur les déplacements, autant qu'il en faut pour
Pour un long fichier, trouve la section avec `grep -n '^#' <fichier>`, puis lis-la seule (Read avec `offset` et `limit`).
**Ne lis pas** ce qui rend déjà un avis sur des données sans être de la connaissance : les rapports de `agent-diagnostic/rapports/`, `vues-deplacements/` (parcours, séances de la boucle, code des détecteurs : tu lances `categories.py`, tu ne le lis pas), `CLAUDE.md`, `docs/decisions.md`, `docs/superpowers/`. Tu listes dans ton rapport tout ce que tu as lu. Si l'environnement t'a fourni un contexte que tu n'as pas ouvert (ex. `CLAUDE.md`), signale-le dans « Sources lues » et ne t'en sers pas.
**Ne lis pas** ce qui rend déjà un avis sur des données sans être de la connaissance : les rapports de `agent-diagnostic/rapports/`, `vues-deplacements/` (parcours), les séances de `boucle/` et `aiguiser/`, le code des détecteurs (`detectors/` : tu lances `categories.py`, tu ne le lis pas), `CLAUDE.md`, `docs/decisions.md`, `docs/superpowers/`. Tu listes dans ton rapport tout ce que tu as lu. Si l'environnement t'a fourni un contexte que tu n'as pas ouvert (ex. `CLAUDE.md`), signale-le dans « Sources lues » et ne t'en sers pas.
## 3. Tes outils
@@ -32,7 +32,7 @@ Ceux de `.claude/skills/lire-les-donnees/SKILL.md` (lis-le avant tout) : ce qu'i
| Commande | Ce qu'elle rend |
|---|---|
| `python3 vues-deplacements/detectors/categories.py <dossier>` | Les événements des détecteurs du journal du matin, une ligne chacun : début, fin, catégorie (sens : section 4 de la carte des événements), grisé (données à ignorer) ou gardé, nombre de capteurs. Des repères calculés, réglés sur les cas de la base : pars d'eux sans les juger ; ils ne disent ni quels capteurs, ni pourquoi |
| `python3 detectors/categories.py <dossier>` | Les événements des détecteurs du journal du matin, une ligne chacun : début, fin, catégorie (sens : section 4 de la carte des événements), grisé (données à ignorer) ou gardé, nombre de capteurs. Des repères calculés, réglés sur les cas de la base : pars d'eux sans les juger ; ils ne disent ni quels capteurs, ni pourquoi |
Sans `--sortie`, les PNG vont dans `out/diagnostic/` : c'est ton brouillon d'exploration. Avec `--sortie <dossier du rapport>` (§6), ils deviennent des preuves du rapport.
Loaded 100 of 691 files, more files were not shown because too many files have changed in this diff. Show more