Files
Support-Agent/docs/superpowers/plans/2026-10-24-boucle-automatique.md
T
2026-10-24 15:14:14 +02:00

257 lines
24 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.