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
@@ -79,7 +79,7 @@ et suis-le à la lettre.
|
||||
2. **Repérage** : par capteur, ce qui sort de l'ordinaire de ce capteur (son propre passé, pas un seuil absolu).
|
||||
3. **Tri** (D-047) : une anomalie est un écart daté au comportement habituel du capteur ; une même signature, même répétée, fait une seule anomalie ; ce qui dure toute la période (réglage, capteur toujours rejeté, cycle régulier) n'en est pas une : une ligne en « Hors anomalie », sans enquête.
|
||||
4. **Faits**, par anomalie : début, fin, durée ; capteurs touchés (cibles ou références, combien, lesquels) ; amplitude, retour à la normale ; déplacement associé ou non ; vignettes des images avant, pendant et après, avec un capteur témoin.
|
||||
5. **Cas connus** (§11.4) : après les faits, l'index puis au plus 3 fiches par anomalie ; critères et exclusions vérifiés avec les outils ; correspondance complète, partielle ou aucune.
|
||||
5. **Cas connus** (§11.4) : après les faits, l'index puis au plus 3 fiches par anomalie ; critères vérifiés avec les outils ; correspondance complète, partielle ou aucune.
|
||||
6. **Hypothèses** : avec un cas, son diagnostic ; sinon, dans les familles du §12 : événement externe (occlusion, eau ou buée, turbulence, éclairage), mouvement de l'ouvrage, mouvement de la caméra ou compensation, cible dégradée, problème système, marquées « non validé ».
|
||||
7. **Réfutation obligatoire** de l'hypothèse principale : chercher le fait qui la contredirait, dire ce qu'on a trouvé.
|
||||
8. **Preuves** : les figures qui montrent chaque anomalie (série, zone grisée, capteur non touché pour comparer ; vignettes), écrites dans le dossier du rapport ; deux ou trois au plus, chacune regardée avant d'être retenue.
|
||||
@@ -229,83 +229,82 @@ La plage sélectionnée par « Analyze » est le mode question actuel (§4) rest
|
||||
```
|
||||
agents/diagnostic/cas/
|
||||
INDEX.md la table : seule porte d'entrée de l'agent
|
||||
C-001_<S01>_<AAAA-MM-JJ>/ un dossier par incident (numéro, code de la station, date de début)
|
||||
C-001/ un dossier par incident, à son numéro
|
||||
cas.md la fiche
|
||||
*.png ses figures de preuve
|
||||
displacement/, images/ ses données, noms codés (D-050)
|
||||
```
|
||||
|
||||
- À côté de `rapports/` : un rapport validé devient un cas, et les signatures s'écrivent dans le langage des outils de l'agent.
|
||||
- Les données restent dans `data/<STATION>/` (D-029) ; la fiche cite le dossier et la fenêtre, sans copie.
|
||||
- Les données du cas sont copiées dans son dossier, noms codés (D-050) : la fiche et ses commandes se rejouent sans `data/<STATION>/`, qui garde l'original (D-029).
|
||||
- Le numéro `C-xxx` est la référence stable que cite le rapport.
|
||||
- Un cas n'entre dans l'index qu'une fois validé par l'expert : pas de colonne de statut. L'agent n'ouvre que les fiches que cite l'index.
|
||||
- La base démarre vide : `INDEX.md` n'a que son en-tête.
|
||||
- **Noms codés (D-049)** : dans l'index, les fiches et leurs figures, la station devient `S01`, une référence `R1`, une cible `C1`. Les codes sont stables d'un cas à l'autre et tenus dans le registre du skill `anonymiser-cas`, que l'agent ne lit pas. L'agent rapproche ainsi par la signature, pas par le nom.
|
||||
- **Noms codés (D-049, D-050)** : dans l'index, les fiches, leurs figures et leurs données, la station prend le numéro du cas, une référence devient `R1`, une cible `C1`. Les codes des capteurs sont stables d'un cas à l'autre et tenus dans le registre du skill `anonymiser-cas`, que l'agent ne lit pas. L'agent rapproche ainsi par la signature, pas par le nom.
|
||||
|
||||
### 11.2 L'index
|
||||
|
||||
Une ligne par incident. La colonne **Signature** sert à la recherche : courte, observable seulement (type de capteurs, combien, colonne, forme, moment, durée, retour à la normale).
|
||||
|
||||
| Cas | Station · fenêtre (UTC) | Signature | Classification | Cause (expert) | Verdict expert |
|
||||
| Cas | Événement (UTC) | Signature | Classification | Cause | Verdict |
|
||||
|---|---|---|---|---|---|
|
||||
| *exemple :* C-001 | S01 · 13/10 01:15 → 14/10 05:00 | 2 références sur 3, `error_value` ×5-8, la nuit, 3-5 h, retour seul ; cibles et 3e référence intactes | *camera/reference compensation event* | inconnue | sain, point d'attention |
|
||||
| *exemple :* C-001 | nuit du 13 au 14.10.2026, 23:45 → 05:15 | 2 références sur 3, `error_value` à plusieurs dizaines de MAD, la nuit, quelques heures, puis retour ; autre référence et cibles intactes | *target-local degradation* | buée ou eau (brume), déduite | système sain, rien à faire |
|
||||
|
||||
### 11.3 La fiche (`cas.md`)
|
||||
|
||||
Une cinquantaine de lignes ; les faits viennent du rapport à l'aveugle, le diagnostic de l'expert.
|
||||
Une quarantaine de lignes : le diagnostic de l'expert sur cet événement, produit par l'agent à l'aveugle puis aligné sur l'avis de l'expert (D-051). Les faits viennent du rapport à l'aveugle.
|
||||
|
||||
```markdown
|
||||
# C-xxx : <titre court>
|
||||
# C-xxx
|
||||
|
||||
<STATION> · data/<STATION>/ · <début> → <fin> UTC · avis de l'expert du AAAA-MM-JJ · entré le AAAA-MM-JJ
|
||||
**Lieu** : <région, pays>\
|
||||
**Événement** : <date, heures de début et de fin, UTC>\
|
||||
**Cas créé le** : <date>
|
||||
|
||||
## Résumé
|
||||
<La situation, en 1-2 phrases, sans chiffre.>
|
||||
|
||||
## Symptôme
|
||||
<Ce que l'utilisateur voit sur sa courbe, avec ses mots (1-2 phrases).>
|
||||
<Ce que l'utilisateur voit sur sa courbe (1-2 phrases).>
|
||||
|
||||
## Verdict
|
||||
<La cause, avec son niveau de preuve, et ce qu'il faut faire, en une phrase.>
|
||||
|
||||
## Signature
|
||||
Critères observables, relatifs au niveau habituel du capteur, chacun avec sa commande :
|
||||
1. <critère> : `<commande>`
|
||||
1. <critère> (ici <valeurs du cas>) : `<commande sur le dossier du cas>`
|
||||
|
||||
## Exclusions
|
||||
Ce qui ferait que ce n'est pas ce cas :
|
||||
- <fait> → plutôt <autre classification ou autre cas>
|
||||
|
||||
## Diagnostic de l'expert
|
||||
- **Classification** : <liste fermée, §5> · **Cause** : <…> · **Niveau de preuve** : <…>
|
||||
## Diagnostic
|
||||
- **Classification** : <liste fermée, §5>
|
||||
- **Cause** : <liste fermée du rapport ; ce qui ne se tranche pas> · **Niveau de preuve** : <vue | déduite, pas vue>
|
||||
- **Conséquence pour l'ouvrage** : aucune | mouvement réel | indéterminée · **Action** : aucune | à vérifier | intervention
|
||||
- <L'explication de l'expert en 2-3 phrases ; la vérification ou l'action qu'il recommande.>
|
||||
|
||||
## Attendu de l'agent
|
||||
- **Doit dire** : <…>
|
||||
- **Ne doit pas dire** : <…>
|
||||
|
||||
## Inconnus
|
||||
- <ce que l'expert lui-même n'a pas pu établir>
|
||||
- **Mécanisme** : <pourquoi la cause donne ce qu'on observe, en une phrase>
|
||||
- **<Fait qui pourrait tromper>** : <le fait, et ce qu'en dit l'expert>
|
||||
|
||||
## Preuves
|
||||

|
||||
*<légende d'une ligne>*
|
||||
|
||||
## Test à l'aveugle
|
||||
<Rapport : agents/diagnostic/rapports/<…>/ ; critères atteints ou manqués, en quelques lignes.>
|
||||
*Critères <n>. <légende>*
|
||||
```
|
||||
|
||||
- **Signature et exclusions** portent la recherche et la comparaison : l'agent les coche avec ses outils. Relatives (en MAD), jamais en seuil absolu, qui ne se transpose pas d'une station à l'autre.
|
||||
- **Ce cas seulement** : ni les éventualités d'autres cas (pas d'exclusions), ni l'historique des tests, qui reste dans `rapports/` et l'historique git (D-051).
|
||||
- **Un humain d'abord** : Résumé, Symptôme et Verdict se lisent sans connaître les outils ; Signature et Diagnostic sont ce que l'agent vérifie et reprend.
|
||||
- **Signature** : porte la recherche et la comparaison ; l'agent coche chaque critère en lançant sa commande sur ses propres données. Relative (en MAD), jamais en seuil absolu, qui ne se transpose pas d'une station à l'autre.
|
||||
- **Diagnostic** : un fait du cas qui a trompé l'agent à l'aveugle y figure avec le jugement de l'expert (C-001 : sauts de la compensation jugés négligeables).
|
||||
- **Conséquence pour l'ouvrage et action** : deux listes fermées, ce dont le bouton « Analyze » a besoin.
|
||||
- **Symptôme** : prépare la future question en texte libre (§11.8).
|
||||
- **Attendu de l'agent** : le cas est aussi un test de régression, y compris du refus de conclure au-delà des preuves (§17 du contexte support). Il décrit ce que l'agent doit dire sans ce cas dans l'index (passage à l'aveugle), puis avec (test de correspondance, §11.6).
|
||||
- **Figures copiées** du rapport dans le dossier du cas : l'agent ne lit pas `rapports/`, et un cas reste complet sans son rapport.
|
||||
- **Figures et données dans le dossier du cas** : l'agent ne lit pas `rapports/`, et un cas reste complet sans son rapport ni `data/`.
|
||||
|
||||
### 11.4 Usage par l'agent
|
||||
|
||||
Une étape de plus dans le déroulé (§4 de `instructions.md`), entre « Faits » et « Hypothèses », jamais avant : l'agent établit ses faits sans connaître les cas, pour ne pas plaquer le plus proche (ancrage).
|
||||
|
||||
**Cas connus.** L'agent lit `cas/INDEX.md` à ce moment seulement. Pour chaque anomalie, il choisit au plus 3 cas d'après la signature, ouvre leurs fiches, vérifie chaque critère et chaque exclusion avec ses outils sur ses propres données, puis conclut :
|
||||
**Cas connus.** L'agent lit `cas/INDEX.md` à ce moment seulement. Pour chaque anomalie, il choisit au plus 3 cas d'après la signature, ouvre leurs fiches, vérifie chaque critère avec ses outils sur ses propres données, puis conclut :
|
||||
|
||||
| Correspondance | Quand | Ce que l'agent rend |
|
||||
|---|---|---|
|
||||
| **Complète** | tous les critères vérifiés, toutes les exclusions écartées | le diagnostic de l'expert (classification, cause, conséquence, action) devient son hypothèse principale ; niveau de preuve tiré de ses faits, pas de la fiche ; réfutation toujours obligatoire : un fait contraire fait tomber le cas |
|
||||
| **Partielle** | aucun critère contredit, aucune exclusion observée, mais des critères ou des exclusions non vérifiables (ex. pas d'image) | même hypothèse principale, niveau de preuve plafonné à `consistent with`, critères manquants en « à vérifier » ; conséquence « aucune » ramenée à « indéterminée », « mouvement réel » gardé |
|
||||
| **Aucune** | pour chaque cas ouvert, un critère contredit ou une exclusion observée ; ou aucun cas proche ; ou index vide | ses hypothèses libres, comme avant, marquées « non validé, pour le support » ; conséquence « indéterminée », ou « mouvement réel » si les preuves l'établissent |
|
||||
| **Complète** | tous les critères vérifiés | le diagnostic de l'expert (classification, cause, conséquence, action) devient son hypothèse principale ; niveau de preuve tiré de ses faits, pas de la fiche ; réfutation toujours obligatoire : un fait contraire fait tomber le cas |
|
||||
| **Partielle** | aucun critère contredit, mais des critères non vérifiables (ex. pas d'image) | même hypothèse principale, niveau de preuve plafonné à `consistent with`, critères manquants en « à vérifier » ; conséquence « aucune » ramenée à « indéterminée », « mouvement réel » gardé |
|
||||
| **Aucune** | pour chaque cas ouvert, un critère contredit ; ou aucun cas proche ; ou index vide | ses hypothèses libres, comme avant, marquées « non validé, pour le support » ; conséquence « indéterminée », ou « mouvement réel » si les preuves l'établissent |
|
||||
|
||||
**Règle d'asymétrie** (D-042) : « aucune conséquence pour l'ouvrage » seulement si les trois tiennent : correspondance complète avec un cas validé, niveau de preuve au moins `strongly supported`, mouvement réel de l'ouvrage écarté par la réfutation. Deux cas qui correspondent : la complète avant la partielle, et la conséquence la plus prudente si elles diffèrent. Une fausse assurance coûte plus qu'une fausse alerte.
|
||||
|
||||
@@ -314,7 +313,7 @@ Sources (§2 de `instructions.md`) : `cas/INDEX.md` et les fiches qu'il cite, av
|
||||
### 11.5 Le rapport
|
||||
|
||||
- Le verdict cite les cas : « A1 correspond à C-xxx ».
|
||||
- Chaque anomalie gagne une ligne : **Cas connu** : C-xxx, complète (critères 1 à 4 vérifiés, aucune exclusion) | partielle (critère 4 non vérifiable : pas d'image) | aucun cas connu.
|
||||
- Chaque anomalie gagne une ligne : **Cas connu** : C-xxx, complète (critères 1 à 4 vérifiés) | partielle (critère 4 non vérifiable : pas d'image) | aucun cas connu.
|
||||
- La ligne de classification gagne **Conséquence pour l'ouvrage** et **Action**, les listes fermées de la fiche.
|
||||
- Sans cas correspondant, les hypothèses sont titrées « Non validé (support) ».
|
||||
- La validation gagne une ligne : « Devient un cas : oui (C-xxx) | non ». Elle note la décision ; l'ajout se lance par `/nouveau-cas` (§11.6).
|
||||
@@ -323,12 +322,12 @@ Sources (§2 de `instructions.md`) : `cas/INDEX.md` et les fiches qu'il cite, av
|
||||
|
||||
Procédure tenue par `.claude/skills/nouveau-cas/SKILL.md`, avec `disable-model-invocation` : seul l'utilisateur la lance. Recevoir des données ou valider un rapport n'ajoute pas de cas.
|
||||
|
||||
1. **Réunir** en un message : fichiers, station, fenêtre en UTC, diagnostic de l'expert (symptôme, classification, cause, conséquence, action, explication, inconnus, date). L'avis de l'expert reste dans la conversation jusqu'à l'étape 5.
|
||||
1. **Réunir** en un message : fichiers, station, lieu, fenêtre en UTC, diagnostic de l'expert (symptôme, classification, cause, conséquence, action, explication, ce qu'il n'a pas pu établir, date). L'avis de l'expert reste dans la conversation jusqu'à l'étape 5.
|
||||
2. **Ranger** les données (D-029, D-045) : export dans `data/<STATION>/displacement/`, images renommées en UTC (`<AAAAMMJJ>T<HHMM>Z_<n>.jpg`) ; contrôle par `inventaire.py`.
|
||||
3. **Commit neutre** (rien sur l'incident ni sa cause : le sous-agent reçoit les derniers messages de commit et la branche), arbre propre.
|
||||
4. **Passage à l'aveugle**, la fenêtre de l'incident pour question, comparé à des attendus écrits avant ; un attendu manqué se corrige dans `instructions.md` par une règle générale.
|
||||
5. **Fiche** (signature tirée du rapport, diagnostic de l'expert, figures refaites, noms codés par le skill `anonymiser-cas`, D-049) et ligne d'index avec lien, montrées à l'utilisateur et validées avant commit.
|
||||
6. **Test de correspondance** : l'agent relancé, le cas dans l'index, doit trouver `C-xxx, complète` (ou partielle) et le diagnostic de l'expert. Il vérifie la mécanique, pas le jugement : l'agent a lu la fiche.
|
||||
5. **Fiche** au modèle du §11.3 (données copiées dans le cas et noms codés par le skill `anonymiser-cas`, D-049, D-050 ; signature tirée du rapport ; diagnostic de l'expert ; figures refaites sur les données du cas) et ligne d'index avec lien, montrées à l'utilisateur et validées avant commit.
|
||||
6. **Test de correspondance** : l'agent relancé, le cas dans l'index, doit trouver `C-xxx, complète` (ou partielle) et le diagnostic de l'expert. Il vérifie la mécanique, pas le jugement : l'agent a lu la fiche. Le résultat va dans le message de commit, pas dans la fiche.
|
||||
|
||||
Un cas ne touche ni `CLAUDE.md`, ni cette spec, ni `docs/decisions.md` : l'index est le registre.
|
||||
|
||||
@@ -336,7 +335,7 @@ Un cas ne touche ni `CLAUDE.md`, ni cette spec, ni `docs/decisions.md` : l'index
|
||||
|
||||
- **Mise en place**, index vide : relancer le scan de PS des Coudres. Attendu : le même diagnostic que le deuxième passage (§7), avec « aucun cas connu », conséquence « indéterminée » et des hypothèses « non validé (support) » ; `INDEX.md` lu après les faits, pas avant.
|
||||
- **Chaque nouveau cas** teste la recherche sans effort de plus : l'agent qui le découvre (étape 2 de §11.6) doit répondre « aucun cas connu » ou citer le bon cas, jamais un faux.
|
||||
- **Rejouer un cas** : retirer sa ligne de `INDEX.md` sans commiter, lancer l'agent sur sa fenêtre, comparer à « Attendu de l'agent », restaurer la ligne.
|
||||
- **Rejouer un cas** : retirer sa ligne de `INDEX.md` sans commiter, lancer l'agent sur sa fenêtre, comparer au Verdict et au Diagnostic de la fiche, restaurer la ligne.
|
||||
|
||||
**Mise en place, le 2026-10-14 (index vide).** Scan à l'aveugle de `data/PS_DES_COUDRES/` sur un arbre propre (branche `base-de-cas`, après commit). Rapport : `agents/diagnostic/rapports/2026-10-14T1436Z_PS_DES_COUDRES/` ; 44 appels d'outils, 190 s, ~89 k tokens.
|
||||
|
||||
|
||||
Reference in new issue
Block a user