Events: read-event skill to consult the base (D-085), cases renamed events E-xxx (D-086)

- read-event: map and index first, then the card of close events only,
  then their data with the reading tools; never all cards at once.
  Diagnostic agent, critiquer-lot and builder point to it; the index
  header too. Signature length: about 250 characters, a guideline.
- "Cas" becomes "event": events/E-xxx/event.md, skills new-event,
  review-event, anonymize-event.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-29 07:25:29 +01:00
1 parent 4d99585474
commit 446fde3192
1206 files changed
+2172 -2129

No files matched your search

+59 -59
View File
@@ -1,7 +1,7 @@
# Agent de diagnostic (pilote dans Claude Code)
- **Date** : 2026-10-14.
- **Statut** : construit le 2026-10-14 (outils, instructions, point d'entrée) ; révisé le même jour après le premier test (D-047) : rapports courts, preuves en figures, anomalies seules ; tests à l'aveugle : §7 ; base de cas construite le 2026-10-14 (D-048, §11), vide ; révisé le 2026-10-24 (D-058) : plus à l'aveugle, il lit la connaissance du projet et part des événements des détecteurs du journal, pour être le plus précis possible sur un cas que les détecteurs n'expliquent pas. Décisions liées : D-046, D-047, D-048 (`docs/decisions.md`).
- **Statut** : construit le 2026-10-14 (outils, instructions, point d'entrée) ; révisé le même jour après le premier test (D-047) : rapports courts, preuves en figures, anomalies seules ; tests à l'aveugle : §7 ; base d'events construite le 2026-10-14 (D-048, §11), vide ; révisé le 2026-10-24 (D-058) : plus à l'aveugle, il lit la connaissance du projet et part des événements des détecteurs du journal, pour être le plus précis possible sur un cas que les détecteurs n'expliquent pas. Décisions liées : D-046, D-047, D-048 (`docs/decisions.md`).
- **Place** : version pilote, la plus légère, de l'enquête à la demande (D-042) et du cadre d'agents (D-027). Mêmes idées (outils en lecture, réfutation obligatoire, preuves tracées), mais exécutée par Claude Code au lieu du harnais par API : pas de clé API, pas de harnais à écrire.
---
@@ -33,7 +33,7 @@ agent-diagnostic/
instructions.md sa méthode : règles, déroulé, format du rapport
outils/ ses scripts Python ; leur mode d'emploi : .claude/skills/lire-les-donnees/ (D-059)
rapports/ un rapport par diagnostic
cas/ cas validés par l'expert : INDEX.md et une fiche par incident (§11)
cas/ events validés par l'expert : INDEX.md et une fiche par incident (§11)
```
- **Appel** : `@agent-diagnostic data/PS_DES_COUDRES/` suivi, au choix, d'une question ; ou en langage naturel (« lance l'agent diagnostic sur … ») ; ou une session entière dans un terminal : `claude --agent diagnostic`, mais elle charge `CLAUDE.md` (`omitClaudeMd` ne vaut que pour un sous-agent) : elle n'est pas à l'aveugle.
@@ -70,7 +70,7 @@ et suis-le à la lettre.
**Sources** (D-058 : plus à l'aveugle) :
- les données du dossier (CSV, images) ;
- la connaissance du projet sur les déplacements : `docs/domaine/`, `docs/displacement/` (cadrage, carte des événements…), les docs AIMsight par section ;
- toute la base de cas, `events/` (§11), à l'étape 5, après les faits ;
- toute la base d'events, `events/` (§11), à l'étape 5, après les faits ;
- pas ce qui rend déjà un avis sur des données : les rapports de l'agent, `vues-deplacements/` (parcours), les séances de `boucle/` et `aiguiser/`, le code des détecteurs (`detectors/`), `CLAUDE.md`, `docs/decisions.md`, `docs/superpowers/`.
**Déroulé** (d'après le §13 du contexte support) :
@@ -78,8 +78,8 @@ et suis-le à la lettre.
2. **Repérage** : les événements des détecteurs du journal (`detectors/categories.py`, D-058) d'abord, sans les juger ; puis, 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 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é ».
5. **Events 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 event, 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.
9. **Rapport** (§5).
@@ -91,7 +91,7 @@ et suis-le à la lettre.
- rien sur `inlier` ; `sigma0` jamais suffisant seul ; ne pas confondre mode commun et mouvement structurel, ni références cohérentes et références physiquement fixes (D-058 : une mise en garde, plus une conclusion imposée) ; un trou n'est pas forcément une coupure ;
- toute heure en UTC ; chaque preuve cite la commande qui l'a produite ;
- « rien d'anormal » est une conclusion valable ;
- asymétrie : « aucune conséquence pour l'ouvrage » seulement avec une correspondance complète à un cas (§11.4) ;
- asymétrie : « aucune conséquence pour l'ouvrage » seulement avec une correspondance complète à un event (§11.4) ;
- écrire court : corps du rapport en ~40 lignes, chiffres arrondis, pas de valeurs pas à pas ;
- lecture seule : n'écrire que son rapport et ses figures ;
- rapport en français, termes AIMsight en anglais.
@@ -101,17 +101,17 @@ et suis-le à la lettre.
Un dossier par diagnostic, `agent-diagnostic/rapports/<AAAA-MM-JJTHHMMZ>_<STATION>[_<sujet>]/` (l'heure évite les doublons sans lister les rapports précédents, qui pourraient trahir une conclusion) : `rapport.md` et ses figures PNG, versionnées avec lui. Format (D-047), le corps en ~40 lignes :
1. **En-tête** d'une ligne : données (dossier, période), scan ou question, modèle, date.
2. **Verdict** : 2-3 phrases ; la station fonctionne-t-elle normalement, et ses anomalies par importance, avec leur cas connu.
2. **Verdict** : 2-3 phrases ; la station fonctionne-t-elle normalement, et ses anomalies par importance, avec leur event connu.
3. **Une section par anomalie** :
- le constat en 2-3 phrases ;
- les figures de preuve, chacune avec une légende d'une ligne : la série (anomalie grisée, capteur témoin), les vignettes des images s'il y en a ;
- une ligne **cas connu** : le cas et sa correspondance (complète, partielle, aucune), §11.4 ;
- une ligne **event connu** : l'event et sa correspondance (complète, partielle, aucune), §11.4 ;
- une ligne : **classification** (liste fermée : *monitored-object motion*, *camera/reference compensation event*, *weak/unstable reference solution*, *model mismatch/parallax*, *target-local degradation* (§4.3 de la roadmap), problème système, indéterminé), niveau de preuve, **cause probable** (buée ou eau, occlusion, turbulence, éclairage, inconnue), **conséquence pour l'ouvrage** (aucune, mouvement réel, indéterminée), **action** (aucune, à vérifier, intervention) ; sans cas connu, la ligne est marquée « Non validé (support) » ;
- une ligne de réfutation ; une ligne : non établi et vérification à faire ;
- les commandes de chaque fait, repliées (`<details>`).
4. **Hors anomalie** : trois lignes au plus.
5. **Annexe** : sources lues, données disponibles et manquantes, seuil de repérage.
6. **Validation**, laissée vide pour l'utilisateur : accepté tel quel ou corrigé (en quoi), diagnostic final, devient un cas (oui, C-xxx, ou non) ; l'ajout se lance par `/nouveau-cas` (§11.6).
6. **Validation**, laissée vide pour l'utilisateur : accepté tel quel ou corrigé (en quoi), diagnostic final, devient un event (oui, E-xxx, ou non) ; l'ajout se lance par `/new-event` (§11.6).
## 6. Outils (`agent-tools/`)
@@ -160,7 +160,7 @@ Un attendu manqué ou une conclusion au-delà des preuves se corrige dans `instr
- **Corrections des instructions** : une : signaler un contexte reçu sans l'avoir ouvert ; une commande `Bash` simple par appel (une boucle `for` avait été refusée).
- **À valider par l'utilisateur** : la classification *camera/reference compensation event* (plutôt que *target-local degradation*), l'effet sur les cibles, et le cycle journalier de `corr_y` (mouvement thermique ou parallaxe, non tranché).
**Avis du spécialiste (2026-10-14) : le cas de référence.** À PS des Coudres, le système fonctionne correctement ; le seul point d'attention est `REF_G` et `REF_D`, dont l'erreur monte en pics étranges. Le premier passage les avait trouvés (E1, E2 du scan), mais noyés parmi trois événements et cinq constats permanents (14 Ko), et ses graphiques restaient dans `out/`, hors du rapport. D'où trois corrections demandées par l'utilisateur : moins de texte, des preuves (graphiques, images) dans le rapport, les anomalies seules (D-047). Reste à voir avec le spécialiste : l'agent affirme que ces pics biaisent la compensation (marche de `corr_x` de BJ_G à 03:30Z le 14/10, sans mouvement de sa position brute), ce qui se concilie mal avec « le système fonctionne correctement ».
**Avis du spécialiste (2026-10-14) : l'event de référence.** À PS des Coudres, le système fonctionne correctement ; le seul point d'attention est `REF_G` et `REF_D`, dont l'erreur monte en pics étranges. Le premier passage les avait trouvés (E1, E2 du scan), mais noyés parmi trois événements et cinq constats permanents (14 Ko), et ses graphiques restaient dans `out/`, hors du rapport. D'où trois corrections demandées par l'utilisateur : moins de texte, des preuves (graphiques, images) dans le rapport, les anomalies seules (D-047). Reste à voir avec le spécialiste : l'agent affirme que ces pics biaisent la compensation (marche de `corr_x` de BJ_G à 03:30Z le 14/10, sans mouvement de sa position brute), ce qui se concilie mal avec « le système fonctionne correctement ».
**Deuxième passage (format D-047) : scan à l'aveugle.** Attendus, écrits avant le passage :
@@ -207,9 +207,9 @@ Rapport : `agent-diagnostic/rapports/2026-10-14T1357Z_PS_DES_COUDRES/` ; 38 appe
- **Graphiques par plotly** : un PNG demande kaleido, qui embarque un navigateur.
- **Pas de graphique** : l'agent verrait mal les formes des séries (cycle jour/nuit, marche).
## 11. Base de cas (D-048)
## 11. Base d'events (D-048)
**Le besoin (utilisateur).** Le diagnostic marche, mais il manque de déterminisme : l'agent reçoit tout, ne sait pas où regarder et peut conclure hors sujet. Usage visé : sur le site, l'utilisateur sélectionne une plage de données et clique sur « Analyze » ; l'agent tourne sur les séries et les images de la plage, puis le notifie. Il faut contrôler ce que l'agent rend. Proposition de l'utilisateur : des cas connus, validés par les experts du métier, chacun documenté et décrit dans une table que l'agent consulte ; son verdict s'appuie sur les cas proches.
**Le besoin (utilisateur).** Le diagnostic marche, mais il manque de déterminisme : l'agent reçoit tout, ne sait pas où regarder et peut conclure hors sujet. Usage visé : sur le site, l'utilisateur sélectionne une plage de données et clique sur « Analyze » ; l'agent tourne sur les séries et les images de la plage, puis le notifie. Il faut contrôler ce que l'agent rend. Proposition de l'utilisateur : des events connus, validés par les experts du métier, chacun documenté et décrit dans une table que l'agent consulte ; son verdict s'appuie sur les events proches.
**Choix de l'utilisateur, sur proposition :**
@@ -217,9 +217,9 @@ Rapport : `agent-diagnostic/rapports/2026-10-14T1357Z_PS_DES_COUDRES/` ; 38 appe
|---|---|
| Recherche | **Un index Markdown lu par l'agent** ; ni base vectorielle, ni filtre par script (§11.8) |
| Granularité | **Une fiche par incident** : un upload donne un dossier |
| Cas reçus | **Les données et le diagnostic de l'expert** |
| Sans cas correspondant | **Les faits, puis les hypothèses de l'agent marquées « non validé »**, pour le support seulement |
| Ajout d'un cas | **Seulement sur demande explicite de l'utilisateur** ; jamais de lui-même, même à la réception de données ; skill `/nouveau-cas`, lancé par l'utilisateur seul |
| Events reçus | **Les données et le diagnostic de l'expert** |
| Sans event correspondant | **Les faits, puis les hypothèses de l'agent marquées « non validé »**, pour le support seulement |
| Ajout d'un event | **Seulement sur demande explicite de l'utilisateur** ; jamais de lui-même, même à la réception de données ; skill `/new-event`, lancé par l'utilisateur seul |
La plage sélectionnée par « Analyze » est le mode question actuel (§4) restreint à une fenêtre ; rien ne change à l'entrée de l'agent.
@@ -228,40 +228,40 @@ La plage sélectionnée par « Analyze » est le mode question actuel (§4) rest
```
events/
INDEX.md la table : seule porte d'entrée de l'agent
C-001/ un dossier par incident, à son numéro
cas.md la fiche
E-001/ un dossier par incident, à son numéro
event.md la fiche
*.png ses figures de preuve
displacement/, camera/, images/ ses données, noms codés (D-050)
etiquettes.json son diagnostic à la création, mesure par mesure (D-069)
etiquetage.md d'où viennent ces étiquettes, et la lecture qui les a produites
```
- À 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 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.
- **`etiquettes.json`** (D-069) : le diagnostic du cas au format des étiquettes de l'analyste de `/boucle` (D-061), noms codés, figé à la création comme le reste du cas. Le benchmark des détecteurs (`.claude/skills/boucle/benchmark.py`) les compare, mesure par mesure. Un cas appris le reçoit du builder (`anonymiser.py --etiquettes`) ; C-001 à C-005 l'ont reçu d'un passage unique de l'analyste, corrigé par leur fiche (2026-10-26) ; un cas de `/nouveau-cas`, de même. Chaque cas a, à côté, `etiquetage.md` : la lecture de l'analyste et ce que la fiche y a changé, ou, pour un cas appris, le lot d'origine et le tableau des moments.
- 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.
- À côté de `rapports/` : un rapport validé devient un event, et les signatures s'écrivent dans le langage des outils de l'agent.
- Les données de l'event 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 `E-xxx` est la référence stable que cite le rapport.
- **`etiquettes.json`** (D-069) : le diagnostic de l'event au format des étiquettes de l'analyste de `/boucle` (D-061), noms codés, figé à la création comme le reste de l'event. Le benchmark des détecteurs (`.claude/skills/boucle/benchmark.py`) les compare, mesure par mesure. Un event appris le reçoit du builder (`anonymiser.py --etiquettes`) ; E-001 à E-005 l'ont reçu d'un passage unique de l'analyste, corrigé par leur fiche (2026-10-26) ; un event de `/new-event`, de même. Chaque event a, à côté, `etiquetage.md` : la lecture de l'analyste et ce que la fiche y a changé, ou, pour un event appris, le lot d'origine et le tableau des moments.
- Un event 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, 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.
- **Noms codés (D-049, D-050)** : dans l'index, les fiches, leurs figures et leurs données, la station prend le numéro de l'event, une référence devient `R1`, une cible `C1`. Les codes des capteurs sont stables d'un event à l'autre et tenus dans le registre du skill `anonymize-event`, 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).
Une ligne par incident. La colonne **Signature** sert à la recherche : courte (environ 250 caractères, une indication et non une limite ; le détail dans la fiche, D-085), observable seulement (type de capteurs, combien, colonne, forme, moment, durée, retour à la normale). Mode d'emploi de la base, pour qui la consulte : skill `read-event`.
| Cas | Événement (UTC) | Signature | Classification | Cause | Verdict |
| Event | Événement (UTC) | Signature | Classification | Cause | Verdict |
|---|---|---|---|---|---|
| *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 |
| *exemple :* E-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`)
### 11.3 La fiche (`event.md`)
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
# E-xxx
**Lieu** : <région, pays>\
**Événement** : <date, heures de début et de fin, UTC>\
**Cas créé le** : <date>
**Event créé le** : <date>
## Résumé
<La situation, en 1-2 phrases, sans chiffre.>
@@ -274,7 +274,7 @@ Une quarantaine de lignes : le diagnostic de l'expert sur cet événement, produ
## Signature
Critères observables, relatifs au niveau habituel du capteur, chacun avec sa commande :
1. <critère> (ici <valeurs du cas>) : `<commande sur le dossier du cas>`
1. <critère> (ici <valeurs de l'event>) : `<commande sur le dossier de l'event>`
## Diagnostic
- **Classification** : <liste fermée, §5>
@@ -288,61 +288,61 @@ Critères observables, relatifs au niveau habituel du capteur, chacun avec sa co
*Critères <n>. <légende>*
```
- **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).
- **Cet event seulement** : ni les éventualités d'autres events (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).
- **Diagnostic** : un fait de l'event qui a trompé l'agent à l'aveugle y figure avec le jugement de l'expert (E-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).
- **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/`.
- **Figures et données dans le dossier de l'event** : l'agent ne lit pas `rapports/`, et un event 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).
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 events, pour ne pas plaquer le plus proche (ancrage).
**Cas connus.** L'agent lit `events/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 :
**Events connus.** L'agent lit `events/INDEX.md` à ce moment seulement. Pour chaque anomalie, il choisit au plus 3 events 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 | 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 |
| **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 l'event |
| **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, marquées « non validé, pour le support » ; la conséquence que ses preuves établissent, « mouvement réel » ou « indéterminée » (« aucune » demande un cas : asymétrie) |
| **Aucune** | pour chaque event ouvert, un critère contredit ; ou aucun event proche ; ou index vide | ses hypothèses libres, marquées « non validé, pour le support » ; la conséquence que ses preuves établissent, « mouvement réel » ou « indéterminée » (« aucune » demande un event : asymétrie) |
**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.
**Règle d'asymétrie** (D-042) : « aucune conséquence pour l'ouvrage » seulement si les trois tiennent : correspondance complète avec un event validé, niveau de preuve au moins `strongly supported`, mouvement réel de l'ouvrage écarté par la réfutation. Deux events 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.
Sources (§2 de `instructions.md`) : toute la base, `events/INDEX.md`, les fiches et leurs figures, à cette étape (D-058).
### 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) | partielle (critère 4 non vérifiable : pas d'image) | aucun cas connu.
- Le verdict cite les events : « A1 correspond à E-xxx ».
- Chaque anomalie gagne une ligne : **Event connu** : E-xxx, complète (critères 1 à 4 vérifiés) | partielle (critère 4 non vérifiable : pas d'image) | aucun event 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).
- Sans event correspondant, les hypothèses sont titrées « Non validé (support) ».
- La validation gagne une ligne : « Devient un event : oui (E-xxx) | non ». Elle note la décision ; l'ajout se lance par `/new-event` (§11.6).
### 11.6 Ajouter un cas : le skill `/nouveau-cas`
### 11.6 Ajouter un event : le skill `/new-event`
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.
Procédure tenue par `.claude/skills/new-event/SKILL.md`, avec `disable-model-invocation` : seul l'utilisateur la lance. Recevoir des données ou valider un rapport n'ajoute pas d'events.
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** 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.
5. **Fiche** au modèle du §11.3 (données copiées dans le cas et noms codés par le skill `anonymize-event`, D-049, D-050 ; signature tirée du rapport ; diagnostic de l'expert ; figures refaites sur les données de l'event) et ligne d'index avec lien, montrées à l'utilisateur et validées avant commit.
6. **Test de correspondance** : l'agent relancé, l'event dans l'index, doit trouver `E-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.
Un event ne touche ni `CLAUDE.md`, ni cette spec, ni `docs/decisions.md` : l'index est le registre.
### 11.7 Vérification
- **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 au Verdict et au Diagnostic de la fiche, restaurer la ligne.
- **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 event connu », conséquence « indéterminée » et des hypothèses « non validé (support) » ; `INDEX.md` lu après les faits, pas avant.
- **Chaque nouvel event** teste la recherche sans effort de plus : l'agent qui le découvre (étape 2 de §11.6) doit répondre « aucun event connu » ou citer le bon event, jamais un faux.
- **Rejouer un event** : 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.
**Revue de C-001, le 2026-10-15.** Fiche relue section par section avec l'utilisateur :
- les données de la station sont copiées dans le cas, noms codés, et la station prend le numéro du cas (D-050) ;
**Revue de E-001, le 2026-10-15.** Fiche relue section par section avec l'utilisateur :
- les données de la station sont copiées dans le cas, noms codés, et la station prend le numéro de l'event (D-050) ;
- la fiche devient le diagnostic de l'expert sur ce seul événement, en six sections, sans exclusions, attendu, inconnus ni historique des tests (D-051) ;
- deux faits corrigés en revérifiant sur les données du cas : R2 monte en 2 h 30, pas d'un coup ; `corr_x` de C3 ne revient pas à son niveau d'avant l'épisode avant le jour ;
- deux faits corrigés en revérifiant sur les données de l'event : R2 monte en 2 h 30, pas d'un coup ; `corr_x` de C3 ne revient pas à son niveau d'avant l'épisode avant le jour ;
- les sauts de `corr_x` aux bascules de R3, cause du classement en *camera/reference compensation event* à l'aveugle, sont jugés négligeables.
Le test de correspondance n'a pas été relancé sur la fiche revue, par choix de l'utilisateur : le dernier passage (2026-10-14) portait sur l'ancien format, avec exclusions.
@@ -352,10 +352,10 @@ Le test de correspondance n'a pas été relancé sur la fiche revue, par choix d
| Attendu | Résultat |
|---|---|
| 1. Même diagnostic que le deuxième passage | atteint : une seule anomalie, `REF_G` et `REF_D` les deux nuits (13/10 00:45 → 04:15Z ; 13/10 22:45Z → 14/10 05:15Z, bornes un peu plus larges qu'au deuxième passage) ; 3 figures dans le dossier du rapport, vignettes avec témoins |
| 2. « Cas connu : aucun cas connu (index vide) » | atteint |
| 2. « Event connu : aucun event connu (index vide) » | atteint |
| 3. « Non validé (support) », conséquence indéterminée, action | atteint : *camera/reference compensation event*, conséquence « indéterminée », action « à vérifier » |
| 4. Sources : `INDEX.md`, ni fiche ni rapport | atteint |
| 5. « Devient un cas » dans la validation | atteint, laissé vide |
| 5. « Devient un event » dans la validation | atteint, laissé vide |
| 6. Corps en ~40 lignes | atteint : 39 lignes |
| Ordre de lecture | atteint : `INDEX.md` au 27e appel, après les faits (inventaire, résumés, graphiques, vignettes et images, appels 4 à 26) et avant les familles d'hypothèses (§12, appels 28 à 32) |
@@ -364,14 +364,14 @@ Le test de correspondance n'a pas été relancé sur la fiche revue, par choix d
### 11.8 Laissé de côté
- **Filtre structuré** (en-tête de fiche et script `cas.py`), puis peut-être **RAG vectorielle** : quand l'index ne tiendra plus en une lecture (quelques centaines de cas), ou quand la question arrivera en texte libre (ticket, client) : le champ Symptôme y prépare.
- **Filtre structuré** (en-tête de fiche et script `event.py`), puis peut-être **RAG vectorielle** : quand l'index ne tiendra plus en une lecture (quelques centaines d'events), ou quand la question arrivera en texte libre (ticket, client) : le champ Symptôme y prépare.
- **Entrée « fenêtre » dédiée** pour le bouton : le mode question la couvre.
### 11.9 Options écartées
- **RAG vectorielle maintenant** : à quelques dizaines de cas, l'index tient en une lecture et l'agent choisit mieux qu'un top-k ; deux cas se ressemblent par leur signature observable, pas par leur texte (deux fiches rédigées de même peuvent décrire « toutes les références bougent » et « une seule bouge ») ; modèle d'embeddings tiers et base à maintenir.
- **RAG vectorielle maintenant** : à quelques dizaines d'events, l'index tient en une lecture et l'agent choisit mieux qu'un top-k ; deux events se ressemblent par leur signature observable, pas par leur texte (deux fiches rédigées de même peuvent décrire « toutes les références bougent » et « une seule bouge ») ; modèle d'embeddings tiers et base à maintenir.
- **Fiches chargées dans les instructions** (D-042) : l'agent les lirait avant les données, ancrage maximal.
- **Une fiche par type, ses incidents dedans** : index plus court, mais l'utilisateur préfère un dossier par upload.
- **Toujours le cas le plus proche** : rien n'est jamais inconnu, ancrage le plus fort.
- **Faits seuls, sans hypothèse hors cas** : contrôle maximal, mais le support repart de zéro.
- **Toujours l'event le plus proche** : rien n'est jamais inconnu, ancrage le plus fort.
- **Faits seuls, sans hypothèse hors event** : contrôle maximal, mais le support repart de zéro.
- **Lien vers les figures du rapport** : l'agent ne lit pas `rapports/`.