Record the automatic loop decision (D-057)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
16be87e1ce
commit
6be683819e
7 files changed
+428
-11
No files matched your search
@@ -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.
|
||||
Reference in new issue
Block a user