Record the automatic loop decision (D-057)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-24 15:14:14 +02:00
1 parent 16be87e1ce
commit 6be683819e
7 files changed
+428 -11

No files matched your search

+10
View File
@@ -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 <dossier de station>` (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/<séance>/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`.
@@ -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 `<STATION>_<début>_<fin>.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.
@@ -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 <dossier de station>` 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 -- <chemins>`), message `Loop <STATION> lot NN: …` terminé par la ligne `Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>`.
- 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 : <fichier> 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 : <dossier>. Lot NN : <début> → <fin> (UTC). Commande du lot : <commande>. Écris <chemin>/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 : <titre>` et `### S2 : <titre>`, 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: "<dossier> <début> <fin> <fichier de sortie>"`. 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 <dossier de la critique>` 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 : <STATION>, <début> → <fin> (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 : <dossier>. Lot NN : <début> → <fin>. Commande du lot : <commande>. Critique : <chemin>. [Validation précédente : <chemin>.] Passage K. Écris <chemin>/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 : <dossier>. Lot NN : <début> → <fin>. Commande du lot : <commande>. Critique : <chemin>. Modification : <chemin>. Base : <commit>. Passage K sur 3. Écris <chemin>/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 <base> -- 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 <dossier> <cas> [--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 <dossier> agents/diagnostic/cas/C-xxx/ --du <début − 6 h> --au <fin + 6 h>` ; 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 <AAAA-MM-JJ>, séance <dossier de la 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/<SEANCE>_<STATION>` et le dossier `vues-deplacements/boucle/<SEANCE>_<STATION>/` (`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: "<dossier de station> [--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 <dossier>`) ; `git switch -c boucle/<SEANCE>_<STATION>` ; créer le dossier de séance.
2. **Lots** : `python3 vues-deplacements/journal/categories.py <dossier> --tranche <lot> [--du …] [--au …]` ; chaque en-tête `== <début> → <fin> : …` est un lot, numéroté `01`, `02`… La **commande du lot** donnée aux agents : la même, avec `--du <jour du début> --tranche <lot>`, plus `--au <jour de la fin>` 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 : `<lot>/` → `Loop <STATION> lot NN: critique (<verdict>)` ;
- passage K : `vues-deplacements/journal/ vues-deplacements/contexte/seuils-du-journal.md <lot>/` → `Loop <STATION> lot NN: modification K` ;
- validation K : `<lot>/` → `Loop <STATION> lot NN: validation K (<verdict>)` ;
- « annuler » : `git checkout <base> -- vues-deplacements/journal/ vues-deplacements/contexte/seuils-du-journal.md`, puis commit → `Loop <STATION> lot NN: modification annulée` ;
- cas : `agents/diagnostic/cas/ .claude/skills/anonymiser-cas/registre.csv <lot>/` → `Loop <STATION> 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 <STATION>: 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.