Loop: --ameliorer runs an improver after the releveur (D-071)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
a614010292
commit
55519e53b3
9 files changed
+58
-10
No files matched your search
@@ -0,0 +1,34 @@
|
||||
---
|
||||
name: ameliorateur
|
||||
description: Améliorateur de /boucle — corrige le skill /boucle et ses agents d'après les difficultés que le releveur vient de noter dans docs/ameliorations-processus.md. Appelé par l'orchestrateur en fin de séance, après le releveur, seulement si l'utilisateur a lancé /boucle avec --ameliorer (D-071).
|
||||
tools: Read, Bash, Edit
|
||||
model: inherit
|
||||
---
|
||||
|
||||
Tu es l'améliorateur de `/boucle`. Le releveur vient de noter, dans `docs/ameliorations-processus.md`, les difficultés de la séance : consignes floues ou contradictoires, chemins, formats, commandes. Tu corriges le processus pour qu'elles ne reviennent pas.
|
||||
|
||||
## Ta demande
|
||||
|
||||
Le commit du releveur : `git show <commit> -- docs/ameliorations-processus.md` montre les entrées qu'il a créées ou complétées pendant la séance. Ce sont les seules que tu traites.
|
||||
|
||||
## Ce que tu fais
|
||||
|
||||
1. Lis ces entrées, puis la consigne ou le fichier que chacune cite (`fichier:ligne`).
|
||||
2. Pour chaque entrée, la correction la plus simple qui lève la difficulté : une phrase précisée, une contradiction tranchée dans le sens du skill, une commande ou un chemin rectifié. La piste de l'entrée, s'il y en a une, est un point de départ, pas un ordre.
|
||||
3. Une consigne citée ailleurs (le skill et la spec, un agent et le skill) : corrige les deux, pour qu'ils disent la même chose.
|
||||
4. Un script modifié (`.claude/skills/boucle/*.py`, `.claude/skills/critiquer-lot/*.py`) : relance une fois la commande en cause et vérifie qu'elle passe.
|
||||
5. Marque l'entrée corrigée **traité** (`AAAA-MM-JJ : ce qui a changé, où`), au format du carnet.
|
||||
|
||||
## Ce que tu peux modifier
|
||||
|
||||
`.claude/skills/boucle/`, `.claude/skills/critiquer-lot/`, les agents de la boucle (`.claude/agents/analyste.md`, `upgrader.md`, `validateur.md`, `builder.md`, `releveur.md`, `ameliorateur.md`), la spec `vues-deplacements/contexte/boucle-automatique.md`, `run.md` (section `/boucle`) et, pour les mentions **traité**, `docs/ameliorations-processus.md`. Rien d'autre.
|
||||
|
||||
## Ce que tu laisses
|
||||
|
||||
- Une entrée dont la cause est hors de ces fichiers (outils de lecture, `lire-les-donnees`, `anonymiser-cas`, détecteurs, données) : laisse-la telle quelle, l'utilisateur la traitera.
|
||||
- Une correction qui reviendrait sur une décision de `docs/decisions.md` ou un point validé du plan `docs/superpowers/plans/2026-10-23-journal-du-matin.md`, ou qui changerait ce que fait la boucle (rôles, étapes, critères de verdict) plutôt que la façon de le dire : laisse l'entrée, avec la raison dans ta réponse.
|
||||
- Tu ne lances pas la boucle, tu ne touches ni aux rendus de la séance, ni aux détecteurs, ni aux cas, et tu ne commites pas.
|
||||
|
||||
## Ta réponse
|
||||
|
||||
En 4 lignes au plus : les entrées traitées (titre, fichiers modifiés), les entrées laissées et pourquoi, les commandes relancées et leur résultat.
|
||||
@@ -2,7 +2,7 @@
|
||||
name: boucle
|
||||
description: Séance automatique d'amélioration des détecteurs du journal du matin et de la base de cas, lot après lot, sur une station (D-057) — analyste, upgrader, validateur, builder. Lancé par l'utilisateur seulement, avec /boucle.
|
||||
disable-model-invocation: true
|
||||
argument-hint: "data/<STATION> [--du AAAA-MM-JJ] [--au AAAA-MM-JJ] [--lot 4]"
|
||||
argument-hint: "data/<STATION> [--du AAAA-MM-JJ] [--au AAAA-MM-JJ] [--lot 4] [--ameliorer]"
|
||||
---
|
||||
|
||||
# La boucle automatique
|
||||
@@ -11,7 +11,7 @@ Tu es l'orchestrateur. Tu découpes la plage en lots, tu appelles les quatre age
|
||||
|
||||
## 1. Mise en place
|
||||
|
||||
- Arguments : le dossier de station ; un nom de station seul (« Nordend ») désigne `data/<NOM EN MAJUSCULES>/` (D-065) ; `--du`, `--au` (jours UTC, facultatifs : sans eux, toute la période ; **`--au` est exclu** : la plage s'arrête à `--au` 00:00Z, `--du 2026-09-01 --au 2026-09-05` fait 4 jours) ; `--lot` (jours, 4 par défaut). L'utilisateur choisit ses lots : `--du` / `--au` sur la plage d'un lot n'en traite qu'un. Des dates écrites autrement (« 2026-09.01 », deux dates sans option) se lisent comme `--du` puis `--au` ; écris dans le bilan, sous « Erreurs », comment tu as lu un argument qui n'était pas net.
|
||||
- Arguments : le dossier de station ; un nom de station seul (« Nordend ») désigne `data/<NOM EN MAJUSCULES>/` (D-065) ; `--du`, `--au` (jours UTC, facultatifs : sans eux, toute la période ; **`--au` est exclu** : la plage s'arrête à `--au` 00:00Z, `--du 2026-09-01 --au 2026-09-05` fait 4 jours) ; `--lot` (jours, 4 par défaut) ; `--ameliorer` (facultatif : en fin de séance, l'améliorateur corrige le processus d'après les relevés du releveur, §6, D-071). L'utilisateur choisit ses lots : `--du` / `--au` sur la plage d'un lot n'en traite qu'un. Des dates écrites autrement (« 2026-09.01 », deux dates sans option) se lisent comme `--du` puis `--au` ; écris dans le bilan, sous « Erreurs », comment tu as lu un argument qui n'était pas net.
|
||||
- `python3 agents/diagnostic/outils/inventaire.py <dossier>` : dossier absent ou sans export « advanced », dis-le et arrête-toi.
|
||||
- `STATION` = le nom du dossier de station (`NORDEND`) ; `SEANCE` = `date -u +%Y-%m-%dT%H%MZ`.
|
||||
- La séance se commite directement sur `master` (D-070) : `git branch --show-current` doit dire `master`, sinon dis-le et arrête-toi (pas de `git switch` : une autre session peut travailler dans ce dépôt). Note la **base de la séance** : `git rev-parse HEAD`. Les fichiers modifiés de l'utilisateur restent sans être commités : tu commites toujours par chemin. Une autre session peut travailler dans le même dépôt pendant la séance (fichiers modifiés, index déjà chargé, même ce skill) : `git commit -- <chemins>` ne prend que tes chemins ; n'indexe rien d'autre, jamais de `git add -A`, `git stash` ni `git checkout` hors de tes chemins ; garde les consignes lues au début et note le changement dans tes difficultés.
|
||||
@@ -90,8 +90,10 @@ Commit `<séance>/bilan.md <séance>/score-fin.txt <séance>/benchmark-fin.txt v
|
||||
**Releveur** (`releveur`), une fois, même si tout s'est bien passé : `Processus : /boucle (.claude/skills/boucle/SKILL.md). Séance : <séance>/ : la section « Difficultés » de chaque rendu des lots, et « Erreurs » du bilan. Difficultés de l'orchestrateur : aucune | <une consigne de ce skill qui t'a fait deviner, une commande qui a échoué…>.` (D-060)
|
||||
Si `git status --short docs/ameliorations-processus.md` montre un changement : commit de ce chemin, message `Loop <STATION>: process difficulties`.
|
||||
|
||||
**Améliorateur** (`ameliorateur`), seulement avec `--ameliorer` et si le releveur a commité : `Commit du releveur : <commit>.`, le commit pris par `git rev-parse HEAD` juste après celui du releveur (D-071). Puis commit des chemins qu'il a pu toucher, `.claude/skills/boucle/ .claude/skills/critiquer-lot/ .claude/agents/analyste.md .claude/agents/upgrader.md .claude/agents/validateur.md .claude/agents/builder.md .claude/agents/releveur.md .claude/agents/ameliorateur.md vues-deplacements/contexte/boucle-automatique.md run.md docs/ameliorations-processus.md`, seulement ceux que `git status --short` montre changés, message `Loop <STATION>: process fixes`. Garde la suite de ce skill telle que tu l'as lue au début.
|
||||
|
||||
## 7. Réponse finale
|
||||
|
||||
`python3 .claude/skills/boucle/comparaison.py <dossier> <séance>` : la page de fin de séance, `out/boucle_<SEANCE>_<STATION>.html`, qui s'ouvre dans le navigateur (D-066). En haut, `corr_x` et `corr_y` de tous les capteurs sur toute la plage de la séance ; dessous, une ligne par catégorie : la lecture de l'analyste (ses étiquettes) au-dessus des événements des détecteurs tels qu'ils sont en fin de séance, et en gris ses moments hors catégorie ; sous la figure, le score de la séance et le benchmark sur la base de cas. Le but, séance après séance : que les deux coïncident. Un échec du script va dans la réponse, sans relance.
|
||||
|
||||
En 8 lignes au plus : la page, la base de la séance, le chemin du bilan, le benchmark (ligne `total toutes`, début → fin), le nombre de modifications gardées et de cas créés, le nombre d'étiquettes (`<séance>/lot-*/etiquettes.json`, à garder même si l'utilisateur annule des modifications : elles ne dépendent pas des détecteurs), les erreurs, les difficultés relevées. Tout est sur `master`, rien n'est poussé : l'utilisateur annule ce qu'il ne garde pas par `git revert`.
|
||||
En 8 lignes au plus : la page, la base de la séance, le chemin du bilan, le benchmark (ligne `total toutes`, début → fin), le nombre de modifications gardées et de cas créés, le nombre d'étiquettes (`<séance>/lot-*/etiquettes.json`, à garder même si l'utilisateur annule des modifications : elles ne dépendent pas des détecteurs), les erreurs, les difficultés relevées et, avec `--ameliorer`, celles corrigées. Tout est sur `master`, rien n'est poussé : l'utilisateur annule ce qu'il ne garde pas par `git revert`.
|
||||
@@ -108,7 +108,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .
|
||||
|
||||
- `Handoff.md` (~150 l) : cadrage du product owner (reçu le 2026-10-25) : sous-projet G, santé des sites et notifications au client (domaines de mesure, étiquette de responsabilité, « consistent with », traductions, sécurité de production). À lire avant de concevoir côté client ou notifications, **par section** ; sa dernière section liste les écarts constatés avec ce dépôt, à arbitrer par l'utilisateur.
|
||||
- `README.md` (40 l) : point d'entrée pour un humain. `run.md` : les commandes génériques, pompage (dans le dev container de l'appli), `/aiguiser` et `/boucle`.
|
||||
- `docs/decisions.md` (770 l, D-001 à D-070) : décisions **projet**, au format ADR allégé (statut, décision, pourquoi, options écartées, conséquence). À consulter avant de changer d'orientation ou de reproposer une option : elle a peut-être déjà été écartée.
|
||||
- `docs/decisions.md` (780 l, D-001 à D-071) : décisions **projet**, au format ADR allégé (statut, décision, pourquoi, options écartées, conséquence). À consulter avant de changer d'orientation ou de reproposer une option : elle a peut-être déjà été écartée.
|
||||
- `docs/domaine/` : savoir métier commun, une note courte (< 50 l) par question.
|
||||
- `ce-que-mesure-la-station.md` : format CSV, métriques et unités, consommation mesurée mais pas l'apport.
|
||||
- `pieges-des-donnees.md` : trou ≠ coupure, signatures d'une coupure, seuils absolus, cycle jour/nuit.
|
||||
@@ -145,7 +145,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .
|
||||
- `storage/` : calcul embarquable `storage_state.py`, `days_until_full.py`, `day_color.py` (D-035) ; plotly : `final.py` (figure du site, D-039), `all_analyses.py` (D-034).
|
||||
- `temperature/` : calcul embarquable `gpu_temperature_limit.py`, `day_color.py` ; plotly : `final.py` (figure du site, D-041), `all_analyses.py` (D-040).
|
||||
- `maquettes/` : maquettes du site en HTML sur données réelles (D-022), Figma seulement sur demande. Un script remplit son gabarit HTML : `user/summary.py` + `summary_template.html` (client, une page par station, un bloc par domaine), `support/home.py` + `home_template.html` (support). Les deux parcourent une liste de domaines (`DOMAINS`, D-039).
|
||||
- `.claude/` : `rules/analyses.md` (se charge seule, voir « Analyses »), `agents/diagnostic.md` (point d'entrée de l'agent de diagnostic, D-046), `skills/nouvelle-analyse/` (procédure et modèle de fiche), `skills/nouveau-domaine/` (procédure pour un nouveau domaine), `skills/nouveau-cas/` (ajouter un cas à la base de l'agent de diagnostic, lancé par l'utilisateur seul), `skills/anonymiser-cas/` (données d'un cas copiées dans son dossier, noms en codes, registre des codes, D-049, D-050), `skills/boucle/` et `skills/critiquer-lot/` avec les agents `analyste`, `upgrader`, `validateur`, `builder` (boucle automatique, D-057), `skills/lire-les-donnees/` (outils de lecture et leur mode d'emploi) et `skills/aiguiser/` avec les agents `lecteur`, `correcteur`, `optimiseur` (D-059), `agents/releveur.md` (difficultés des processus automatiques, D-060), `settings.json` (lecture de `.env` interdite). Schémas de ces processus (agents, flux de données) : `docs/agents/pipelines-ia.drawio`, une page par processus.
|
||||
- `.claude/` : `rules/analyses.md` (se charge seule, voir « Analyses »), `agents/diagnostic.md` (point d'entrée de l'agent de diagnostic, D-046), `skills/nouvelle-analyse/` (procédure et modèle de fiche), `skills/nouveau-domaine/` (procédure pour un nouveau domaine), `skills/nouveau-cas/` (ajouter un cas à la base de l'agent de diagnostic, lancé par l'utilisateur seul), `skills/anonymiser-cas/` (données d'un cas copiées dans son dossier, noms en codes, registre des codes, D-049, D-050), `skills/boucle/` et `skills/critiquer-lot/` avec les agents `analyste`, `upgrader`, `validateur`, `builder` (boucle automatique, D-057), `skills/lire-les-donnees/` (outils de lecture et leur mode d'emploi) et `skills/aiguiser/` avec les agents `lecteur`, `correcteur`, `optimiseur` (D-059), `agents/releveur.md` (difficultés des processus automatiques, D-060), `agents/ameliorateur.md` (les corrige en fin de `/boucle --ameliorer`, D-071), `settings.json` (lecture de `.env` interdite). Schémas de ces processus (agents, flux de données) : `docs/agents/pipelines-ia.drawio`, une page par processus.
|
||||
- `vues-deplacements/` : chantier à part des vues des déplacements et de l'agent dans une maquette (D-052) : contexte, cas réels (données, pages de la plateforme, parcours de l'utilisateur), puis le code ; sa carte : `vues-deplacements/CLAUDE.md` ; maquette de la page Explore avec les onglets View et Diagnosis dans `vues-deplacements/maquette/` (D-053, D-054) ; détecteurs du journal du matin dans `vues-deplacements/detectors/` (D-056) ; `extraction/` : pompage des données de la plateforme (D-056), à lancer par l'utilisateur dans le dev container de l'application (qui monte `~` : sortie directe dans `data/`) ; lecture seule ; mode d'emploi dans `extraction/README.md`.
|
||||
- `.devcontainer/devcontainer.json` : environnement de dev en conteneur (D-038), réseau de l'hôte pour joindre la caméra. `architecture.drawio` : schéma d'architecture tenu par l'utilisateur, à ne pas modifier sans demande.
|
||||
- `out/` : pages et JSON générés. Tout le projet est versionné, sauf `out/`, `data/` (D-065), `.venv/` et `__pycache__/` (D-014).
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# Améliorer les processus automatiques
|
||||
|
||||
Carnet des difficultés rencontrées par les processus automatiques du projet (aujourd'hui `/boucle`), tenu par l'agent `releveur` (D-060). Chaque sous-agent finit son rendu par une section `## Difficultés` ; en fin de processus, l'orchestrateur les transmet au releveur, qui les note ici. Les corrections se font ensuite, dans une conversation à part, à partir de ce carnet.
|
||||
Carnet des difficultés rencontrées par les processus automatiques du projet (aujourd'hui `/boucle`), tenu par l'agent `releveur` (D-060). Chaque sous-agent finit son rendu par une section `## Difficultés` ; en fin de processus, l'orchestrateur les transmet au releveur, qui les note ici. Les corrections se font ensuite, dans une conversation à part, à partir de ce carnet ; avec `/boucle --ameliorer`, l'agent `ameliorateur` corrige en fin de séance celles de la séance qui touchent le skill et ses agents (D-071).
|
||||
|
||||
## Comment noter une difficulté
|
||||
|
||||
|
||||
@@ -762,3 +762,10 @@ Règles du journal :
|
||||
- **Pourquoi** : demande de l'utilisateur ; une branche par séance laissait des branches à fusionner après chaque séance, alors que les étiquettes et les cas sont gardés de toute façon.
|
||||
- **Options écartées** : basculer seul sur `master` en début de séance (dérangerait une autre session dans le même dépôt).
|
||||
- **Conséquence** : annuler une modification d'une séance passe par `git revert` de ses commits, depuis la base notée dans le bilan.
|
||||
|
||||
## D-071 — 2026-10-26 — Boucle : `--ameliorer`, un améliorateur après le releveur
|
||||
- **Statut** : active ; complète D-057 et D-060.
|
||||
- **Décision** : avec `/boucle … --ameliorer`, l'orchestrateur appelle, après le commit du releveur, l'agent `ameliorateur` (`.claude/agents/ameliorateur.md`). Il traite les seules entrées de `docs/ameliorations-processus.md` créées ou complétées pendant la séance (`git show` du commit du releveur), corrige au plus simple le skill `/boucle`, `critiquer-lot`, les agents de la boucle, la spec et `run.md`, et marque l'entrée **traité** ; il laisse ce qui sort de ces fichiers et ce qui changerait ce que fait la boucle ou une décision. L'orchestrateur commite par chemin (`Loop <STATION>: process fixes`). Sans le flag, rien ne change : le releveur note, l'utilisateur corrige.
|
||||
- **Pourquoi** : demande de l'utilisateur : les relevés s'accumulaient et se corrigeaient à la main, dans une autre conversation.
|
||||
- **Options écartées** : laisser le releveur corriger lui-même (D-060 le borne à noter : un agent qui note ne juge pas ses corrections) ; traiter toutes les entrées non traitées du carnet (certaines attendent l'utilisateur).
|
||||
- **Conséquence** : une séance avec le flag peut changer ses propres consignes ; l'orchestrateur garde celles lues au début. Les corrections se lisent dans le commit `process fixes` et s'annulent par `git revert`.
|
||||
@@ -1191,3 +1191,4 @@ Une ligne par séance : date, point(s) traités, ce qui a changé, ce qui reste.
|
||||
- 2026-10-26 : point 43 : métriques système dans `data/<SERIE>/metrics/` (demande de l'utilisateur) ; `pomper.py` y écrit, `load_stations` y lit aussi ; fichiers de CLARIDEN et NIEDERHORN déplacés.
|
||||
- 2026-10-26 : point 48 : tout au même endroit (l'utilisateur) : le rendu d'étiquetage de chaque cas devient `etiquetage.md` dans son dossier (C-001 à C-005 déplacés, C-006 à C-008 écrits par `anonymiser.py`, qui l'écrit désormais avec `--etiquettes`) ; `vues-deplacements/benchmark/` ne garde que l'historique.
|
||||
- 2026-10-26 : point 31 : `/boucle` commite directement sur `master` (demande de l'utilisateur, D-070) ; branches des séances NORDEND et CLARIDEN fusionnées dans `master` et supprimées.
|
||||
- 2026-10-26 : point 31 : `/boucle --ameliorer` (demande de l'utilisateur, D-071) : après le releveur, l'agent `ameliorateur` corrige le skill et ses agents d'après les entrées de la séance ; sans séance d'essai.
|
||||
@@ -34,13 +34,13 @@ Détails : `.claude/skills/aiguiser/SKILL.md`.
|
||||
Dans une session Claude Code neuve, **en mode auto**, à la racine de Support-Agent (pas dans le dev container), une fois les déplacements **et les images** pompés :
|
||||
|
||||
```
|
||||
/boucle data/<SERIE> --du <DEBUT> --au <FIN>
|
||||
/boucle data/<SERIE> --du <DEBUT> --au <FIN> [--ameliorer]
|
||||
```
|
||||
|
||||
- `<DEBUT>`, `<FIN>` : jours UTC, `AAAA-MM-JJ`, `<FIN>` exclu (la plage s'arrête à `<FIN>` 00:00). Découpée en lots de 4 jours (`--lot <jours>` pour changer) ; un seul lot : sa plage seule, par exemple `--du 2026-09-01 --au 2026-09-05`.
|
||||
- Sans `--du` ni `--au` : toute la période du dossier. Chaque lot est classé avec ses 3 jours d'avant : les pomper aussi.
|
||||
- Le modèle et l'effort choisis pour la session valent pour tous ses agents (D-063).
|
||||
- La séance tourne seule, sans question, à lancer sur `master`, où elle commite directement (D-070), un commit par étape : analyste, upgrader et validateur si l'analyste a des suggestions, builder s'il y a des nouveautés, puis le releveur, qui note les difficultés dans `docs/ameliorations-processus.md` (rien à demander). Les fichiers modifiés et non commités restent sans être commités.
|
||||
- La séance tourne seule, sans question, à lancer sur `master`, où elle commite directement (D-070), un commit par étape : analyste, upgrader et validateur si l'analyste a des suggestions, builder s'il y a des nouveautés, puis le releveur, qui note les difficultés dans `docs/ameliorations-processus.md` (rien à demander). Avec `--ameliorer`, l'améliorateur corrige ensuite le skill `/boucle` et ses agents d'après ces relevés et marque les entrées **traité** ; ce qui sort de son périmètre (outils de lecture, détecteurs) ou change ce que fait la boucle reste à traiter à la main (D-071). Les fichiers modifiés et non commités restent sans être commités.
|
||||
- Bilan dans `vues-deplacements/boucle/<séance>_<SERIE>/bilan.md` ; les étiquettes de l'analyste (`lot-*/etiquettes.json`) sont à garder même si on annule une modification. Ensuite : `git revert` des commits de la séance qu'on ne garde pas (la base de la séance est dans le bilan).
|
||||
- À la fin, la page `out/boucle_<séance>_<SERIE>.html` s'ouvre (D-066) : les courbes de la plage ; dessous, catégorie par catégorie, l'analyste (bleu) face aux détecteurs (orange) ; le score de la séance et le benchmark.
|
||||
- Le benchmark (D-069) : les détecteurs face au diagnostic gardé dans chaque cas de la base (`agents/diagnostic/cas/C-*/etiquettes.json`), lancé au début de chaque lot, après chaque modification et en fin de séance ; chaque passage s'ajoute à `vues-deplacements/benchmark/historique.csv`, avec la version des détecteurs.
|
||||
|
||||
@@ -20,7 +20,7 @@ Détection mécanique des anomalies (D-055) : faire ressortir les courbes qui co
|
||||
|
||||
Journal du matin du client (D-056), le cap actuel : onglet `Journal` de la maquette ; un détecteur élémentaire par fichier dans `detectors/` (`detect(mesures)` -> épisodes `start`, `end`, `kind`, `label`, `text`, `ignore`, `sensors`), chargés et classés en événements des onze catégories du journal par `detectors/categories.py` (`python3 vues-deplacements/detectors/categories.py <dossier>` : une ligne par événement), que `explore.py` affiche ; brainstorming et pistes dans `contexte/journal-du-matin.md`, registre des seuils provisoires dans `contexte/seuils-du-journal.md`, lissage dans `contexte/lissage.md`, données en masse et boucle Claude dans `contexte/donnees-et-boucle.md`.
|
||||
|
||||
Boucle automatique (D-057), lancée par l'utilisateur seul, sur les lots qu'il choisit : `/boucle <dossier de station> [--du … --au …]` fait juger les détecteurs du journal, lot après lot, par un analyste, les fait corriger par un upgrader contrôlé par un validateur, et ajoute les nouveautés à la base de cas par un builder ; une séance commitée directement sur `master` (D-070), ses rendus dans `boucle/<séance>_<STATION>/lot-NN/` (dont les étiquettes de l'analyste, `etiquettes.json`, D-061, et `score-avant.txt`, le score des détecteurs face à toutes les étiquettes, D-062) et son `bilan.md`, hors de tout dossier de station ; en fin de séance, la page `out/boucle_<séance>.html` montre l'analyste face aux détecteurs (D-066) ; à chaque lot et après chaque modification, le benchmark des détecteurs sur la base de cas (`.claude/skills/boucle/benchmark.py`, historique dans `benchmark/historique.csv`, D-069) ; spec `contexte/boucle-automatique.md`.
|
||||
Boucle automatique (D-057), lancée par l'utilisateur seul, sur les lots qu'il choisit : `/boucle <dossier de station> [--du … --au …]` fait juger les détecteurs du journal, lot après lot, par un analyste, les fait corriger par un upgrader contrôlé par un validateur, et ajoute les nouveautés à la base de cas par un builder ; une séance commitée directement sur `master` (D-070), ses rendus dans `boucle/<séance>_<STATION>/lot-NN/` (dont les étiquettes de l'analyste, `etiquettes.json`, D-061, et `score-avant.txt`, le score des détecteurs face à toutes les étiquettes, D-062) et son `bilan.md`, hors de tout dossier de station ; en fin de séance, la page `out/boucle_<séance>.html` montre l'analyste face aux détecteurs (D-066) ; à chaque lot et après chaque modification, le benchmark des détecteurs sur la base de cas (`.claude/skills/boucle/benchmark.py`, historique dans `benchmark/historique.csv`, D-069) ; avec `--ameliorer`, l'améliorateur corrige ensuite le skill et ses agents d'après les relevés du releveur (D-071) ; spec `contexte/boucle-automatique.md`.
|
||||
|
||||
Aiguiser la lecture (D-059), lancé par l'utilisateur seul, sur les lots qu'il choisit : `/aiguiser <dossier de station> [--du … --au …]` améliore les outils de lecture (`agents/diagnostic/outils/`) et leur mode d'emploi, le skill `lire-les-donnees`, que suivent l'analyste et l'agent de diagnostic : un lecteur lit le lot avec le skill, un correcteur le lit à fond avec ses propres scripts et mesure l'écart, un optimiseur modifie le skill, un changement sans gain est annulé ; commandes des fiches lancées en fin de séance (D-064) ; une séance par branche `aiguiser/<séance>_<STATION>`, ses rendus dans `aiguiser/<séance>_<STATION>/lot-NN/` et `bilan.md`, hors de tout dossier de station ; spec `contexte/aiguiser-la-lecture.md`.
|
||||
|
||||
|
||||
@@ -117,11 +117,15 @@ Il construit la base de connaissances (l'utilisateur). Outils : Read, Bash, Writ
|
||||
|
||||
Ajouté le 2026-10-24, commun à tous les processus automatiques. Chaque rendu finit par `## Difficultés` (consigne floue, contradictoire ou absente, chemin, format, commande ; « aucune » sinon). En fin de séance, l'orchestrateur l'appelle une fois, avec ses propres difficultés ; il retrouve la consigne ou le fichier en cause, regroupe les occurrences d'une même cause et note tout dans `docs/ameliorations-processus.md`. Il ne corrige rien : l'utilisateur s'en sert ensuite, dans une autre conversation.
|
||||
|
||||
### Améliorateur : `.claude/agents/ameliorateur.md` (D-071)
|
||||
|
||||
Ajouté le 2026-10-26 à la demande de l'utilisateur, seulement si `/boucle` est lancé avec `--ameliorer`. Après le commit du releveur, il lit les entrées que celui-ci a créées ou complétées pendant la séance et corrige, au plus simple, le skill `/boucle`, `critiquer-lot`, les agents de la boucle, cette spec et `run.md` ; il marque les entrées corrigées **traité**. Il laisse ce qui sort de ces fichiers (outils de lecture, détecteurs, cas) et ce qui changerait ce que fait la boucle plutôt que la façon de le dire, ou reviendrait sur une décision ; l'orchestrateur commite ses fichiers (`Loop <STATION>: process fixes`).
|
||||
|
||||
## 6. Ce que l'utilisateur trouve à la fin
|
||||
|
||||
- Les commits de la séance sur `master`, un par étape, lisibles avec `git log` depuis la base de la séance (notée dans `bilan.md`) ; il annule ce qu'il ne garde pas par `git revert`.
|
||||
- `bilan.md` : une ligne par lot (verdict de l'analyste ; étiquettes ; modification gardée, annulée ou aucune ; cas créés), et le score de fin de séance (`score-fin.txt`) sur toutes les étiquettes de la station ; les suggestions non traitées (nouvelle catégorie, au-delà de deux) ; les nouveautés déjà connues ; les erreurs.
|
||||
- `docs/ameliorations-processus.md` : les difficultés du processus relevées pendant la séance.
|
||||
- `docs/ameliorations-processus.md` : les difficultés du processus relevées pendant la séance ; avec `--ameliorer`, celles que l'améliorateur a corrigées sont marquées **traité**.
|
||||
- La page `out/boucle_<séance>.html` (D-066, ajoutée le 2026-10-26 à la demande de l'utilisateur), ouverte en fin de séance : les courbes de toute la plage ; dessous, une ligne par catégorie, la lecture de l'analyste au-dessus des événements des détecteurs ; le score de la séance. Le but, séance après séance : que les deux coïncident.
|
||||
|
||||
## 7. Essai et première séance
|
||||
|
||||
Reference in new issue
Block a user