From 6be683819e30b4d2fd28d2eb9c8b13416754ec7c Mon Sep 17 00:00:00 2001 From: maxime Date: Sat, 24 Oct 2026 15:14:14 +0200 Subject: [PATCH] Record the automatic loop decision (D-057) Co-Authored-By: Claude Opus 5.5 --- CLAUDE.md | 4 +- docs/decisions.md | 10 + .../plans/2026-10-23-journal-du-matin.md | 32 ++- .../plans/2026-10-24-boucle-automatique.md | 256 ++++++++++++++++++ vues-deplacements/CLAUDE.md | 2 + .../contexte/boucle-automatique.md | 131 +++++++++ .../contexte/journal-du-matin.md | 4 + 7 files changed, 428 insertions(+), 11 deletions(-) create mode 100644 docs/superpowers/plans/2026-10-24-boucle-automatique.md create mode 100644 vues-deplacements/contexte/boucle-automatique.md diff --git a/CLAUDE.md b/CLAUDE.md index 3460361..c1fbf73 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -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/journal/` (`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` (lecture seule, jamais lancé ; application de référence : `~/monitoring-dashboard`) ; 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/journal/` (`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` (lecture seule, jamais lancé ; application de référence : `~/monitoring-dashboard`) ; boucle automatique `/boucle ` (D-057, construite, première séance à lancer) : analyste, upgrader, validateur et builder, lot après lot, tout commité sur une branche par séance (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, boucle Claude, 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 : 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) @@ -144,7 +144,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer . - `storage/` : calcul embarquable `storage_state.py`, `days_until_full.py`, `day_color.py` (D-035) ; plotly : `final.py` (figure du site, D-039), `all_analyses.py` (D-034). - `temperature/` : calcul embarquable `gpu_temperature_limit.py`, `day_color.py` ; plotly : `final.py` (figure du site, D-041), `all_analyses.py` (D-040). - `maquettes/` : maquettes du site en HTML sur données réelles (D-022), Figma seulement sur demande. Un script remplit son gabarit HTML : `user/summary.py` + `summary_template.html` (client, une page par station, un bloc par domaine), `support/home.py` + `home_template.html` (support). Les deux parcourent une liste de domaines (`DOMAINS`, D-039). -- `.claude/` : `rules/analyses.md` (se charge seule, voir « Analyses »), `agents/diagnostic.md` (point d'entrée de l'agent de diagnostic, D-046), `skills/nouvelle-analyse/` (procédure et modèle de fiche), `skills/nouveau-domaine/` (procédure pour un nouveau domaine), `skills/nouveau-cas/` (ajouter un cas à la base de l'agent de diagnostic, lancé par l'utilisateur seul), `skills/anonymiser-cas/` (données d'un cas copiées dans son dossier, noms en codes, registre des codes, D-049, D-050), `settings.json` (lecture de `.env` interdite). +- `.claude/` : `rules/analyses.md` (se charge seule, voir « Analyses »), `agents/diagnostic.md` (point d'entrée de l'agent de diagnostic, D-046), `skills/nouvelle-analyse/` (procédure et modèle de fiche), `skills/nouveau-domaine/` (procédure pour un nouveau domaine), `skills/nouveau-cas/` (ajouter un cas à la base de l'agent de diagnostic, lancé par l'utilisateur seul), `skills/anonymiser-cas/` (données d'un cas copiées dans son dossier, noms en codes, registre des codes, D-049, D-050), `skills/boucle/` et `skills/critiquer-lot/` avec les agents `analyste`, `upgrader`, `validateur`, `builder` (boucle automatique, D-057), `settings.json` (lecture de `.env` interdite). - `vues-deplacements/` : chantier à part des vues des déplacements et de l'agent dans une maquette (D-052) : contexte, cas réels (données, pages de la plateforme, parcours de l'utilisateur), puis le code ; sa carte : `vues-deplacements/CLAUDE.md` ; maquette de la page Explore avec les onglets View et Diagnosis dans `vues-deplacements/maquette/` (D-053, D-054) ; détecteurs du journal du matin dans `vues-deplacements/journal/` (D-056) ; `extraction/` : pompage des données de la plateforme (D-056), à lancer par l'utilisateur dans le dev container de l'application ; brouillon jamais lancé, lecture seule ; mode d'emploi dans `extraction/README.md`. - `.devcontainer/devcontainer.json` : environnement de dev en conteneur (D-038), réseau de l'hôte pour joindre la caméra. `architecture.drawio` : schéma d'architecture tenu par l'utilisateur, à ne pas modifier sans demande. - `out/` : pages et JSON générés. Tout le projet est versionné, sauf `out/`, `.venv/` et `__pycache__/` (D-014). diff --git a/docs/decisions.md b/docs/decisions.md index 3e1ed81..f9a72eb 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -640,3 +640,13 @@ Règles du journal : - **Dérive lente et pistes restantes, le 2026-10-24 (point 16 du plan)** : les tendances de l'onglet `Displacements` (D-055) deviennent des événements « Slow drift » du journal, jamais grisés, en trait rouge fin (« PR06 drifts slowly and steadily: +0.7 mm in 10 days. Keep watching it. ») ; les références masquées sont déjà dites par la phrase de la perte de visibilité (« including the reference targets ») et l'absorption des sauts, sans catégorie à part ; « tout a bougé » contre « références masquées » reste impossible sur les mesures seules (« Shift to check » et images) ; éclairage et neige attendent un cas. - **Lissage, trois questions tranchées le 2026-10-24 (point 24 du plan)** : le client voit **les deux courbes ensemble** : la nettoyée en couleur, coupée dans les zones à ignorer, la brute en gris fin dans ces zones seulement (comme « Target hidden » aujourd'hui) ; le calcul se fait **au moment où le client regarde les courbes**, sur tout ce qui est disponible jusque-là (chaque instant jugé avec ce qui suit, les dernières heures provisoires), et rien n'est écrit dans la base de la plateforme, qu'on ne peut pas modifier à ce stade ; le **cycle thermique reste tel quel** sur les courbes (le journal le nomme), pas de vue « sans le cycle » : l'option D reste en réserve. Détail : `vues-deplacements/contexte/lissage.md`, section 4. - **Historique des détecteurs, règle du 2026-10-24 (point 30 du plan)** : les détecteurs reçoivent toujours **3 jours de mesures d'avant** la plage montrée (s'ils existent), et seuls les événements qui touchent la plage sont montrés ; dans l'outil de tri en lot (`categories.py --tranche`, `--historique 3` par défaut), dans la boucle Claude et dans la vraie application. Pourquoi : les détecteurs prennent leurs niveaux habituels sur la fenêtre qu'on leur donne ; à NORDEND, une tranche de 3 jours sans historique, commencée 2 h 30 avant le vrai saut de PR17 (08/10 à 02:30), le prend pour un saut revenu et l'absorbe dans la buée ; avec 3 jours d'avant, il revient. Option écartée : classer chaque tranche seule. + +## D-057 — 2026-10-24 — Déplacements : la boucle automatique d'amélioration des détecteurs et de la base de cas +- **Statut** : active ; construite le 2026-10-24, première séance à lancer (NORDEND d'octobre). +- **Décision** : + - une commande, `/boucle ` (skill `.claude/skills/boucle/`), découpe la plage en lots de 4 jours (3 jours d'historique, D-056) et, lot après lot, appelle quatre sous-agents sur Opus : l'**analyste** (`critiquer-lot` : sa propre lecture des courbes et des images d'abord, puis la sortie des détecteurs ; verdict « d'accord » ou au plus deux suggestions ; nouveautés), l'**upgrader** (modifie les détecteurs de `vues-deplacements/journal/`, le plus simple d'abord), le **validateur** (vérifie que la modification répond à la critique et va dans le bon sens, **pas trop strict** ; au plus trois passages, puis garder ou annuler), le **builder** (fait des nouveautés des cas de la base `agents/diagnostic/cas/`, un par genre d'événement, marqués « (appris) ») ; + - les agents ne se parlent pas : chacun écrit son rendu dans le dossier du lot (`vues-deplacements/boucle//lot-NN/`), l'orchestrateur le transmet et commite tout, étape par étape, par chemin, sur une branche par séance ; un `bilan.md` à la fin ; + - l'agent de diagnostic n'a aucun rôle dans la boucle : ses consignes ne changent pas ; il sera traité dans une autre conversation. +- **Pourquoi** : l'utilisateur veut qu'après une séance Claude ait appris : de nouveaux cas tirés d'événements réels (la base de connaissances) et des détections optimisées ; tout commité, pour s'y retrouver et revenir en arrière. +- **Options écartées** : rejouer les lots déjà vus après chaque modification (trop lourd ; on explore et on améliore peu à peu, sans exhaustivité) ; une base de cas à part pour les cas appris (tous les cas au même endroit) ; des agents qui se parlent directement ; un agent pour récupérer les données (un dossier de station suffit : pompage ou CSV à la main). +- **Conséquence** : la base de cas s'enrichit aussi par le builder, sans `/nouveau-cas`, ce qui complète D-048 : un cas « (appris) » n'est pas revalidé par l'utilisateur (revalidation à la main, plus tard) ; la crainte de l'utilisateur, la complexité, est la garde de l'upgrader et du validateur (pas de nouvelle catégorie, pas de règle propre à une station). Spec : `vues-deplacements/contexte/boucle-automatique.md` ; plan : `docs/superpowers/plans/2026-10-24-boucle-automatique.md`. diff --git a/docs/superpowers/plans/2026-10-23-journal-du-matin.md b/docs/superpowers/plans/2026-10-23-journal-du-matin.md index 28a615a..2b198bf 100644 --- a/docs/superpowers/plans/2026-10-23-journal-du-matin.md +++ b/docs/superpowers/plans/2026-10-23-journal-du-matin.md @@ -88,7 +88,7 @@ Types : **Comprendre** (lire, expliquer, rien ne change), **Décider** (l'utilis | 28 | Images différentielles | Lancer, Comprendre | 27 | à faire | | 29 | Options B (depuis WSL) et C (route du collègue) | Décider | 27 | en attente | | 30 | L'outil de tri en lot | Coder | 6, 27 | validé le 2026-10-24 | -| 31 | La boucle Claude, première séance | Lancer, Coder | 30 | en attente (consignes de l'utilisateur, données) | +| 31 | La boucle Claude, première séance | Lancer, Coder | 30 | construite (D-057) ; première séance à lancer par l'utilisateur | | 32 | Le test « Claude verrait la même chose » | Lancer | 10 | en attente (autre conversation) | | | **VII. Idées gardées pour plus tard** | | | | | 33 | Les autres métriques de certains projets | Comprendre | 27 | en attente | @@ -96,7 +96,7 @@ Types : **Comprendre** (lire, expliquer, rien ne change), **Décider** (l'utilis | 35 | Un cas de la base par catégorie | Lancer | 5 | en attente | | 36 | Porter le journal dans la vraie application | Coder | 10 | en attente | | | **VIII. Suivi du chantier** | | | | -| 37 | Ménage : commit, `CLAUDE.md`, Mermaid, sorties | Lancer | — | en cours | +| 37 | Ménage : commit, `CLAUDE.md`, Mermaid, sorties | Lancer | — | validé le 2026-10-24 | Chemins conseillés : le plus simple et le plus parlant d'abord, **11 (visibilité simple), 38 (ses statuts : bonne, moyenne, nulle) puis 7 (bouton `Images`)**, qui marchent sans le classement ; le cœur du retour, c'est **5 → 6 → 7 → 8 → 9 → 10** ; les points 1 à 4 se lisent avant si l'on veut d'abord tout comprendre ; le point 27 se lance en parallèle (il n'attend rien). @@ -812,19 +812,28 @@ Rapport de l'agent : `vues-deplacements/contexte/donnees-et-boucle.md`. Script : 7. **Rejeu** : le détecteur modifié est relancé sur **toutes** les tranches déjà vues ; on ne passe à la suite que s'il ne casse rien. 8. **Arrêt** : au plafond, ou quand deux tranches de suite ne donnent plus rien à corriger. -**À décider par l'utilisateur.** -- [ ] Les stations et la plage de la première séance ; le plafond (proposition : 5 tranches par séance). - -**Étapes.** -- [ ] Créer `extraction/plan.md` (stations, tranches, état de chacune). -- [ ] Créer le dossier des revues `vues-deplacements/revues/` (un fichier `__.md` par tranche : événements du tri, verdict de Claude, proposition). -- [ ] Faire une séance au plafond ; résumer à l'utilisateur les propositions ; appliquer seulement celles qu'il accepte (points 11 à 16), puis rejouer. +**Étapes** (remplacées le 2026-10-24 par la conception approuvée, `vues-deplacements/contexte/boucle-automatique.md`, D-057 ; le principe en 8 étapes ci-dessus reste pour l'histoire : plus de plafond, plus de rejeu, les réglages et les cas sans accord préalable). +- [x] Construire la boucle : plan `docs/superpowers/plans/2026-10-24-boucle-automatique.md`, tâches 1 à 6 (skills `boucle` et `critiquer-lot`, agents `analyste`, `upgrader`, `validateur`, `builder`, fenêtre d'`anonymiser.py`, D-057). +- [ ] Première séance (tâche 7 du plan) : l'utilisateur, dans une session neuve en mode auto, lance `/boucle vues-deplacements/cas/2026-10_NORDEND/NORDEND/` ; Claude fait les contrôles de la tâche 7 et résume le bilan. - Règle (point 30, D-056) : chaque tranche est classée avec 3 jours d'historique, le défaut de l'outil. **Fini quand.** Une séance complète a eu lieu et son bilan est dans `donnees-et-boucle.md`. **En attente depuis le 2026-10-24.** L'utilisateur a des consignes plus précises sur la boucle, qu'il donnera dans une autre conversation, et il faut les données (point 27). Rien n'a été créé (ni `extraction/plan.md`, ni `vues-deplacements/revues/`). Proposé puis écarté pour l'instant : une séance à blanc sur NORDEND d'octobre et PS des Coudres, les seuls jeux assez longs pour des tranches. +**Consignes de l'utilisateur reçues le 2026-10-24 (brainstorming en cours, rien de décidé ni construit).** Une boucle automatique dans Claude Code : un skill orchestrateur qui appelle des sous-agents, chacun avec son rôle et ses skills ; une station, plusieurs semaines, découpées en lots de 4 à 5 jours, lots indépendants (en parallèle possible). +- **Données** : un script plutôt qu'un agent, depuis la base ou des CSV téléchargés (pompage du point 27, ou CSV à la main). +- **Analyste** : lance les détecteurs sur le lot, puis juge leurs résultats (« LLM as judge ») en regardant lui-même les données et les images, avec un skill de critique ; verdict positif (lot suivant) ou suggestions. +- **Upgrader** : reprend les suggestions et modifie les détecteurs. +- **Validateur** : ne refait pas l'analyse ; vérifie que la modification répond à ce qu'a relevé l'analyste et va dans le bon sens ; **pas trop strict** (aucune modification n'est parfaite) ; aller-retour avec l'upgrader jusqu'à son accord. +- **Builder** : tout ce que l'analyste découvre de nouveau devient un cas structuré comme ceux de la base, pour les agents de diagnostic (automatiser ce qui se fait aujourd'hui à la main avec `/nouveau-cas`). +- **Ce que la boucle doit laisser** (l'utilisateur) : avoir appris : de nouveaux cas tirés des événements des données (le builder construit la base de connaissances), et des détections optimisées (l'upgrader) ; l'analyste et le validateur sont les juges qui y mènent. +- **Précision** (l'utilisateur) : en cas de doute sur les rôles (surtout entre upgrader et validateur), se fier à ses premières consignes, ci-dessus ; d'autres transcriptions suivront. +- **Rôles reformulés par Claude, acceptés par l'utilisateur le 2026-10-24** (« parfait »), avec les ajouts de Claude : les agents ne se parlent pas, chacun écrit son rendu dans le dossier de la séance et l'orchestrateur le transmet ; au plus 3 allers-retours upgrader / validateur, puis on garde la dernière version qui va dans le bon sens ; plusieurs analystes en parallèle plus tard, l'upgrader toujours seul ; les cas du builder marqués « appris par Claude, non validé », lus par les analystes des lots suivants (même base que les autres, voir plus bas) ; modifications des détecteurs sur une branche git à part ; déplacements seulement. +- **Réponses de l'utilisateur le 2026-10-24** : tout se commite, chaque modification, pour s'y retrouver et revenir en arrière ; le builder ajoute les cas sans attendre (« ça ne peut pas vraiment faire de mal »), une revalidation à la main viendra peut-être plus tard, pas maintenant ; l'upgrader modifie les détecteurs seul, « essayer et voir dans quelle direction ça va » ; **pas de rejeu** des lots déjà vus : on explore des données et on améliore peu à peu, sans chercher l'exhaustif ni tout revalider à chaque fois (remplace le rejeu de l'étape 7 et l'ajout de Claude) ; la crainte : **partir dans trop de complexité**. +- **Conception écrite le 2026-10-24** : `vues-deplacements/contexte/boucle-automatique.md`, **approuvée** par l'utilisateur le 2026-10-24 ; plan de construction : `docs/superpowers/plans/2026-10-24-boucle-automatique.md` (7 tâches) ; rien construit. +- **L'agent de diagnostic n'entre pas en jeu dans la boucle** (l'utilisateur, 2026-10-24) : il n'y a aucun travail, ses consignes ne changent pas ; il sert au diagnostic pour l'utilisateur et sera traité dans une autre conversation. Tous les cas restent au même endroit : le builder complète la base `agents/diagnostic/cas/` (C-006…, marqués « appris »). + ### Point 32 : Le test « Claude verrait la même chose » **Pourquoi.** L'objectif fixé par l'utilisateur : « si je venais donner à Claude ces données, il puisse voir par lui-même qu'on a bien catégorisé les choses » ; notre solution doit dire ce que Claude dirait. @@ -975,3 +984,8 @@ Une ligne par séance : date, point(s) traités, ce qui a changé, ce qui reste. - 2026-10-24 : point 31 mis en attente : l'utilisateur a des consignes plus précises, pour une autre conversation, et il faut les données ; rien créé. - 2026-10-24 : point 32 mis en attente : l'utilisateur le traitera dans une autre conversation. Reste à faire dans l'ordre : point 37 (ménage) ; 33 à 36 en attente. - 2026-10-24 : point 37 fait : `CLAUDE.md` à 199 lignes et à jour, sorties NORDEND séparées, Mermaid déjà rendu au point 3, travail commité ; reste la validation. +- 2026-10-24 : **point 37 validé** par l'utilisateur. Il ne reste que des points en attente : pompage (27 à 29, accès aux données), boucle Claude et test « Claude verrait la même chose » (31, 32, autres conversations), idées pour plus tard (33 à 36). +- 2026-10-24 : point 31 : consignes de l'utilisateur reçues (boucle automatique : analyste, upgrader, validateur, builder) et notées au point 31 ; brainstorming en cours, rien construit. +- 2026-10-24 : point 31 : réponses de l'utilisateur (tout commité, cas ajoutés sans attendre, pas de rejeu, crainte de la complexité) ; conception écrite dans `vues-deplacements/contexte/boucle-automatique.md`, à approuver. +- 2026-10-24 : point 31 : conception approuvée par l'utilisateur (agent de diagnostic hors de la boucle, cas appris dans la base commune) ; plan de construction écrit, `docs/superpowers/plans/2026-10-24-boucle-automatique.md`. +- 2026-10-24 : point 31 : boucle construite (tâches 1 à 6 du plan `2026-10-24-boucle-automatique.md`, D-057) ; reste la première séance sur NORDEND d'octobre, lancée par l'utilisateur. diff --git a/docs/superpowers/plans/2026-10-24-boucle-automatique.md b/docs/superpowers/plans/2026-10-24-boucle-automatique.md new file mode 100644 index 0000000..28773f2 --- /dev/null +++ b/docs/superpowers/plans/2026-10-24-boucle-automatique.md @@ -0,0 +1,256 @@ +# La boucle automatique : plan de construction + +> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. + +**Goal :** une commande `/boucle ` qui, lot après lot, fait juger les détecteurs du journal par un analyste, les fait corriger par un upgrader contrôlé par un validateur, et fait ajouter les nouveautés à la base de cas par un builder, chaque étape étant commitée. + +**Architecture :** un skill orchestrateur (`.claude/skills/boucle/`) lancé dans la conversation principale ; quatre sous-agents Claude Code (`.claude/agents/analyste.md`, `upgrader.md`, `validateur.md`, `builder.md`) qui ne se parlent pas : chacun écrit son rendu dans le dossier du lot, l'orchestrateur le transmet et commite. Presque tout est en Markdown (des consignes) ; le seul code est une option de fenêtre dans `anonymiser.py`. + +**Tech Stack :** Claude Code (skills, sous-agents Opus), Python 3 bibliothèque standard, git ; outils existants : `vues-deplacements/journal/categories.py`, `agents/diagnostic/outils/`, `.claude/skills/anonymiser-cas/`. + +**Spec :** `vues-deplacements/contexte/boucle-automatique.md` (approuvée le 2026-10-24). Point 31 du plan vivant `docs/superpowers/plans/2026-10-23-journal-du-matin.md`. + +## Global Constraints + +- Documents et consignes en français ; heures en UTC partout, au format `AAAA-MM-JJTHH:MMZ` ; texte du site en anglais (les catégories du journal le sont déjà). +- Agents sur Opus (`model: opus`). +- Lots de 4 jours par défaut, 3 jours d'historique (défaut de `categories.py`, D-056). +- L'analyste : au plus **deux** suggestions par lot. L'upgrader : au plus **trois** passages par lot. Le validateur : **pas trop strict** (consigne forte de l'utilisateur), au plus trois remarques. +- Détecteurs : bibliothèque standard ; contrat `detect(mesures)` et clés des épisodes (`start`, `end`, `kind`, `label`, `text`, `ignore`, `sensors`) inchangés ; aucune nouvelle catégorie ; aucune règle propre à une station, un capteur ou une date. +- L'agent de diagnostic n'a aucun rôle : `agents/diagnostic/instructions.md` et `.claude/agents/diagnostic.md` ne changent pas. Les cas existants de `agents/diagnostic/cas/` ne se modifient jamais. +- Tout se commite, étape par étape, par chemin (`git commit -- `), message `Loop lot NN: …` terminé par la ligne `Co-Authored-By: Claude Opus 5.5 `. +- Pas de tests automatiques (D-008) ; on vérifie en lançant (consigne « processus léger ») ; seul `anonymiser.py` a son `--test`. +- Identifiants (`SIM_CCID`, `ip`) jamais recopiés ; lecture seule sur les stations ; pas de données synthétiques. + +## Review Focus + +1. **Agents créés en cours de session** : Claude Code charge `.claude/agents/` au démarrage ; un `subagent_type: analyste` peut être inconnu tant que la session n'a pas redémarré. Attendu : la séance (tâche 7) se lance dans une session neuve ; l'essai de la tâche 1 passe par un sous-agent `general-purpose`. +2. **Détecteur cassé qui disparaît sans bruit** : `categories.py` saute un fichier qui ne se charge pas, avec `Journal : sauté (…)` sur stderr. Attendu : le validateur lance la commande du lot avec `2>&1`, et une ligne `sauté` vaut « à reprendre » (tâche 3). +3. **Analyste influencé** : le dossier de NORDEND d'octobre a, à côté, `parcours.md` (le verdict de l'utilisateur) ; `CLAUDE.md` et le plan citent des conclusions sur ces données. Attendu : l'analyste ne lit que sa liste et la recopie dans « Sources lues » (tâches 1 et 7). +4. **Commit qui emporte autre chose** : l'arbre de l'utilisateur a des fichiers modifiés hors de la boucle. Attendu : chaque commit de la boucle ne touche que ses chemins (tâche 7, `git log --stat`). +5. **Fichiers CSV en fin de ligne `\r\n`** dans la fenêtre d'`anonymiser.py` : attendu, les lignes gardées tel quel (test de la tâche 4). + +--- + +### Task 1 : L'analyste et son skill de critique + +**Files :** +- Create : `.claude/skills/critiquer-lot/SKILL.md` +- Create : `.claude/agents/analyste.md` + +**Interfaces :** +- Consumes : la demande de l'orchestrateur (tâche 5) : `Dossier : . Lot NN : → (UTC). Commande du lot : . Écris /critique.md.` +- Produces : `critique.md`, avec deux lignes que l'orchestrateur lit telles quelles : + - `**Verdict** : d'accord` ou `**Verdict** : suggestions` (une seule, en tête) ; + - un titre `## Nouveautés`, suivi de `aucune` ou d'une liste à puces ; + - suggestions sous `### S1 : ` et `### S2 : `, chacune avec `Défaut`, `Exemple` (moment UTC, capteurs), `Détecteur`, `Ce qu'il faudrait` (en mots, pas en code). + +- [ ] **Step 1 : Écrire `.claude/agents/analyste.md`** + +Frontmatter : `name: analyste`, `description:` (analyste de la boucle `/boucle`, juge les événements des détecteurs du journal sur un lot ; appelé avec un dossier, un lot, une commande et le chemin de sa critique), `tools: Read, Bash, Write`, `model: opus`, `effort: high`, `omitClaudeMd: true`. Corps, sur le modèle de `.claude/agents/diagnostic.md` : « Tu es l'analyste de la boucle. Lis `.claude/skills/critiquer-lot/SKILL.md` et suis-le à la lettre. Ta demande : ce qui suit. » + +- [ ] **Step 2 : Écrire `.claude/skills/critiquer-lot/SKILL.md`** + +Frontmatter : `name: critiquer-lot`, `description:` (juger les événements du journal du matin sur un lot de données de déplacement : lecture propre d'abord, puis comparaison aux détecteurs ; utilisé par l'analyste de `/boucle`, ou à la main), `argument-hint: " "`. Le corps reprend la section « Analyste » de la spec, avec : +- **Ce qu'il a le droit de lire, seulement** : le dossier de station (par les outils, et les images avec Read) ; `docs/domaine/colonnes-des-deplacements.md` (en premier) ; `docs/domaine/pieges-des-donnees.md` ; `docs/displacement/domaine/carte-des-evenements.md` ; à l'étape 4 seulement, `agents/diagnostic/cas/INDEX.md` puis les fiches qu'il cite. Rien d'autre : ni `CLAUDE.md`, ni plans, ni `vues-deplacements/` hors du dossier de station, ni critiques ou bilans d'autres lots. +- **Les six étapes de la spec**, dans l'ordre, l'étape 2 (sortie des détecteurs) seulement après avoir écrit la partie 1 du fichier. Outils : ceux du §3 de `agents/diagnostic/instructions.md` (le recopier en tableau court), avec `--debut`/`--fin` du lot et `--sortie ` pour les figures ; vignettes une toutes les 2 à 3 h, plus serrées là où les courbes bougent. Étape 2 : lancer la commande du lot telle qu'elle est donnée. +- **Le plan du fichier** : titre `# Lot NN : , → (UTC)`, la ligne Verdict, puis `## 1. Ma lecture` (tableau début, fin, capteurs, ce que je vois, catégorie de la carte ou « aucune catégorie »), `## 2. Ce qu'ont trouvé les détecteurs` (sortie brute), `## 3. Comparaison` (une ligne par événement ou moment : juste, catégorie fausse, en trop, bornes fausses, manquant, et pourquoi), `## 4. Cas connus`, `## 5. Suggestions`, `## Nouveautés`, `## Sources lues`. +- **Règles** : il ne modifie rien hors de son fichier et de ses figures ; « d'accord » quand rien d'important n'est à corriger ; une nouveauté, c'est ce que ni la carte ni l'index ne décrivent ; heures en UTC. + +- [ ] **Step 3 : Essai sur le lot 1 de NORDEND d'octobre** + +Lancer un sous-agent `general-purpose` (l'agent `analyste` n'est pas encore chargé) avec : `Lis .claude/skills/critiquer-lot/SKILL.md et suis-le à la lettre. Dossier : vues-deplacements/cas/2026-10_NORDEND/NORDEND/. Lot 01 : 2026-10-05T00:00Z → 2026-10-09T00:00Z (UTC). Commande du lot : python3 vues-deplacements/journal/categories.py vues-deplacements/cas/2026-10_NORDEND/NORDEND/ --du 2026-10-05 --au 2026-10-09 --tranche 4. Écris out/boucle-essai/lot-01/critique.md.` +Attendu : `grep -c '^\*\*Verdict\*\* : \(d.accord\|suggestions\)$' out/boucle-essai/lot-01/critique.md` rend `1` ; `grep -A1 '^## Nouveautés' …` rend `aucune` ou une puce ; au moins un PNG dans `out/boucle-essai/lot-01/` ; « Sources lues » ne cite ni `parcours.md`, ni `CLAUDE.md`, ni un plan. Lire la critique : la buée du 07/10 17:15 → 08/10 12:15 y est (la vérité connue du point 30). Corriger le skill si un attendu manque, puis relancer une fois. + +- [ ] **Step 4 : Commit** + +```bash +git add .claude/skills/critiquer-lot/SKILL.md .claude/agents/analyste.md +git commit -m "Add the loop analyst and its lot critique skill" -- .claude/skills/critiquer-lot/SKILL.md .claude/agents/analyste.md +``` + +### Task 2 : L'upgrader + +**Files :** +- Create : `.claude/agents/upgrader.md` + +**Interfaces :** +- Consumes : `critique.md` (tâche 1) ; au passage K > 1, `validation-(K-1).md` (tâche 3). Demande : `Dossier : . Lot NN : → . Commande du lot : . Critique : . [Validation précédente : .] Passage K. Écris /modification-K.md.` +- Produces : modifications de `vues-deplacements/journal/*.py` et de `vues-deplacements/contexte/seuils-du-journal.md`, rien d'autre ; `modification-K.md` avec `## Ce qui a changé`, `## Pourquoi`, `## Avant / après sur le lot` (sortie de la commande du lot avant et après), `## Pas corrigé`, `## Nouveautés` (`aucune` ou puces). + +- [ ] **Step 1 : Écrire `.claude/agents/upgrader.md`** + +Frontmatter : `name: upgrader`, `description:` (upgrader de `/boucle` : modifie les détecteurs du journal d'après la critique de l'analyste et les remarques du validateur), `tools: Read, Edit, Write, Bash`, `model: opus`. Corps : la section « Upgrader » de la spec, avec : +- lire d'abord la critique (et la validation précédente), le détecteur en cause, `vues-deplacements/contexte/seuils-du-journal.md` et `vues-deplacements/CLAUDE.md` ; +- **le plus simple d'abord**, dans cet ordre : une constante ; une règle existante ajustée ; une règle nouvelle et courte ; un nouveau détecteur (fichier de `vues-deplacements/journal/`, avec `detect(mesures)`) en dernier recours ; +- les interdits des Global Constraints, et : une suggestion qui demande une nouvelle catégorie n'est pas traitée, elle va dans `## Pas corrigé` ; +- une constante ajoutée ou changée met à jour le registre des seuils et la docstring du détecteur dans le même changement (contrôle : `grep -nE "^[A-Z_0-9]+ = " vues-deplacements/journal/*.py`) ; +- lancer la commande du lot avant de modifier et après, `2>&1`, et coller les deux sorties ; aucune ligne `sauté` après ; +- ne pas commiter (l'orchestrateur le fait) ; ne rien toucher d'autre. + +- [ ] **Step 2 : Vérifier le frontmatter** + +Run : `head -6 .claude/agents/upgrader.md` +Expected : `name: upgrader`, `tools: Read, Edit, Write, Bash`, `model: opus`. + +- [ ] **Step 3 : Commit** + +```bash +git add .claude/agents/upgrader.md +git commit -m "Add the loop upgrader agent" -- .claude/agents/upgrader.md +``` + +### Task 3 : Le validateur + +**Files :** +- Create : `.claude/agents/validateur.md` + +**Interfaces :** +- Consumes : `critique.md`, `modification-K.md`, le commit de base du lot. Demande : `Dossier : . Lot NN : → . Commande du lot : . Critique : . Modification : . Base : . Passage K sur 3. Écris /validation-K.md.` +- Produces : `validation-K.md` dont la première ligne utile est, pour K < 3, `**Verdict** : accepté` ou `**Verdict** : à reprendre` ; pour K = 3, `**Verdict** : garder` ou `**Verdict** : annuler`. Puis `## Remarques` (au plus trois, concrètes, ou `aucune`) et `## Nouveautés` (`aucune` ou puces). + +- [ ] **Step 1 : Écrire `.claude/agents/validateur.md`** + +Frontmatter : `name: validateur`, `description:` (validateur de `/boucle` : vérifie qu'une modification des détecteurs répond à la critique de l'analyste et va dans le bon sens, sans être trop strict), `tools: Read, Bash, Write`, `model: opus`. Corps : la section « Validateur » de la spec, mot pour mot sur la consigne « pas trop strict », avec : +- il sait que l'upgrader est passé : lire la critique, la modification, puis `git diff -- vues-deplacements/journal/ vues-deplacements/contexte/seuils-du-journal.md` ; +- lancer la commande du lot avec `2>&1` ; une ligne `sauté` vaut « à reprendre » (ou « annuler » au passage 3) ; +- ne pas refaire l'analyse des images ; ne modifier aucun fichier hors de sa validation ; +- les quatre questions de la spec et les seuls motifs de renvoi qu'elle donne ; au passage 3, seulement « garder » (ça va dans le bon sens) ou « annuler ». + +- [ ] **Step 2 : Vérifier la commande qu'il lancera, sur les détecteurs d'aujourd'hui** + +Run : `python3 vues-deplacements/journal/categories.py vues-deplacements/cas/2026-10_NORDEND/NORDEND/ --du 2026-10-05 --au 2026-10-09 --tranche 4 2>&1 | grep -c sauté` +Expected : `0` + +- [ ] **Step 3 : Commit** + +```bash +git add .claude/agents/validateur.md +git commit -m "Add the loop validator agent" -- .claude/agents/validateur.md +``` + +### Task 4 : Le builder, et la fenêtre d'`anonymiser.py` + +**Files :** +- Modify : `.claude/skills/anonymiser-cas/anonymiser.py` (`anonymiser()`, `_test()`, `__main__`, docstring) +- Modify : `.claude/skills/anonymiser-cas/SKILL.md` (étape 1) +- Create : `.claude/agents/builder.md` + +**Interfaces :** +- Consumes : les `## Nouveautés` des rendus du lot (tâches 1 à 3) ; `donnees.instant`, `donnees.heure_image` (`agents/diagnostic/outils/donnees.py`, déjà importé par le script). +- Produces : + - `anonymiser.py [--du T] [--au T]` (T : `AAAA-MM-JJTHH:MMZ`) : sans fenêtre, comportement d'aujourd'hui ; + - `filtrer_csv(texte: str, du: datetime | None, au: datetime | None) -> str` : garde l'en-tête et les lignes dont le premier champ, lu par `instant`, tombe dans [du, au) ; lignes gardées à l'identique ; + - `garder_image(nom: str, du, au) -> bool` : vrai si `heure_image(nom)` est None ou dans [du, au) ; + - `builder.md` (rendu) : première ligne utile `**Cas créés** : C-006, C-007` ou `**Cas créés** : aucun`, puis une ligne par nouveauté : créée (C-xxx) ou déjà connue (C-xxx). + +- [ ] **Step 1 : Ajouter les tests à `_test()`** + +```python + du, au = instant("2026-10-07T12:00Z"), instant("2026-10-08T00:00Z") + txt = "time_utc,x\n2026-10-07 11:59:00+00:00,1\n2026-10-07 12:00:09+00:00,2\n2026-10-08 00:00:00+00:00,3\n" + assert filtrer_csv(txt, du, au) == "time_utc,x\n2026-10-07 12:00:09+00:00,2\n" + assert filtrer_csv(txt, None, None) == txt + assert filtrer_csv("timestamp,a\r\n2026-10-07 13:00:00,1\r\n", du, au) == "timestamp,a\r\n2026-10-07 13:00:00,1\r\n" + assert garder_image("20261007T1200Z_1.jpg", du, au) and not garder_image("20261008T0000Z_2.jpg", du, au) + assert garder_image("sans_heure.jpg", du, au) +``` + +- [ ] **Step 2 : Lancer, voir échouer** + +Run : `python3 .claude/skills/anonymiser-cas/anonymiser.py --test` +Expected : `NameError` sur `instant` ou `filtrer_csv`. + +- [ ] **Step 3 : Coder `filtrer_csv`, `garder_image` et les options** + +Importer `instant` et `heure_image` avec les autres noms de `donnees`. Dans `anonymiser(dossier, cas, du=None, au=None)`, la boucle de copie applique `filtrer_csv` aux CSV et saute une image si `not garder_image(f, du, au)`. `__main__` : deux arguments positionnels, puis `--du T` et `--au T` facultatifs (argparse). Docstring et `SKILL.md` (étape 1) : la fenêtre, et pourquoi (ne pas copier des centaines d'images dans un cas). + +- [ ] **Step 4 : Lancer, voir passer** + +Run : `python3 .claude/skills/anonymiser-cas/anonymiser.py --test` +Expected : `ok` + +- [ ] **Step 5 : Écrire `.claude/agents/builder.md`** + +Frontmatter : `name: builder`, `description:` (builder de `/boucle` : ajoute à la base de cas les événements nouveaux signalés pendant un lot), `tools: Read, Bash, Write, Edit`, `model: opus`. Corps : la section « Builder » de la spec, avec : +- lire les `## Nouveautés` des rendus du lot, puis `agents/diagnostic/cas/INDEX.md` ; une nouveauté dont un cas a déjà la signature : rien ; +- sinon, un cas `C-xxx` (le plus grand de l'index, plus un) : `python3 .claude/skills/anonymiser-cas/anonymiser.py agents/diagnostic/cas/C-xxx/ --du --au ` ; la fiche suit le §11.3 de `docs/agents/agent-diagnostic.md` (`grep -n '^### 11.3'`, puis cette section seule) et le skill `anonymiser-cas` (étapes 2 à 4, avec la même fenêtre) ; +- en tête de fiche : `**Appris par la boucle** le , séance , non revalidé par l'expert` ; ligne d'index dont le Verdict commence par `(appris)` ; +- ne jamais modifier un cas existant ni `agents/diagnostic/instructions.md` ; ne pas passer par `/nouveau-cas` ; ne pas commiter. + +- [ ] **Step 6 : Commit** + +```bash +git add .claude/skills/anonymiser-cas/anonymiser.py .claude/skills/anonymiser-cas/SKILL.md .claude/agents/builder.md +git commit -m "Add the loop builder agent and a time window to the case anonymizer" -- .claude/skills/anonymiser-cas/anonymiser.py .claude/skills/anonymiser-cas/SKILL.md .claude/agents/builder.md +``` + +### Task 5 : L'orchestrateur `/boucle` + +**Files :** +- Create : `.claude/skills/boucle/SKILL.md` + +**Interfaces :** +- Consumes : les agents et rendus des tâches 1 à 4, leurs lignes `**Verdict** :`, `**Cas créés** :` et `## Nouveautés`. +- Produces : la branche `boucle/_` et le dossier `vues-deplacements/boucle/_/` (`SEANCE` = `date -u +%Y-%m-%dT%H%MZ`, `STATION` = nom du dossier de station), un `lot-NN/` par lot, `bilan.md`. + +- [ ] **Step 1 : Écrire `.claude/skills/boucle/SKILL.md`** + +Frontmatter : `name: boucle`, `description:` (séance automatique d'amélioration des détecteurs du journal et de la base de cas, lot après lot, sur une station), `disable-model-invocation: true`, `argument-hint: " [--du AAAA-MM-JJ] [--au AAAA-MM-JJ] [--lot 4]"`. Corps, le §4 de la spec en étapes : +1. **Mise en place** : vérifier que le dossier a un export « advanced » (`python3 agents/diagnostic/outils/inventaire.py `) ; `git switch -c boucle/_` ; créer le dossier de séance. +2. **Lots** : `python3 vues-deplacements/journal/categories.py --tranche [--du …] [--au …]` ; chaque en-tête `== → : …` est un lot, numéroté `01`, `02`… La **commande du lot** donnée aux agents : la même, avec `--du --tranche `, plus `--au ` si la fin tombe à `00:00Z` (sinon c'est le dernier lot, sans `--au`). +3. **Par lot** : les demandes exactes des Interfaces des tâches 1 à 4 (`subagent_type` : `analyste`, `upgrader`, `validateur`, `builder`) ; les verdicts lus par `grep '^\*\*Verdict\*\* :'` dans le rendu ; la base du lot = `git rev-parse HEAD` juste avant le premier passage de l'upgrader ; les commits et leurs chemins : + - critique : `/` → `Loop lot NN: critique ()` ; + - passage K : `vues-deplacements/journal/ vues-deplacements/contexte/seuils-du-journal.md /` → `Loop lot NN: modification K` ; + - validation K : `/` → `Loop lot NN: validation K ()` ; + - « annuler » : `git checkout -- vues-deplacements/journal/ vues-deplacements/contexte/seuils-du-journal.md`, puis commit → `Loop lot NN: modification annulée` ; + - cas : `agents/diagnostic/cas/ .claude/skills/anonymiser-cas/registre.csv /` → `Loop lot NN: cas C-xxx, …`. + Le builder n'est appelé que si un `## Nouveautés` du lot n'est pas `aucune`. +4. **Imprévu** : un rendu absent après son agent : le noter pour le bilan, remettre les détecteurs à la base du lot s'ils ont changé (comme « annuler »), passer au lot suivant. Ne jamais poser de question à l'utilisateur ; ne rien juger soi-même. +5. **Bilan** : `bilan.md`, un tableau `| Lot | Dates (UTC) | Analyste | Modification | Cas créés |` (Modification : `aucune`, `gardée (K passages)`, `annulée`, `erreur`), puis `## Suggestions non traitées` (les `## Pas corrigé` des upgraders, les S1/S2 d'un lot sans modification gardée), `## Nouveautés déjà connues`, `## Erreurs` ; commit → `Loop : bilan`. +6. **Réponse finale** en 5 lignes au plus : la branche, le bilan, le nombre de modifications gardées et de cas créés ; rester sur la branche. + +- [ ] **Step 2 : Vérifier la découpe sur NORDEND d'octobre** + +Run : `python3 vues-deplacements/journal/categories.py vues-deplacements/cas/2026-10_NORDEND/NORDEND/ --tranche 4 | grep '^=='` +Expected : trois lots, `2026-10-05T00:00Z → 2026-10-09T00:00Z`, `2026-10-09T00:00Z → 2026-10-13T00:00Z`, `2026-10-13T00:00Z → 2026-10-16T05:15Z`. + +- [ ] **Step 3 : Commit** + +```bash +git add .claude/skills/boucle/SKILL.md +git commit -m "Add the /boucle orchestrator skill" -- .claude/skills/boucle/SKILL.md +``` + +### Task 6 : Décision et cartes du dépôt + +**Files :** +- Modify : `docs/decisions.md` (ajout en fin : D-057) +- Modify : `CLAUDE.md` (puces « Journal du matin (D-056) » et `.claude/`, ligne 20 et 147 ; pas de ligne nouvelle) +- Modify : `vues-deplacements/CLAUDE.md` (un paragraphe sur la boucle) +- Modify : `docs/superpowers/plans/2026-10-23-journal-du-matin.md` (point 31 : étapes, index, journal) + +- [ ] **Step 1 : Écrire D-057** au format de D-056 (`## D-057 — 2026-10-24 — Déplacements : la boucle automatique d'amélioration des détecteurs et de la base de cas`, Statut, Décision, Pourquoi, Options écartées, Conséquence) : les quatre rôles et l'orchestrateur ; tout commité sur une branche par séance ; pas de rejeu ; les cas appris entrent dans la base sans `/nouveau-cas`, marqués « (appris) », ce qui complète D-048 ; l'agent de diagnostic hors de la boucle. Options écartées : le rejeu des lots vus, une base de cas à part, des agents qui se parlent directement. +- [ ] **Step 2 : `CLAUDE.md`** : dans la puce du journal du matin, une phrase sur `/boucle` (D-057, spec `vues-deplacements/contexte/boucle-automatique.md`) ; dans la puce `.claude/`, les skills `boucle`, `critiquer-lot` et les agents `analyste`, `upgrader`, `validateur`, `builder`. Run : `wc -l CLAUDE.md` ; Expected : moins de 200 (D-012). +- [ ] **Step 3 : `vues-deplacements/CLAUDE.md`** : un paragraphe : la boucle, sa commande, le dossier `boucle/` des séances (hors de tout dossier de station), la spec. +- [ ] **Step 4 : Point 31 du plan vivant** : étapes remplacées par « construire (ce plan) » et « première séance (tâche 7) » ; index « construit, première séance à lancer » ; une ligne au journal du plan. +- [ ] **Step 5 : Commit** + +```bash +git add docs/decisions.md CLAUDE.md vues-deplacements/CLAUDE.md docs/superpowers/plans/2026-10-23-journal-du-matin.md vues-deplacements/contexte/boucle-automatique.md docs/superpowers/plans/2026-10-24-boucle-automatique.md vues-deplacements/contexte/journal-du-matin.md +git commit -m "Record the automatic loop decision (D-057)" -- docs/decisions.md CLAUDE.md vues-deplacements/CLAUDE.md docs/superpowers/plans/2026-10-23-journal-du-matin.md vues-deplacements/contexte/boucle-automatique.md docs/superpowers/plans/2026-10-24-boucle-automatique.md vues-deplacements/contexte/journal-du-matin.md +``` + +### Task 7 : Première séance, sur NORDEND d'octobre + +C'est l'utilisateur qui lance : `/boucle` ne s'appelle que par lui. + +- [ ] **Step 1 : Session neuve** : l'utilisateur ouvre une nouvelle session Claude Code dans `~/Support-Agent`, en mode auto (pour qu'elle tourne sans demander d'accord), et tape : `/boucle vues-deplacements/cas/2026-10_NORDEND/NORDEND/` +- [ ] **Step 2 : Contrôles** (Claude, à la fin de la séance, sur la branche `boucle/…`) : + - `ls vues-deplacements/boucle/*_NORDEND/` : `lot-01`, `lot-02`, `lot-03`, `bilan.md` ; + - `git log --stat master..HEAD` : chaque commit ne touche que les chemins de la tâche 5 ; + - `git diff master..HEAD -- agents/diagnostic/instructions.md .claude/agents/diagnostic.md` : vide ; `git diff master..HEAD -- agents/diagnostic/cas/C-00[1-5]/` : vide ; + - `git diff master..HEAD -- vues-deplacements/journal/ | grep -nE 'NORDEND|TROYDO|PR[0-9]{2}|2026-10'` : rien dans une règle (une docstring qui cite son origine est permise) ; + - « Sources lues » des trois critiques : ni `parcours.md`, ni `CLAUDE.md`, ni un plan ; + - `python3 vues-deplacements/journal/categories.py vues-deplacements/cas/2026-10_NORDEND/NORDEND/ 2>&1 | grep -c sauté` : `0`. +- [ ] **Step 3 : Bilan à l'utilisateur** : les contrôles, puis le bilan de séance ; il fusionne, garde une partie ou revient en arrière. Le résultat va dans `vues-deplacements/contexte/donnees-et-boucle.md` (« Ce qui reste à vérifier ») et au point 31 du plan vivant. diff --git a/vues-deplacements/CLAUDE.md b/vues-deplacements/CLAUDE.md index c466d3f..a4a37e2 100644 --- a/vues-deplacements/CLAUDE.md +++ b/vues-deplacements/CLAUDE.md @@ -20,6 +20,8 @@ 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 `journal/` (`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 `journal/categories.py` (`python3 vues-deplacements/journal/categories.py ` : une ligne par événement), que `explore.py` affiche ; brainstorming et pistes dans `contexte/journal-du-matin.md`, registre des seuils provisoires dans `contexte/seuils-du-journal.md`, lissage dans `contexte/lissage.md`, données en masse et boucle Claude dans `contexte/donnees-et-boucle.md`. +Boucle automatique (D-057) : `/boucle ` 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/_`, ses rendus dans `boucle/_/lot-NN/` et son `bilan.md`, hors de tout dossier de station ; spec `contexte/boucle-automatique.md`. + ## Règles - Les données restent seules dans `/` : les outils de l'agent lisent tout le dossier qu'on leur donne, et une capture PNG y passerait pour une image de la caméra. Le verdict de l'utilisateur, dans `parcours.md`, reste hors de la vue de l'agent. diff --git a/vues-deplacements/contexte/boucle-automatique.md b/vues-deplacements/contexte/boucle-automatique.md new file mode 100644 index 0000000..af7cbf3 --- /dev/null +++ b/vues-deplacements/contexte/boucle-automatique.md @@ -0,0 +1,131 @@ +# La boucle automatique : conception + +Point 31 du plan `docs/superpowers/plans/2026-10-23-journal-du-matin.md`, brainstorming du 2026-10-24. Statut : **approuvée par l'utilisateur le 2026-10-24** ; plan de construction : `docs/superpowers/plans/2026-10-24-boucle-automatique.md`. Ce qui vient de l'utilisateur est dit « l'utilisateur » ; le reste est un choix de Claude, marqué *(choix de Claude)*. + +## 1. Pourquoi + +L'utilisateur veut que Claude apprenne sur des lots entiers de données de stations, sans lui : passer les détecteurs du journal du matin sur un lot, juger leurs résultats comme le ferait un expert, en regardant lui-même les courbes et les images, corriger les détecteurs, et garder sous forme de cas tout ce qui est nouveau. Puis passer au lot suivant. + +À la fin d'une séance, il reste deux choses durables (l'utilisateur) : +1. **de la connaissance** : de nouveaux cas, appris sur des événements réels, de la même forme que C-001 à C-005, ajoutés à la même base de cas, `agents/diagnostic/cas/` : tous les cas sont au même endroit (l'utilisateur) ; +2. **des détections optimisées** : des détecteurs mieux réglés. + +L'analyste et le validateur ne laissent rien de durable eux-mêmes : ce sont les juges qui y mènent. + +## 2. Buts, non-buts, ce qui serait un échec + +**Buts.** Une commande lance une séance sur une station ; elle tourne seule jusqu'au bout ; tout ce qu'elle fait est commité, étape par étape, pour s'y retrouver et revenir en arrière (l'utilisateur). + +**Non-buts.** +- Récupérer les données : la boucle prend un dossier de station tel quel, au format de `data//` (export « advanced » dans `displacement/`, images dans `images/`), qu'il vienne du pompage (`extraction/pomper.py`, point 27) ou de CSV et d'images téléchargés à la main. +- Les autres domaines (Energy, Storage, Cellular, Temperature) : les déplacements seulement. +- **L'agent de diagnostic** (`diagnostic`, D-046) : il n'entre pas en jeu ici, à aucun moment il n'a de travail dans la boucle (l'utilisateur, 2026-10-24). Il sert au diagnostic pour l'utilisateur ; on le traitera dans une autre conversation, y compris ce que les cas appris changent pour lui. La boucle ne touche pas à ses consignes ; elle ne fait que compléter la base de cas. +- L'exhaustivité : **pas de rejeu** des lots déjà vus, pas de revalidation générale après chaque modification ; on explore des données et on améliore peu à peu (l'utilisateur). +- Revalider les cas appris : peut-être plus tard, à la main, pas maintenant (l'utilisateur). +- Plusieurs analystes en parallèle : plus tard (annexe). + +**Ce qui serait un échec.** +- **La complexité** : des détecteurs qui gonflent de règles et de cas particuliers pour un petit gain (la crainte de l'utilisateur). +- Toucher aux cas validés C-001 à C-005, ou aux catégories du journal, validées au point 5 du plan *(choix de Claude)*. +- Un détecteur cassé qui disparaît sans bruit : le chargeur de `categories.py` saute, avec un simple message, un fichier qui ne se charge pas *(constaté dans le code)*. + +## 3. Ce qui existe et que la boucle réutilise + +- Les détecteurs du journal : `vues-deplacements/journal/*.py`, contrat `detect(mesures)`, classés en événements par `categories.py`. Le tri en lot existe (point 30, validé) : `python3 vues-deplacements/journal/categories.py --du AAAA-MM-JJ --au AAAA-MM-JJ --tranche 4 --historique 3`. Chaque lot est classé avec les 3 jours d'avant : c'est la règle pour la boucle (D-056). +- Les outils de lecture des données, `agents/diagnostic/outils/` : `inventaire.py`, `resume.py`, `graphique.py` (PNG des séries), `vignettes.py` (gros plans des cibles sur les images), utilisés tels quels ; leur mode d'emploi est au §3 de `agents/diagnostic/instructions.md`. Seuls les outils servent : l'agent de diagnostic, lui, n'est pas appelé. +- La carte des événements, `docs/displacement/domaine/carte-des-evenements.md` : ce qui peut arriver, en familles, et les catégories du journal (section 4). +- La base de cas, `agents/diagnostic/cas/` : l'index `INDEX.md`, le modèle de fiche (§11.3 de `docs/agents/agent-diagnostic.md`), le skill `anonymiser-cas` (données copiées dans le dossier du cas, noms codés, D-049, D-050). Les cas existants ne se modifient jamais ; la boucle en ajoute. +- Le registre des seuils, `vues-deplacements/contexte/seuils-du-journal.md` : une constante changée le met à jour dans le même changement. + +## 4. Une séance + +**Lancement** : `/boucle [--du AAAA-MM-JJ] [--au AAAA-MM-JJ] [--lot 4]`. Sans dates, toute la période du dossier. 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/_` depuis la branche courante et le dossier de la séance `vues-deplacements/boucle/_/`, 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. +2. Verdict « d'accord » : on passe à l'étape 5. +3. **Upgrader** : il modifie les détecteurs et écrit `modification-K.md` (K : numéro du passage). Commit. +4. **Validateur** : il écrit `validation-K.md`, « accepté » ou « à reprendre ». Commit. « À reprendre » : retour à l'étape 3, l'upgrader lit cette validation. Au plus trois passages de l'upgrader *(choix de Claude)* : à la troisième validation, le validateur n'a plus que deux réponses, « garder » (ça va dans le bon sens) ou « annuler » (l'orchestrateur annule par `git revert` les commits de détecteurs du lot). +5. **Builder** : s'il y a des nouveautés dans les rendus du lot, il ajoute les cas à la base, `agents/diagnostic/cas/`, et écrit `builder.md`. Un commit pour les cas du lot (ils partagent la ligne d'index). + +Le lot suivant tourne avec les détecteurs tels qu'ils sont devenus. À la fin, l'orchestrateur écrit `bilan.md` (§6) et le commite. + +**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 lot NN: …`). Les agents tournent sur Opus (l'utilisateur). + +**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)*. + +## 5. Les rôles + +Chaque rôle est un sous-agent de Claude Code, défini dans `.claude/agents/.md` (ses consignes y sont), comme l'agent `diagnostic`. L'orchestrateur est un skill, lancé dans la conversation principale : un sous-agent ne peut pas lancer d'autres sous-agents. + +### Orchestrateur : skill `.claude/skills/boucle/SKILL.md` + +Lancé par l'utilisateur seulement (comme `/nouveau-cas`). Il déroule le §4 et ne juge rien lui-même. + +### Analyste : `.claude/agents/analyste.md`, avec le skill `critiquer-lot` + +La critique est un skill à part, à la demande de l'utilisateur ; on peut aussi la lancer à la main sur un lot, hors de la boucle. Outils : Read, Bash, Write. Il ne modifie rien. + +1. **Sa propre lecture d'abord, sans la sortie des détecteurs** *(choix de Claude)* : sinon il ne trouverait jamais ce que les détecteurs ratent. Inventaire, courbes du lot avec `graphique.py`, vignettes espacées (une toutes les 2 à 3 h) et plus serrées là où les courbes bougent, images entières pour la scène. Il note chaque moment : début, fin, capteurs, ce qu'il voit, la catégorie de la carte qui conviendrait, ou « aucune catégorie ». +2. **Puis** la sortie de `categories.py` pour le lot. +3. **Comparaison**, événement par événement : juste ; catégorie fausse ; en trop ; bornes fausses (en retard, trop large) ; manquant. +4. **Puis les cas**, après les faits (sinon il chercherait ce que dit un cas au lieu de ce que montrent les données) : l'index `agents/diagnostic/cas/INDEX.md`, avec les cas appris aux lots et aux séances d'avant. +5. **Verdict** : « d'accord » (rien d'important à corriger), ou des **suggestions, au plus deux**, les plus importantes *(choix de Claude, contre la complexité)* : le défaut, l'exemple (moment, capteurs), le détecteur en cause, ce qu'il faudrait, en mots et non en code. +6. **Nouveautés** pour le builder : ce que ni la carte ni l'index ne décrivent, avec le moment, les capteurs et la figure qui le montre. + +`critique.md` reprend ces six parties ; ses figures sont dans le dossier du lot. + +### Upgrader : `.claude/agents/upgrader.md` + +Il reprend les suggestions de l'analyste (et la dernière validation, s'il y en a une) et modifie les détecteurs. Outils : Read, Edit, Write, Bash. + +- Il ne touche qu'à `vues-deplacements/journal/*.py` et au registre des seuils. +- **Le plus simple d'abord** *(choix de Claude, contre la complexité)* : changer une constante ; sinon ajuster une règle existante ; sinon une règle nouvelle et courte ; un nouveau détecteur (contrat `detect(mesures)`) en dernier recours. +- **Interdits** : pas de nouvelle catégorie (une suggestion qui en demande une va au bilan) ; pas de règle propre à une station, à un capteur ou à une date ; contrat et clés des épisodes inchangés ; bibliothèque standard seulement. +- Il met à jour le registre des seuils et la docstring du détecteur dans le même changement. +- Il relance `categories.py` sur le lot, avant et après. +- `modification-K.md` : ce qui a changé et pourquoi, les événements du lot avant et après, ce qu'il n'a pas pu corriger. + +### Validateur : `.claude/agents/validateur.md` + +Il sait que l'upgrader est passé : il lit la critique, la modification et le diff des détecteurs depuis le début du lot. Il relance `categories.py` sur le lot et vérifie qu'aucun détecteur n'a été sauté au chargement. Il ne refait pas l'analyse des images (l'utilisateur). Outils : Read, Bash, Write ; il ne modifie pas le code. + +- **Ses questions** : la modification répond-elle au défaut relevé par l'analyste ? Va-t-elle dans le bon sens sur ce lot ? Est-elle simple, à la mesure du gain ? Respecte-t-elle les interdits de l'upgrader ? +- **Pas trop strict** (consigne forte de l'utilisateur) : aucune modification n'est parfaite, et il y a toujours des imprévus. Il accepte ce qui va dans le bon sens, même imparfait. Il ne renvoie que pour un défaut net : le problème n'est pas réglé, un autre événement du lot est cassé, la complexité est hors de proportion, un interdit n'est pas respecté. Jamais pour demander ce que l'upgrader ne peut pas faire. Au plus trois remarques, concrètes. +- `validation-K.md` : « accepté » ou « à reprendre » avec ses remarques ; à la troisième, « garder » ou « annuler ». + +### Builder : `.claude/agents/builder.md` + +Il construit la base de connaissances (l'utilisateur). Outils : Read, Bash, Write, Edit. Il lit les nouveautés des rendus du lot ; c'est l'analyste qui en signale le plus, mais 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. +- 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 »). + +## 6. Ce que l'utilisateur trouve à la fin + +- La branche `boucle/_` : un commit par étape, lisible avec `git log` ; il la fusionne, n'en garde qu'une partie, ou revient en arrière. +- `bilan.md` : une ligne par lot (verdict de l'analyste ; modification gardée, annulée ou aucune ; cas créés) ; les suggestions non traitées (nouvelle catégorie, au-delà de deux) ; les nouveautés déjà connues ; les erreurs. + +## 7. Première séance + +Sur des données déjà là, dont la vérité est connue : NORDEND d'octobre, `vues-deplacements/cas/2026-10_NORDEND/NORDEND/` (11 jours, 3 lots de 4 jours), le jeu du point 30 *(choix de Claude)*. On regarde si les critiques sont sensées et les modifications raisonnables, avant de passer à des données pompées. + +## 8. Laissé au constructeur + +Le texte des consignes de chaque agent ; le format exact des messages de commit ; la découpe des lots (en lisant l'en-tête de `categories.py` ou en la calculant) ; les colonnes des courbes de l'analyste ; la marge autour d'un événement pour les données d'un cas (proposition : 6 h ; seulement la fenêtre, pas tout le lot, pour ne pas commiter des centaines d'images par cas) ; une option de fenêtre dans `anonymiser.py` si elle manque (vérifiée par son `--test`) ; le mode de permission qui laisse une séance tourner sans demander d'accord. + +À faire avec la construction : une entrée D-057 dans `docs/decisions.md` (la boucle ; la base de cas s'enrichit aussi par le builder, sans `/nouveau-cas`, ce qui complète D-048 ; l'agent de diagnostic hors de la boucle), une ligne dans `CLAUDE.md` et dans `vues-deplacements/CLAUDE.md`. + +## Annexe : pistes à revoir + +- Plusieurs analystes en parallèle : les lots sont indépendants ; l'upgrader reste seul, pour que deux agents ne modifient jamais le même détecteur. +- La revalidation des cas appris par l'utilisateur. +- Le rejeu sur les lots déjà vus (écarté le 2026-10-24 : trop lourd, pas exhaustif voulu). +- Un plafond de lots ou de coût par séance. +- Plusieurs stations par séance. +- Le pompage en masse (points 27 à 29). diff --git a/vues-deplacements/contexte/journal-du-matin.md b/vues-deplacements/contexte/journal-du-matin.md index 3b77bff..f78f263 100644 --- a/vues-deplacements/contexte/journal-du-matin.md +++ b/vues-deplacements/contexte/journal-du-matin.md @@ -92,3 +92,7 @@ Un orchestrateur (la conversation principale) et un agent par piste, qui rapport - Des ouvrages bougent beaucoup le jour par dilatation thermique et redescendent la nuit : de grosses vagues, tout à fait normales (l'utilisateur ne se souvient plus du projet qui le montrait). - Idée de l'utilisateur : un « effet périodique » qui explique ces anomalies ; la vague est un événement de dilatation ou de contraction thermique ; le reconnaître en ajustant une sinusoïde de 24 h (ou un polynôme en vague) : si elle colle, l'événement est cyclique, calqué sur le jour et la nuit. Point 41 du plan ; note `docs/displacement/domaine/cycle-thermique.md`. + +## La boucle automatique (point 31 du plan, 2026-10-24) + +- Idée de l'utilisateur : une boucle dans Claude Code, un orchestrateur et quatre rôles (analyste juge, upgrader des détecteurs, validateur pas trop strict, builder de cas), lot après lot ; détail au point 31 du plan.