Review case C-001: data in the case, shorter human-first case file
Copy the station's displacement export and images into the case folder, with coded sensor names; the station takes the case number instead of S01, and graphique.py / vignettes.py drop --alias (D-050). Rewrite C-001 as the expert's diagnosis of this event only: summary, symptom, verdict, signature with commands, diagnosis, evidence. Drop exclusions, expected output, unknowns and test history; matching no longer uses exclusions (D-051). The corr_x jumps at the reference switches are judged negligible. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
43a1438550
commit
46bc89b8ad
44 files changed
+8216
-202
No files matched your search
+24
-2
@@ -530,7 +530,7 @@ Règles du journal :
|
||||
- **Conséquence** : l'avis du spécialiste devient le cas de référence de l'agent (§7 de `docs/agents/agent-diagnostic.md`) ; des PNG entrent dans le dépôt, quelques centaines de Ko par rapport.
|
||||
|
||||
## D-048 — 2026-10-14 — Agent de diagnostic : une base de cas validés, consultée après les faits
|
||||
- **Statut** : active, construite le 2026-10-14 (spec : §11 de `docs/agents/agent-diagnostic.md`) ; base vide ; ajout d'un cas par le skill `/nouveau-cas`, lancé par l'utilisateur seul. Remplace en partie D-042 (base de cas chargée dans le prompt).
|
||||
- **Statut** : active, construite le 2026-10-14 (spec : §11 de `docs/agents/agent-diagnostic.md`) ; remplacée en partie par D-050 (les données vont dans le cas) et D-051 (format de la fiche, plus d'exclusions) ; un cas, C-001 ; ajout d'un cas par le skill `/nouveau-cas`, lancé par l'utilisateur seul. Remplace en partie D-042 (base de cas chargée dans le prompt).
|
||||
- **Décision** :
|
||||
- une base de cas validés par l'expert, `agents/diagnostic/cas/` : `INDEX.md`, une ligne par incident (signature observable, classification, cause, verdict), et un dossier par incident avec sa fiche `cas.md` (symptôme, signature, exclusions, diagnostic de l'expert avec conséquence pour l'ouvrage et action en listes fermées, attendu de l'agent, inconnus, figures, test à l'aveugle) ; les données restent dans `data/` ;
|
||||
- l'agent lit l'index **après** avoir établi ses faits, ouvre au plus 3 fiches par anomalie et coche critères et exclusions avec ses outils : correspondance complète, partielle ou aucune ;
|
||||
@@ -542,7 +542,7 @@ Règles du journal :
|
||||
- **Conséquence** : un cas est aussi un test de régression (retirer sa ligne de l'index pour le rejouer) ; filtre structuré ou RAG quand l'index ne tiendra plus en une lecture ou que la question arrivera en texte libre.
|
||||
|
||||
## D-049 — 2026-10-14 — Base de cas : noms de station et de capteurs codés
|
||||
- **Statut** : active (skill `anonymiser-cas`, appelé à l'étape 5 de `/nouveau-cas`) ; appliquée à C-001, dont le test de correspondance réussit avec les codes.
|
||||
- **Statut** : active (skill `anonymiser-cas`, appelé à l'étape 5 de `/nouveau-cas`) ; appliquée à C-001, dont le test de correspondance réussit avec les codes ; remplacée en partie par D-050 (plus de code de station, plus de `--alias`).
|
||||
- **Décision** :
|
||||
- dans `agents/diagnostic/cas/` (index, fiches, noms de fichiers, figures), la station devient `S01`, une référence `R1`, une cible `C1` (numérotation par station) ;
|
||||
- un registre unique, `.claude/skills/anonymiser-cas/registre.csv`, ne fait que grandir : un nom garde son code d'un cas à l'autre ; l'agent ne le lit pas ;
|
||||
@@ -550,3 +550,25 @@ Règles du journal :
|
||||
- **Pourquoi** : demande de l'utilisateur : ne pas influencer l'agent par le nom du site, des cibles ou des références ; il doit rapprocher un cas par sa signature, et une anonymisation constante se fait mieux par un skill que par des choix au cas par cas.
|
||||
- **Options écartées** : codes propres à chaque cas (pas de constance d'un cas à l'autre) ; codes qui gardent un sens (`REF_GAUCHE`) ; rendre les images floues ou les masquer (preuves perdues) ; anonymiser `rapports/` (l'agent ne les lit pas).
|
||||
- **Conséquence** : les commandes d'une fiche portent des codes et se rejouent avec le registre ; les images montrent encore le site.
|
||||
|
||||
## D-050 — 2026-10-15 — Base de cas : les données dans le cas, la station au numéro du cas
|
||||
- **Statut** : active ; appliquée à C-001 (`agents/diagnostic/cas/C-001/`). Remplace en partie D-048 (données laissées dans `data/`) et D-049 (code de station `S01`, option `--alias`).
|
||||
- **Décision** :
|
||||
- le dossier d'un cas s'appelle `C-xxx/` et contient ses données : `displacement/` et `images/` de la station, copiés entiers, noms des capteurs codés dans les CSV et les noms de fichiers ; `data/<STATION>/` garde l'original ;
|
||||
- la station n'a plus de code : partout dans la base, elle prend le numéro du cas ; les capteurs gardent leurs codes `R1`, `C1` ; le registre relie chaque cas à sa station (ligne `<station>,<station>,C-xxx`) ;
|
||||
- les commandes et les figures d'une fiche portent le dossier du cas et se rejouent telles quelles ; `graphique.py` et `vignettes.py` perdent `--alias`, inutile sur des données déjà codées.
|
||||
- **Pourquoi** : demande de l'utilisateur à la revue de C-001 : un cas doit porter ses données, et `S01` n'apportait rien de plus que le numéro du cas ; les commandes en `data/S01/` ne se rejouaient pas.
|
||||
- **Options écartées** : citer `data/<STATION>/` par son code et traduire par le registre (une commande qui ne tourne pas telle quelle) ; copier la seule fenêtre du cas (le niveau habituel, en MAD, se calcule sur toute la période de l'export) ; garder les vrais noms dans les données copiées (la fiche codée ne s'y rejoue plus, et l'agent pourrait les lire).
|
||||
- **Conséquence** : un cas pèse ses données (C-001 : ~7 Mo, dont 5,4 Mo d'images, identiques à celles de `data/` pour git) ; `inventaire.py` sur un dossier de cas compte ses figures comme des images sans heure ; seuls `displacement/` et `images/` sont copiés : les mesures système d'une station et leurs identifiants (`SIM_CCID`, `ip`) n'entrent pas dans un cas.
|
||||
|
||||
## D-051 — 2026-10-15 — Base de cas : une fiche courte, lisible d'abord par un humain, sur ce seul cas
|
||||
- **Statut** : active ; appliquée à C-001, revu avec l'utilisateur le 2026-10-15 (modèle : §11.3 de `docs/agents/agent-diagnostic.md`). Remplace en partie D-048 (sections de la fiche, exclusions dans la correspondance).
|
||||
- **Décision** :
|
||||
- la fiche est le diagnostic de l'expert sur ce seul événement, produit par l'agent puis aligné sur son avis ; elle ne prévoit pas les autres cas et ne raconte pas ses tests ;
|
||||
- en-tête : lieu (région, pays), événement (date, heures UTC), date de création du cas ; puis six sections : **Résumé**, **Symptôme**, **Verdict** (pour un humain, sans chiffre ; la cause garde son niveau de preuve), **Signature** (critères avec leur commande sur les données du cas), **Diagnostic** (listes fermées, mécanisme en une phrase, faits qui pourraient tromper l'agent avec le jugement de l'expert), **Preuves** (chaque légende cite les critères qu'elle montre) ;
|
||||
- retirées : Exclusions, Attendu de l'agent, Inconnus (ce qui ne se tranche pas va dans la ligne Cause), Test à l'aveugle (résultats dans `rapports/` et les messages de commit), citation de l'expert (seul son mécanisme reste) ;
|
||||
- correspondance : complète = tous les critères vérifiés ; partielle = aucun critère contredit, certains non vérifiables ; aucune = un critère contredit ;
|
||||
- index : colonnes Événement, Cause (avec niveau de preuve) et Verdict court.
|
||||
- **Pourquoi** : revue de C-001 par l'utilisateur : un humain doit comprendre le cas d'emblée ; les exclusions décrivaient d'autres cas, avec des hypothèses non validées par l'expert ; l'attendu et les tests parlent de l'agent, pas de l'événement ; la citation répétait le reste de la fiche.
|
||||
- **Options écartées** : critères sans commande (l'agent vérifierait à sa façon, la comparaison perd sa précision) ; exclusions gardées en critères positifs (sortent de ce cas) ; tests dans un `tests.md` du cas (sans intérêt pour l'utilisateur) ; section Inconnus pour un seul point.
|
||||
- **Conséquence** : sans exclusion, la réfutation obligatoire de l'agent (étape 7 de `instructions.md`) reste le seul garde-fou contre un vrai mouvement de l'ouvrage, avec la règle d'asymétrie ; à revoir si un test de correspondance conclut « aucune conséquence » à tort. C-001 : les sauts de `corr_x` aux bascules des références, cause du mauvais classement à l'aveugle, sont jugés négligeables et figurent dans le Diagnostic.
|
||||
Reference in new issue
Block a user