From 3662851f06703f217f9fcee24163b8af5362cef7 Mon Sep 17 00:00:00 2001 From: maxime Date: Wed, 14 Oct 2026 16:45:45 +0200 Subject: [PATCH] Tighten case matching after review: exclusions, asymmetry, two-case rule Co-Authored-By: Claude Opus 5.5 --- agents/diagnostic/instructions.md | 18 +++++++++--------- docs/agents/agent-diagnostic.md | 8 ++++---- 2 files changed, 13 insertions(+), 13 deletions(-) diff --git a/agents/diagnostic/instructions.md b/agents/diagnostic/instructions.md index 3192aeb..274b51f 100644 --- a/agents/diagnostic/instructions.md +++ b/agents/diagnostic/instructions.md @@ -24,7 +24,7 @@ Seulement : Pour un long fichier AIMsight, trouve la section avec `grep -n '^#' `, puis lis-la seule (Read avec `offset` et `limit`). -**Ne lis rien d'autre** : ni `CLAUDE.md`, ni `docs/decisions.md`, ni les autres documents du projet, ni les rapports de `agents/diagnostic/rapports/`, ni une fiche de `agents/diagnostic/cas/` que l'index ne cite pas. Ils peuvent contenir des conclusions sur ces données ; ton diagnostic doit partir des données. Tu listes dans ton rapport tout ce que tu as lu. Si l'environnement t'a fourni un contexte que tu n'as pas ouvert (ex. `CLAUDE.md`), signale-le dans « Sources lues » et ne t'en sers pas. +**Ne lis rien d'autre** : ni `CLAUDE.md`, ni `docs/decisions.md`, ni les autres documents du projet, ni les rapports de `agents/diagnostic/rapports/`, ni une fiche de `agents/diagnostic/cas/` que l'index ne cite pas. Ne liste pas `agents/diagnostic/cas/` : l'index est ta seule porte d'entrée. Ils peuvent contenir des conclusions sur ces données ; ton diagnostic doit partir des données. Tu listes dans ton rapport tout ce que tu as lu. Si l'environnement t'a fourni un contexte que tu n'as pas ouvert (ex. `CLAUDE.md`), signale-le dans « Sources lues » et ne t'en sers pas. ## 3. Tes outils @@ -64,18 +64,18 @@ Ton enquête est complète ; ton rapport ne garde que ce qui sert la conclusion. - images, s'il y en a : `vignettes.py` sur les capteurs touchés **et un capteur témoin non touché**, à une heure avant, pendant et après l'anomalie (à la même heure de la journée si possible) ; l'image entière pour la scène. 5. **Cas connus**, après les faits, jamais avant : sinon tu chercherais ce que dit le cas au lieu de ce que montrent les données. - Lis `agents/diagnostic/cas/INDEX.md`. Pour chaque anomalie, choisis au plus 3 cas dont la signature est proche de tes faits et ouvre leurs fiches. - - Vérifie chaque critère de la signature et chaque exclusion de la fiche sur **tes** données, avec tes outils : vérifié, contredit ou non vérifiable (donnée absente). + - Vérifie la fiche sur **tes** données, avec tes outils : chaque critère de la signature : vérifié, contredit ou non vérifiable (donnée absente) ; chaque exclusion : écartée, observée ou non vérifiable. - Conclus, par anomalie : | Correspondance | Quand | Suite | |---|---|---| - | **complète** | tous les critères vérifiés, aucune exclusion observée | le diagnostic de l'expert (classification, cause, conséquence, action) est ton hypothèse principale | - | **partielle** | aucun critère contredit, certains non vérifiables | même hypothèse principale ; niveau de preuve au plus `consistent with` ; conséquence « aucune » ramenée à « indéterminée » (« mouvement réel » reste) ; les critères non vérifiables vont en « à vérifier » | - | **aucune** | pour chaque cas ouvert, un critère contredit ou une exclusion observée ; ou index vide | tes propres hypothèses (étape 6), marquées « Non validé (support) » ; conséquence « indéterminée » | + | **complète** | tous les critères vérifiés, toutes les exclusions écartées | le diagnostic de l'expert (classification, cause, conséquence, action) est ton hypothèse principale ; le niveau de preuve est le tien, tiré de tes faits, pas celui de la fiche | + | **partielle** | aucun critère contredit, aucune exclusion observée, mais des critères ou des exclusions non vérifiables | même hypothèse principale ; niveau de preuve au plus `consistent with` ; conséquence « aucune » ramenée à « indéterminée » (« mouvement réel » reste) ; les critères et exclusions non vérifiables vont en « à vérifier » | + | **aucune** | pour chaque cas ouvert, un critère contredit ou une exclusion observée ; ou aucun cas proche ; ou index vide | tes propres hypothèses (étape 6), marquées « Non validé (support) » ; conséquence « indéterminée », ou « mouvement réel » si tes preuves l'établissent | - - Si deux cas correspondent, garde celui qui a le plus de critères vérifiés et cite l'autre. + - Si deux cas correspondent, préfère une correspondance complète à une partielle, puis celui qui a le plus de critères vérifiés. Si leurs conséquences diffèrent, garde la plus prudente (mouvement réel, puis indéterminée, puis aucune). Cite l'autre cas. 6. **Hypothèses** : avec un cas (correspondance complète ou partielle), l'hypothèse principale est son diagnostic ; ajoute les alternatives que tes faits n'écartent pas. Sans cas, prends-les dans les familles de la section 12 du contexte support, plus le mouvement réel de l'ouvrage. Pour chacune, ce qui la soutient et ce qui la contredit. -7. **Réfutation obligatoire** de l'hypothèse principale : cherche le fait qui la contredirait, avec un outil, et dis ce que tu as trouvé. Exemple : on pense à un mouvement de l'ouvrage ; les références ont-elles bougé ? Toutes les cibles ensemble ? +7. **Réfutation obligatoire** de l'hypothèse principale : cherche le fait qui la contredirait, avec un outil, et dis ce que tu as trouvé. Exemple : on pense à un mouvement de l'ouvrage ; les références ont-elles bougé ? Toutes les cibles ensemble ? Avec un cas, si la réfutation trouve un fait contraire, le cas ne correspond pas : reprends l'étape 6 sans lui. 8. **Preuves** : pour chaque anomalie, refais les figures qui la montrent, cette fois avec `--sortie` vers le dossier du rapport (§6) : - un graphique de la série qui la montre le mieux, sur une fenêtre qui laisse voir le niveau habituel autour, l'anomalie grisée (`--zone`), avec au moins un capteur non touché pour comparer ; - la planche de vignettes, s'il y a des images pendant l'anomalie ; @@ -91,7 +91,7 @@ Ton enquête est complète ; ton rapport ne garde que ce qui sert la conclusion. - Un trou n'est pas forcément une coupure : acquisition, traitement, transport et affichage sont des couches distinctes. - Toute heure est en UTC. - « Rien d'anormal » est une conclusion valable. -- **Asymétrie** : « Conséquence pour l'ouvrage : aucune » seulement avec une correspondance complète à un cas (étape 5). Sinon « indéterminée », ou « mouvement réel » si tes preuves l'établissent. Une fausse assurance coûte plus qu'une fausse alerte. +- **Asymétrie** : « Conséquence pour l'ouvrage : aucune » seulement si les trois tiennent : correspondance complète à un cas (étape 5), niveau de preuve au moins `strongly supported`, et un mouvement réel de l'ouvrage écarté par la réfutation (étape 7). Sinon « indéterminée », ou « mouvement réel » si tes preuves l'établissent. Une fausse assurance coûte plus qu'une fausse alerte. - **Écris court.** Des phrases simples ; des chiffres arrondis (deux chiffres significatifs) ; pas de valeurs pas à pas, la figure les montre. Le corps du rapport (jusqu'à « Hors anomalie » compris) tient en 40 lignes environ, figures comprises. - Lecture seule : tu n'écris que ton rapport et ses figures. - Rapport en français ; termes AIMsight en anglais (classifications, noms de colonnes). @@ -117,7 +117,7 @@ Un dossier par rapport : `agents/diagnostic/rapports/_](.png) ** (Ou, sans image pendant l'anomalie : « Pas d'image pendant l'anomalie. ») -- **Cas connu** : ) | aucun cas connu ( ou index vide)> +- **Cas connu** : ) | aucun cas connu ( | aucun cas proche | index vide)> - **Classification** : · **Niveau de preuve** : … · **Cause probable** : · **Conséquence pour l'ouvrage** : · **Action** : . Sans cas connu, la ligne commence par « **Non validé (support)** : ». - **Réfutation** : → - **Non établi** : ; **à vérifier** : diff --git a/docs/agents/agent-diagnostic.md b/docs/agents/agent-diagnostic.md index ed3a948..5a19df6 100644 --- a/docs/agents/agent-diagnostic.md +++ b/docs/agents/agent-diagnostic.md @@ -302,11 +302,11 @@ Une étape de plus dans le déroulé (§4 de `instructions.md`), entre « Faits | Correspondance | Quand | Ce que l'agent rend | |---|---|---| -| **Complète** | tous les critères vérifiés, aucune exclusion observée | le diagnostic de l'expert (classification, cause, conséquence, action) devient son hypothèse principale ; réfutation toujours obligatoire | -| **Partielle** | aucun critère contredit, certains 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 index vide | ses hypothèses libres, comme avant, marquées « non validé, pour le support » ; conséquence « indéterminée » | +| **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 | -**Règle d'asymétrie** (D-042) : « aucune conséquence pour l'ouvrage » ne sort que d'une correspondance complète avec un cas validé. 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 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. Sources (§2 de `instructions.md`) : `cas/INDEX.md` et les fiches qu'il cite, avec leurs figures, à cette étape seulement.