Files
Support-Agent/docs/superpowers/plans/2026-10-24-boucle-automatique.md
T

258 lines
25 KiB
Markdown
Raw Normal View History

2026-10-24 15:14:14 +02:00
# 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).
- [x] **Step 1 : Écrire `.claude/agents/analyste.md`**
2026-10-24 15:14:14 +02:00
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. »
- [x] **Step 2 : Écrire `.claude/skills/critiquer-lot/SKILL.md`**
2026-10-24 15:14:14 +02:00
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) ; `labeling/connaissances/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.
2026-10-24 15:14:14 +02:00
- **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.
- [x] **Step 3 : Essai sur le lot 1 de NORDEND d'octobre**
2026-10-24 15:14:14 +02:00
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.
- [x] **Step 4 : Commit**
2026-10-24 15:14:14 +02:00
```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).
- [x] **Step 1 : Écrire `.claude/agents/upgrader.md`**
2026-10-24 15:14:14 +02:00
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.
- [x] **Step 2 : Vérifier le frontmatter**
2026-10-24 15:14:14 +02:00
Run : `head -6 .claude/agents/upgrader.md`
Expected : `name: upgrader`, `tools: Read, Edit, Write, Bash`, `model: opus`.
- [x] **Step 3 : Commit**
2026-10-24 15:14:14 +02:00
```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).
- [x] **Step 1 : Écrire `.claude/agents/validateur.md`**
2026-10-24 15:14:14 +02:00
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 ».
- [x] **Step 2 : Vérifier la commande qu'il lancera, sur les détecteurs d'aujourd'hui**
2026-10-24 15:14:14 +02:00
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`
- [x] **Step 3 : Commit**
2026-10-24 15:14:14 +02:00
```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).
- [x] **Step 1 : Ajouter les tests à `_test()`**
2026-10-24 15:14:14 +02:00
```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)
```
- [x] **Step 2 : Lancer, voir échouer**
2026-10-24 15:14:14 +02:00
Run : `python3 .claude/skills/anonymiser-cas/anonymiser.py --test`
Expected : `NameError` sur `instant` ou `filtrer_csv`.
- [x] **Step 3 : Coder `filtrer_csv`, `garder_image` et les options**
2026-10-24 15:14:14 +02:00
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).
- [x] **Step 4 : Lancer, voir passer**
2026-10-24 15:14:14 +02:00
Run : `python3 .claude/skills/anonymiser-cas/anonymiser.py --test`
Expected : `ok`
- [x] **Step 5 : Écrire `.claude/agents/builder.md`**
2026-10-24 15:14:14 +02:00
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.
- [x] **Step 6 : Commit**
2026-10-24 15:14:14 +02:00
```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`.
- [x] **Step 1 : Écrire `.claude/skills/boucle/SKILL.md`**
2026-10-24 15:14:14 +02:00
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.
- [x] **Step 2 : Vérifier la découpe sur NORDEND d'octobre**
2026-10-24 15:14:14 +02:00
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`.
- [x] **Step 3 : Commit**
2026-10-24 15:14:14 +02:00
```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)
- [x] **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.
- [x] **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).
- [x] **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.
- [x] **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.
- [x] **Step 5 : Commit**
2026-10-24 15:14:14 +02:00
```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.
**En attente (2026-10-24)** : fonctionnement validé par l'utilisateur (tâches 1 à 6 faites, essai de l'analyste au §7 de la spec) ; il lancera lui-même la première séance, lot par lot, sur de nouvelles données, quand les autres développements seront faits. Ne pas la lancer.
2026-10-24 15:14:14 +02:00
- [ ] **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.