Loop: commit sessions directly on master (D-070)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
784b044012
commit
a614010292
7 files changed
+19
-11
No files matched your search
@@ -14,7 +14,7 @@ Tu es l'orchestrateur. Tu découpes la plage en lots, tu appelles les quatre age
|
||||
- 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) ; `--lot` (jours, 4 par défaut). 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.
|
||||
- `python3 agents/diagnostic/outils/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`.
|
||||
- `git switch -c boucle/<SEANCE>_<STATION>` ; les fichiers modifiés de l'utilisateur suivent 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.
|
||||
- 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.
|
||||
- Dossier de séance : `vues-deplacements/boucle/<SEANCE>_<STATION>/`, ci-dessous `<séance>`.
|
||||
|
||||
## 2. Les lots
|
||||
@@ -61,7 +61,7 @@ Un rendu absent après son agent, ou sans ligne de verdict lisible : note-le pou
|
||||
```markdown
|
||||
# Séance <SEANCE> : <STATION>, <début> → <fin> (UTC)
|
||||
|
||||
Branche : boucle/<SEANCE>_<STATION>
|
||||
Commits : sur `master`, depuis <base de la séance> (`git log --oneline <base de la séance>..HEAD`)
|
||||
|
||||
Score : au début de chaque lot `lot-NN/score-avant.txt`, en fin de séance `score-fin.txt` (D-062).
|
||||
|
||||
@@ -94,4 +94,4 @@ Si `git status --short docs/ameliorations-processus.md` montre un changement : c
|
||||
|
||||
`python3 .claude/skills/boucle/comparaison.py <dossier> <séance>` : la page de fin de séance, `out/boucle_<SEANCE>_<STATION>.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 branche, 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 (`<séance>/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. Reste sur la branche : l'utilisateur la fusionne, en garde une partie ou revient en arrière.
|
||||
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 (`<séance>/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. Tout est sur `master`, rien n'est poussé : l'utilisateur annule ce qu'il ne garde pas par `git revert`.
|
||||
@@ -17,7 +17,7 @@ Agent de diagnostic proactif pour **AIMsight**, un système de surveillance opti
|
||||
- **Cellular (D-030 à D-032, D-037), en pause en attendant le spécialiste** : WEISSHORN (mise en service le 19/08, puis quelques incidents isolés) et NORDEND (109 jours, 11 coupures de la liaison) explorés ; `DAILY_LINK_STATE` et `DAILY_SIGNAL_STATE` en prototype, sans cas de l'expert ; deux corrections de `DAILY_LINK_STATE` retenues sur le principe mais non codées ; couleur du jour codée (`src/cellular/day_color.py`, matrice lien × signal `docs/cellular/matrice-lien-signal.drawio` : Red si des envois manquent et que le signal n'est pas mesuré 20 h sur 24) ; livré en prototype avant les réponses du spécialiste (D-039) : figure du site `src/cellular/final.py`, bloc de la vue client, notification support, guide `docs/cellular/guide/`. Reprise : `docs/cellular/domaine/questions-pour-l-expert.md`.
|
||||
- **Temperature (D-040)** : jeux de travail WEISSHORN et NORDEND (VERMONT n'a pas le GPU) ; `DAILY_GPU_TEMPERATURE_LIMIT` en prototype, sans cas de l'expert : une moyenne horaire du GPU ≥ 97,5 °C (limite du Jetson Nano, carte supposée) dans les 24 dernières heures ; couleur du jour codée (`src/temperature/day_color.py` : Red si atteinte, sinon Green, pas d'orange) ; tous les jours Green (maximum 57,2 °C) ; livré en prototype (D-041) : figure du site `src/temperature/final.py`, bloc de la vue client, notification support, guide `docs/temperature/guide/`. Constats, pistes et questions dans `docs/temperature/domaine/point-de-depart.md`.
|
||||
- **Dev container (D-038)** : Docker Engine dans WSL, `.devcontainer/` (Python 3.14, plotly, matplotlib, réseau de l'hôte) ; prépare la communication avec la caméra, en attente de la doc de l'API REST.
|
||||
- **Journal du matin (D-056), le cap actuel** : retour au simple, côté support : une anomalie de déplacement est tout ce qui rend les courbes non plates : presque toujours sans gravité, un moment où il ne faut pas se fier aux données (pluie, buée, train, toile d'araignée, turbulence…), parfois grave, un vrai mouvement (Barcelone : la voûte du pont s'affaisse) ; onglet `Journal` de la maquette Explore : courbes nettoyées en mm (px au choix), la brute en gris dans les zones à ignorer, frise « What happened » dépliable par catégorie, journal en cartes aux phrases catégoriques, bouton `▶ Images` ; un détecteur élémentaire par fichier dans `vues-deplacements/detectors/` (`visibilite`, `sauts`, `thermique`, `turbulence`, `trous`, contrat `detect(mesures)`), réglés sur les cas C-001 à C-005, classés en onze catégories par `categories.py` (aussi outil de tri en lot, toujours 3 jours d'historique) ; prototypé dans Support-Agent ; contexte dans `vues-deplacements/contexte/` (brainstorming `journal-du-matin.md`, seuils, lissage, données et boucle), carte des événements `docs/displacement/domaine/carte-des-evenements.md` ; pompage `extraction/pomper.py` (métriques système, déplacements et images, un fichier par jour, relance sans re-télécharger ; lecture seule, lancé une fois par l'utilisateur le 2026-10-26, NORDEND sur 2 jours, identique aux exports reçus ; sortie dans `data/`, hors de git, D-065 ; application de référence : `~/monitoring-dashboard`) ; boucle automatique `/boucle <dossier>` (D-057, construite, fonctionnement validé ; lancée par l'utilisateur seul, lot par lot, sur de nouvelles données) : analyste, upgrader, validateur et builder, lot après lot, tout commité sur une branche par séance, chaque lot laissant les étiquettes de l'analyste, `etiquettes.json`, labels d'un futur modèle appris (D-061), et le score des détecteurs face à toutes les étiquettes, mesure par mesure, qui juge chaque modification (`.claude/skills/boucle/score.py`, D-062), et une page de fin de séance, l'analyste face aux détecteurs sur toute la plage (`comparaison.py`, D-066), et un benchmark des détecteurs sur la base de cas, chacun avec son diagnostic figé, versionné dans un historique (`benchmark.py`, D-069) (spec `vues-deplacements/contexte/boucle-automatique.md`) ; tout le suivi est dans le plan `docs/superpowers/plans/2026-10-23-journal-du-matin.md`.
|
||||
- **Journal du matin (D-056), le cap actuel** : retour au simple, côté support : une anomalie de déplacement est tout ce qui rend les courbes non plates : presque toujours sans gravité, un moment où il ne faut pas se fier aux données (pluie, buée, train, toile d'araignée, turbulence…), parfois grave, un vrai mouvement (Barcelone : la voûte du pont s'affaisse) ; onglet `Journal` de la maquette Explore : courbes nettoyées en mm (px au choix), la brute en gris dans les zones à ignorer, frise « What happened » dépliable par catégorie, journal en cartes aux phrases catégoriques, bouton `▶ Images` ; un détecteur élémentaire par fichier dans `vues-deplacements/detectors/` (`visibilite`, `sauts`, `thermique`, `turbulence`, `trous`, contrat `detect(mesures)`), réglés sur les cas C-001 à C-005, classés en onze catégories par `categories.py` (aussi outil de tri en lot, toujours 3 jours d'historique) ; prototypé dans Support-Agent ; contexte dans `vues-deplacements/contexte/` (brainstorming `journal-du-matin.md`, seuils, lissage, données et boucle), carte des événements `docs/displacement/domaine/carte-des-evenements.md` ; pompage `extraction/pomper.py` (métriques système, déplacements et images, un fichier par jour, relance sans re-télécharger ; lecture seule, lancé une fois par l'utilisateur le 2026-10-26, NORDEND sur 2 jours, identique aux exports reçus ; sortie dans `data/`, hors de git, D-065 ; application de référence : `~/monitoring-dashboard`) ; boucle automatique `/boucle <dossier>` (D-057, construite, fonctionnement validé ; lancée par l'utilisateur seul, lot par lot, sur de nouvelles données) : analyste, upgrader, validateur et builder, lot après lot, tout commité directement sur `master` (D-070), chaque lot laissant les étiquettes de l'analyste, `etiquettes.json`, labels d'un futur modèle appris (D-061), et le score des détecteurs face à toutes les étiquettes, mesure par mesure, qui juge chaque modification (`.claude/skills/boucle/score.py`, D-062), et une page de fin de séance, l'analyste face aux détecteurs sur toute la plage (`comparaison.py`, D-066), et un benchmark des détecteurs sur la base de cas, chacun avec son diagnostic figé, versionné dans un historique (`benchmark.py`, D-069) (spec `vues-deplacements/contexte/boucle-automatique.md`) ; tout le suivi est dans le plan `docs/superpowers/plans/2026-10-23-journal-du-matin.md`.
|
||||
- **Prochaine étape** : **journal du matin (D-056)** : les points du plan encore en attente (pompage, première séance de la boucle par l'utilisateur, test « Claude verrait la même chose », portage), sur les consignes de l'utilisateur, dans d'autres conversations ; un point validé n'est plus repris ; ensuite, **déplacements (D-052 à D-055)** : détection mécanique des anomalies (D-055) : onglet `Displacements` de la maquette Explore, les sauts (brutaux et qui durent, retours compris) et les tendances (dérive lente et régulière), ce que regarde le client ; le survol d'une ligne les montre sur les courbes, échelle fixe (2026-10-19) ; très expérimental, seuils provisoires, sur NORDEND seuls PR17 et PR06 les passent, nettement (`vues-deplacements/contexte/detection-d-anomalies.md`) ; suite : la suite des retours de l'utilisateur, puis les pistes notées (accélération, cible qui se sépare de ses voisines) ; maquette de la page Explore (`vues-deplacements/maquette/`, cas NORDEND, D-054) : onglet View pour les images (glisseur, comparaison à ±24 h, `error_value` sur chaque capteur, gros plan des cibles avec les images d'avant et d'après), onglet Diagnosis pour les données (déplacements en mm et `error_value` des cibles choisies sur une plage, demande à l'agent composée sans être lancée) ; vérifiée par captures, clics à essayer, état dans `vues-deplacements/maquette/spec.md` ; cas NORDEND laissé là le 2026-10-16, PR17 sans explication claire (`vues-deplacements/cas/2026-10_NORDEND/parcours.md`) ; suite, à la demande de l'utilisateur : la sortie de l'agent dans la page, les annotations d'épisodes (à croiser avec l'agent), d'autres cas ; `cellular` : l'utilisateur voit avec le spécialiste les questions de `docs/cellular/domaine/questions-pour-l-expert.md` (cadence des envois, articulation des deux corrections de `DAILY_LINK_STATE`, retenues mais non codées, cas annotés) ; ensuite les corrections, à reporter dans le guide ; `storage` : les réponses de l'expert (seuils, disque plein, purge, cas), puis les seuils et le guide ; `temperature` : confirmer la carte et ses seuils sur une station (question 1 de `docs/temperature/domaine/point-de-depart.md`), puis le guide si la limite change ; repérer d'autres champs à notifier ; étape 1 du rapport d'agents (pilote manuel Energy sur l'historique de VERMONT, il faut une clé API Anthropic) ; mise en forme du manuel avec le plugin Interactive Docs (dans une autre conversation) ; choisir avec l'équipe du site le format d'intégration du graphique ; maquettes : poursuivre côté client pas à pas, puis côté support (points ouverts dans D-022 et D-039) ; agent de diagnostic : ses outils propres, pour plus de précision (dans une autre conversation), et l'utilisateur valide le rapport du second passage sur PS des Coudres (§7 de sa spec) ; d'autres cas de la base, quand l'utilisateur les apporte et le demande.
|
||||
|
||||
## Analyses (domaine Energy)
|
||||
@@ -108,7 +108,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .
|
||||
|
||||
- `Handoff.md` (~150 l) : cadrage du product owner (reçu le 2026-10-25) : sous-projet G, santé des sites et notifications au client (domaines de mesure, étiquette de responsabilité, « consistent with », traductions, sécurité de production). À lire avant de concevoir côté client ou notifications, **par section** ; sa dernière section liste les écarts constatés avec ce dépôt, à arbitrer par l'utilisateur.
|
||||
- `README.md` (40 l) : point d'entrée pour un humain. `run.md` : les commandes génériques, pompage (dans le dev container de l'appli), `/aiguiser` et `/boucle`.
|
||||
- `docs/decisions.md` (730 l, D-001 à D-065) : décisions **projet**, au format ADR allégé (statut, décision, pourquoi, options écartées, conséquence). À consulter avant de changer d'orientation ou de reproposer une option : elle a peut-être déjà été écartée.
|
||||
- `docs/decisions.md` (770 l, D-001 à D-070) : décisions **projet**, au format ADR allégé (statut, décision, pourquoi, options écartées, conséquence). À consulter avant de changer d'orientation ou de reproposer une option : elle a peut-être déjà été écartée.
|
||||
- `docs/domaine/` : savoir métier commun, une note courte (< 50 l) par question.
|
||||
- `ce-que-mesure-la-station.md` : format CSV, métriques et unités, consommation mesurée mais pas l'apport.
|
||||
- `pieges-des-donnees.md` : trou ≠ coupure, signatures d'une coupure, seuils absolus, cycle jour/nuit.
|
||||
|
||||
@@ -755,3 +755,10 @@ Règles du journal :
|
||||
- **Pourquoi** : demande de l'utilisateur, après un relevé du releveur : au premier lot d'une station, le score n'a pas de lot d'avant, et rien ne mesurait un recul sur les cas où les seuils avaient été réglés. Le diagnostic de l'agent pris pour référence, ce sont ses étiquettes : elles sont faites pour être mesurées (l'utilisateur).
|
||||
- **Options écartées** : comparer les sorties de `categories.py` sur les cas, en texte (ajouté le même jour, sans chiffre ni historique) ; prendre pour référence le rapport de l'agent de diagnostic (D-046, du texte) ; faire du benchmark un but de l'upgrader (sur une dizaine de cas, les détecteurs se régleraient sur eux).
|
||||
- **Conséquence** : un cas a un fichier de plus ; le score des détecteurs sur la base se suit version par version. Limite : un cas appris ne contient que l'événement ± 6 h, sans les 3 jours d'historique d'un lot ; le benchmark mesure les détecteurs sur ce que le cas contient.
|
||||
|
||||
## D-070 — 2026-10-26 — Boucle : la séance commite directement sur `master`
|
||||
- **Statut** : active ; remplace la branche par séance de D-057.
|
||||
- **Décision** : `/boucle` se lance sur `master` et y commite chaque étape, par chemin, comme avant ; ailleurs, l'orchestrateur le dit et s'arrête (pas de `git switch`, une autre session peut travailler dans le dépôt). Il note la base de la séance (`git rev-parse HEAD`) dans `bilan.md` ; rien n'est poussé. Les branches `boucle/…` des deux premières séances (NORDEND, CLARIDEN) sont fusionnées dans `master` et supprimées.
|
||||
- **Pourquoi** : demande de l'utilisateur ; une branche par séance laissait des branches à fusionner après chaque séance, alors que les étiquettes et les cas sont gardés de toute façon.
|
||||
- **Options écartées** : basculer seul sur `master` en début de séance (dérangerait une autre session dans le même dépôt).
|
||||
- **Conséquence** : annuler une modification d'une séance passe par `git revert` de ses commits, depuis la base notée dans le bilan.
|
||||
@@ -1190,3 +1190,4 @@ Une ligne par séance : date, point(s) traités, ce qui a changé, ce qui reste.
|
||||
- 2026-10-26 : point 48 : l'utilisateur dit oui aux trois choix ; benchmark construit (D-069) : étiquettes dans chaque cas, `benchmark.py`, historique, branché dans `/boucle` et `/nouveau-cas` ; reste la relecture des étiquettes de C-001 à C-005 par l'utilisateur.
|
||||
- 2026-10-26 : point 43 : métriques système dans `data/<SERIE>/metrics/` (demande de l'utilisateur) ; `pomper.py` y écrit, `load_stations` y lit aussi ; fichiers de CLARIDEN et NIEDERHORN déplacés.
|
||||
- 2026-10-26 : point 48 : tout au même endroit (l'utilisateur) : le rendu d'étiquetage de chaque cas devient `etiquetage.md` dans son dossier (C-001 à C-005 déplacés, C-006 à C-008 écrits par `anonymiser.py`, qui l'écrit désormais avec `--etiquettes`) ; `vues-deplacements/benchmark/` ne garde que l'historique.
|
||||
- 2026-10-26 : point 31 : `/boucle` commite directement sur `master` (demande de l'utilisateur, D-070) ; branches des séances NORDEND et CLARIDEN fusionnées dans `master` et supprimées.
|
||||
@@ -40,8 +40,8 @@ Dans une session Claude Code neuve, **en mode auto**, à la racine de Support-Ag
|
||||
- `<DEBUT>`, `<FIN>` : jours UTC, `AAAA-MM-JJ`, `<FIN>` exclu (la plage s'arrête à `<FIN>` 00:00). Découpée en lots de 4 jours (`--lot <jours>` 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).
|
||||
- La séance tourne seule, sans question, sur une branche `boucle/<séance>_<SERIE>`, un commit par étape : analyste, upgrader et validateur si l'analyste a des suggestions, builder s'il y a des nouveautés, puis le releveur, qui note les difficultés dans `docs/ameliorations-processus.md` (rien à demander). Les fichiers modifiés et non commités suivent sur la branche sans y être commités.
|
||||
- Bilan dans `vues-deplacements/boucle/<séance>_<SERIE>/bilan.md` ; les étiquettes de l'analyste (`lot-*/etiquettes.json`) sont à garder même si on annule une modification. Ensuite : fusionner la branche, n'en garder qu'une partie, ou revenir en arrière.
|
||||
- La séance tourne seule, sans question, à lancer sur `master`, où elle commite directement (D-070), un commit par étape : analyste, upgrader et validateur si l'analyste a des suggestions, builder s'il y a des nouveautés, puis le releveur, qui note les difficultés dans `docs/ameliorations-processus.md` (rien à demander). Les fichiers modifiés et non commités restent sans être commités.
|
||||
- Bilan dans `vues-deplacements/boucle/<séance>_<SERIE>/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_<séance>_<SERIE>.html` s'ouvre (D-066) : les courbes de la plage ; dessous, 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 cas de la base (`agents/diagnostic/cas/C-*/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.
|
||||
|
||||
|
||||
@@ -20,7 +20,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 onze catégories du journal par `detectors/categories.py` (`python3 vues-deplacements/detectors/categories.py <dossier>` : 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 <dossier de station> [--du … --au …]` fait juger les détecteurs du journal, lot après lot, par un analyste, les fait corriger par un upgrader contrôlé par un validateur, et ajoute les nouveautés à la base de cas par un builder ; une séance par branche `boucle/<séance>_<STATION>`, ses rendus dans `boucle/<séance>_<STATION>/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_<séance>.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 de cas (`.claude/skills/boucle/benchmark.py`, historique dans `benchmark/historique.csv`, D-069) ; spec `contexte/boucle-automatique.md`.
|
||||
Boucle automatique (D-057), lancée par l'utilisateur seul, sur les lots qu'il choisit : `/boucle <dossier de station> [--du … --au …]` fait juger les détecteurs du journal, lot après lot, par un analyste, les fait corriger par un upgrader contrôlé par un validateur, et ajoute les nouveautés à la base de cas par un builder ; une séance commitée directement sur `master` (D-070), ses rendus dans `boucle/<séance>_<STATION>/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_<séance>.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 de cas (`.claude/skills/boucle/benchmark.py`, historique dans `benchmark/historique.csv`, D-069) ; spec `contexte/boucle-automatique.md`.
|
||||
|
||||
Aiguiser la lecture (D-059), lancé par l'utilisateur seul, sur les lots qu'il choisit : `/aiguiser <dossier de station> [--du … --au …]` améliore les outils de lecture (`agents/diagnostic/outils/`) 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 par branche `aiguiser/<séance>_<STATION>`, ses rendus dans `aiguiser/<séance>_<STATION>/lot-NN/` et `bilan.md`, hors de tout dossier de station ; spec `contexte/aiguiser-la-lecture.md`.
|
||||
|
||||
|
||||
@@ -41,7 +41,7 @@ L'analyste et le validateur ne laissent rien de durable eux-mêmes : ce sont les
|
||||
|
||||
**Lancement** : `/boucle data/<STATION> [--du AAAA-MM-JJ] [--au AAAA-MM-JJ] [--lot 4]`, par l'utilisateur seul ; un nom de station seul désigne `data/<STATION>/` (D-065) ; `--au` est exclu (la plage s'arrête à `--au` 00:00Z). Sans dates, toute la période du dossier. **L'utilisateur pilote les lots** (2026-10-24) : avec les données en masse, on ne traitera pas tout ; les lots se traitent indépendamment, il choisit lesquels (`--du` / `--au` sur la plage d'un lot pour un seul) ; la manière de les choisir reste à voir. Lots de 4 jours par défaut (l'utilisateur : « 4-5 jours, c'est égal »).
|
||||
|
||||
**Mise en place** *(choix de Claude)*. L'orchestrateur crée la branche `boucle/<AAAA-MM-JJTHHMMZ>_<STATION>` (le nom du dossier de la séance : deux séances le même jour ne se mêlent pas) depuis la branche courante et le dossier de la séance `vues-deplacements/boucle/<AAAA-MM-JJTHHMMZ>_<STATION>/`, hors de tout dossier de station (règle de `vues-deplacements/CLAUDE.md`). Il découpe la plage en lots, les mêmes que les tranches de `categories.py`.
|
||||
**Mise en place** *(choix de Claude)*. L'orchestrateur commite directement sur `master` (D-070 ; d'abord une branche par séance, abandonnée le 2026-10-26) et crée le dossier de la séance `vues-deplacements/boucle/<AAAA-MM-JJTHHMMZ>_<STATION>/` (deux séances le même jour ne se mêlent pas), hors de tout dossier de station (règle de `vues-deplacements/CLAUDE.md`). Il découpe la plage en lots, les mêmes que les tranches de `categories.py`.
|
||||
|
||||
**Pour chaque lot, dans l'ordre** (dossier `lot-NN/` dans celui de la séance) :
|
||||
1. **Analyste** : il écrit `critique.md`. Commit.
|
||||
@@ -52,7 +52,7 @@ L'analyste et le validateur ne laissent rien de durable eux-mêmes : ce sont les
|
||||
|
||||
Le lot suivant tourne avec les détecteurs tels qu'ils sont devenus. À la fin, l'orchestrateur écrit `bilan.md` (§6) et le commite.
|
||||
|
||||
**Comment les agents communiquent** *(choix de Claude, accepté le 2026-10-24)*. Ils ne se parlent pas. Chacun reçoit de l'orchestrateur un prompt court : le dossier de station, les dates du lot, les chemins des fichiers à lire. Il écrit son rendu dans le dossier du lot et répond en quelques lignes (verdict, chemins). L'orchestrateur est le seul à commiter et à changer de branche ; il commite par chemin, pour ne rien emporter d'autre (message `Loop <STATION> lot NN: <rôle> …`). Les agents prennent le modèle et l'effort de la session qui lance `/boucle` (`model: inherit`, sans `effort`, l'utilisateur, 2026-10-26, D-063 ; d'abord sur Opus).
|
||||
**Comment les agents communiquent** *(choix de Claude, accepté le 2026-10-24)*. Ils ne se parlent pas. Chacun reçoit de l'orchestrateur un prompt court : le dossier de station, les dates du lot, les chemins des fichiers à lire. Il écrit son rendu dans le dossier du lot et répond en quelques lignes (verdict, chemins). L'orchestrateur est le seul à commiter ; il commite par chemin, pour ne rien emporter d'autre (message `Loop <STATION> lot NN: <rôle> …`). Les agents prennent le modèle et l'effort de la session qui lance `/boucle` (`model: inherit`, sans `effort`, l'utilisateur, 2026-10-26, D-063 ; d'abord sur Opus).
|
||||
|
||||
**Sans question** : la séance tourne seule jusqu'au bout. Si un agent ne rend pas son fichier, l'orchestrateur le note dans le bilan et passe au lot suivant *(choix de Claude)*.
|
||||
|
||||
@@ -119,7 +119,7 @@ Ajouté le 2026-10-24, commun à tous les processus automatiques. Chaque rendu f
|
||||
|
||||
## 6. Ce que l'utilisateur trouve à la fin
|
||||
|
||||
- La branche `boucle/<AAAA-MM-JJTHHMMZ>_<STATION>` : un commit par étape, lisible avec `git log` ; il la fusionne, n'en garde qu'une partie, ou revient en arrière.
|
||||
- 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 ; cas 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.
|
||||
- `docs/ameliorations-processus.md` : les difficultés du processus relevées pendant la séance.
|
||||
- La page `out/boucle_<séance>.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 ; le score de la séance. Le but, séance après séance : que les deux coïncident.
|
||||
|
||||
Reference in new issue
Block a user