diff --git a/agents/diagnostic/cas/INDEX.md b/agents/diagnostic/cas/INDEX.md new file mode 100644 index 0000000..0f6b95d --- /dev/null +++ b/agents/diagnostic/cas/INDEX.md @@ -0,0 +1,8 @@ +# Cas connus + +Incidents validés par l'expert, un par ligne. La **Signature** résume ce qu'on observe : type de capteurs, combien, colonne, forme, moment, durée, retour à la normale. Ouvre la fiche d'un cas proche par son lien ; ses critères et ses exclusions se vérifient avec tes outils, sur tes données. + +| Cas | Station · fenêtre (UTC) | Signature | Classification | Cause (expert) | Verdict expert | +|---|---|---|---|---|---| + +*Base vide pour l'instant.* diff --git a/agents/diagnostic/instructions.md b/agents/diagnostic/instructions.md index 3adf79b..3192aeb 100644 --- a/agents/diagnostic/instructions.md +++ b/agents/diagnostic/instructions.md @@ -20,10 +20,11 @@ Seulement : - `docs/aimsight/AIMsight_agentic_support_project_context.md`, sections 4 (chaîne de dépendance), 12 (familles d'hypothèses) et 13 (*support query workflow*) ; - `docs/aimsight/AIMsight_reference_quality_event_explainer_roadmap.md`, section 4.3 (classifications) ; - `docs/aimsight/AIMsight FAQ.pdf`, pour `error` : `pdftotext -layout "docs/aimsight/AIMsight FAQ.pdf" - | grep -n -i -B2 -A12 'error value'`. +- à l'étape 5 du déroulé (§4) seulement, jamais avant : `agents/diagnostic/cas/INDEX.md`, puis les fiches `cas.md` qu'il cite et leurs figures. Ce sont des incidents validés par l'expert. 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/`. 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. 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 @@ -61,13 +62,25 @@ Ton enquête est complète ; ton rapport ne garde que ce qui sert la conclusion. - amplitude face au niveau habituel ; retour à la normale ; - déplacement associé (`corr_x`, `corr_y`) ou non ; mesures rejetées ; - 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. **Hypothèses** : 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. -6. **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. **Preuves** : pour chaque anomalie, refais les figures qui la montrent, cette fois avec `--sortie` vers le dossier du rapport (§6) : +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). + - 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 » | + + - Si deux cas correspondent, garde celui qui a le plus de critères vérifiés et cite l'autre. +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 ? +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 ; - deux ou trois figures au plus par anomalie. Regarde chacune (Read) : une figure qui ne montre pas clairement le constat ne va pas dans le rapport. -8. **Rapport** (§6), puis ta réponse (§7). +9. **Rapport** (§6), puis ta réponse (§7). ## 5. Règles @@ -78,6 +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. - **É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). @@ -92,7 +106,7 @@ Un dossier par rapport : `agents/diagnostic/rapports/_ ; mesures du au (UTC) · · · diagnostic du AAAA-MM-JJ ## Verdict -<2-3 phrases : la station fonctionne-t-elle normalement ? Les anomalies, par importance, une ligne chacune. Ou : aucune anomalie.> +<2-3 phrases : la station fonctionne-t-elle normalement ? Les anomalies, par importance, une ligne chacune, avec le cas connu qui leur correspond. Ou : aucune anomalie.> ## A1 : ( → UTC ; ) @@ -103,7 +117,8 @@ Un dossier par rapport : `agents/diagnostic/rapports/_](.png) ** (Ou, sans image pendant l'anomalie : « Pas d'image pendant l'anomalie. ») -- **Classification** : · **Niveau de preuve** : … · **Cause probable** : +- **Cas connu** : ) | aucun cas connu ( ou 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** : @@ -125,10 +140,11 @@ Un dossier par rapport : `agents/diagnostic/rapports/_