Open the diagnostic agent to project knowledge and the journal detectors (D-058)
The agent now serves one precise case, reads the project's displacement knowledge and the whole case base, starts from the detectors' events without judging them, and no longer has conclusions imposed on it. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
54d1c6a142
commit
4d14f5ea5d
5 files changed
+40
-28
No files matched your search
@@ -12,13 +12,13 @@ Agent de diagnostic proactif pour **AIMsight**, un système de surveillance opti
|
|||||||
- **Maquettes du site (D-022, D-039)** : client « System Summary », une page par station de `data/`, un bloc par domaine mesuré dans la section Diagnostic (Energy, Storage, Cellular, Temperature) ; support « Home » (section Status, une notification par station et par domaine Orange ou Red, lien vers la vue client de la station, D-025).
|
- **Maquettes du site (D-022, D-039)** : client « System Summary », une page par station de `data/`, un bloc par domaine mesuré dans la section Diagnostic (Energy, Storage, Cellular, Temperature) ; support « Home » (section Status, une notification par station et par domaine Orange ou Red, lien vers la vue client de la station, D-025).
|
||||||
- **Agents LLM côté serveur (D-027)** : rapport exploratoire seulement, rien n'est construit.
|
- **Agents LLM côté serveur (D-027)** : rapport exploratoire seulement, rien n'est construit.
|
||||||
- **Séries optiques (D-044)** : détecter les événements externes (occlusion, pluie, turbulence) dans les déplacements et produire une courbe corrigée, la brute gardée ; cadrage (`docs/displacement/cadrage.md`) ; données reçues (D-045) : PS des Coudres, export 15 min en UTC sur 5,5 jours, sans événement annoté (buée probable le matin), et 24 images horaires de la caméra, puis NORDEND, WILDSTRUBEL, CLARIDEN et NIEDERHORN, chacune devenue un cas de la base ; CLARIDEN est l'incident de Barcelone de la doc AIMsight, où l'expert voit un mouvement réel de l'ouvrage, la doc une instabilité des références (`docs/displacement/domaine/incident-de-barcelone.md`) ; deux rapports d'analyse AIMsight (murs GN-1.472 et GN-5.054), causes des déplacements apparents selon l'expert, sans leurs données ; exploration confiée d'abord à l'agent de diagnostic (D-046), chaîne analytique au second plan.
|
- **Séries optiques (D-044)** : détecter les événements externes (occlusion, pluie, turbulence) dans les déplacements et produire une courbe corrigée, la brute gardée ; cadrage (`docs/displacement/cadrage.md`) ; données reçues (D-045) : PS des Coudres, export 15 min en UTC sur 5,5 jours, sans événement annoté (buée probable le matin), et 24 images horaires de la caméra, puis NORDEND, WILDSTRUBEL, CLARIDEN et NIEDERHORN, chacune devenue un cas de la base ; CLARIDEN est l'incident de Barcelone de la doc AIMsight, où l'expert voit un mouvement réel de l'ouvrage, la doc une instabilité des références (`docs/displacement/domaine/incident-de-barcelone.md`) ; deux rapports d'analyse AIMsight (murs GN-1.472 et GN-5.054), causes des déplacements apparents selon l'expert, sans leurs données ; exploration confiée d'abord à l'agent de diagnostic (D-046), chaîne analytique au second plan.
|
||||||
- **Agent de diagnostic (D-046), gardé en l'état (D-052)** : pilote de l'enquête à la demande (D-042) dans Claude Code : sous-agent `diagnostic` (`.claude/agents/diagnostic.md`, dossier `agents/diagnostic/`, spec `docs/agents/agent-diagnostic.md`) ; un dossier de `data/` et une question facultative donnent un rapport court dans `agents/diagnostic/rapports/<date>_<STATION>/` : verdict, anomalies seules, chacune montrée par un graphique et des vignettes des images (D-047) ; déplacements et images seulement ; cas de référence du spécialiste : PS des Coudres est sain, seule anomalie les pics d'erreur de `REF_G` et `REF_D` ; base de cas validés (D-048, `agents/diagnostic/cas/`), lue après les faits : cinq cas, C-001 à C-005 (l'index `agents/diagnostic/cas/INDEX.md` en est le registre), chaque cas avec ses données, la station au numéro du cas et les capteurs codés (D-049, D-050, skill `anonymiser-cas`), une fiche courte sur ce seul cas, lisible d'abord par un humain (D-051) ; un cas n'y entre que sur demande explicite de l'utilisateur (skill `/nouveau-cas`). L'enquête par API (D-042) reste un document.
|
- **Agent de diagnostic (D-046, révisé par D-058)** : pilote de l'enquête à la demande (D-042) dans Claude Code, appelé pour un cas précis que les détecteurs n'expliquent pas ; plus à l'aveugle : il lit la connaissance du projet et part des événements des détecteurs du journal, sans les juger, et n'ajoute aucun cas ; sous-agent `diagnostic` (`.claude/agents/diagnostic.md`, dossier `agents/diagnostic/`, spec `docs/agents/agent-diagnostic.md`) ; un dossier de `data/` et une question facultative donnent un rapport court dans `agents/diagnostic/rapports/<date>_<STATION>/` : verdict, anomalies seules, chacune montrée par un graphique et des vignettes des images (D-047) ; déplacements et images seulement ; cas de référence du spécialiste : PS des Coudres est sain, seule anomalie les pics d'erreur de `REF_G` et `REF_D` ; base de cas validés (D-048, `agents/diagnostic/cas/`), lue après les faits : cinq cas, C-001 à C-005 (l'index `agents/diagnostic/cas/INDEX.md` en est le registre), chaque cas avec ses données, la station au numéro du cas et les capteurs codés (D-049, D-050, skill `anonymiser-cas`), une fiche courte sur ce seul cas, lisible d'abord par un humain (D-051) ; un cas n'y entre que par `/nouveau-cas`, lancé par l'utilisateur, ou par le builder de la boucle (D-057). L'enquête par API (D-042) reste un document.
|
||||||
- **Storage (D-030, D-034, D-035)** : jeu de travail WEISSHORN seul (NORDEND n'a pas les mesures de `/data`) ; `DAILY_STORAGE_STATE` et `DAYS_UNTIL_STORAGE_FULL` en prototype, sans cas de l'expert ; couleur du jour codée (`src/storage/day_color.py`, matrice état × horizon `docs/storage/matrice-etat-horizon.drawio`, la pire des deux) ; seuils arbitraires (20 % / 10 % libres, 60 / 14 jours) ; questions en suspens dans `docs/storage/domaine/questions-pour-l-expert.md` ; livré en prototype (D-039) : figure du site `src/storage/final.py`, bloc de la vue client, notification support, guide `docs/storage/guide/`.
|
- **Storage (D-030, D-034, D-035)** : jeu de travail WEISSHORN seul (NORDEND n'a pas les mesures de `/data`) ; `DAILY_STORAGE_STATE` et `DAYS_UNTIL_STORAGE_FULL` en prototype, sans cas de l'expert ; couleur du jour codée (`src/storage/day_color.py`, matrice état × horizon `docs/storage/matrice-etat-horizon.drawio`, la pire des deux) ; seuils arbitraires (20 % / 10 % libres, 60 / 14 jours) ; questions en suspens dans `docs/storage/domaine/questions-pour-l-expert.md` ; livré en prototype (D-039) : figure du site `src/storage/final.py`, bloc de la vue client, notification support, guide `docs/storage/guide/`.
|
||||||
- **Cellular (D-030 à D-032, D-037), en pause en attendant le spécialiste** : WEISSHORN (mise en service le 19/08, puis quelques incidents isolés) et NORDEND (109 jours, 11 coupures de la liaison) explorés ; `DAILY_LINK_STATE` et `DAILY_SIGNAL_STATE` en prototype, sans cas de l'expert ; deux corrections de `DAILY_LINK_STATE` retenues sur le principe mais non codées ; couleur du jour codée (`src/cellular/day_color.py`, matrice lien × signal `docs/cellular/matrice-lien-signal.drawio` : Red si des envois manquent et que le signal n'est pas mesuré 20 h sur 24) ; livré en prototype avant les réponses du spécialiste (D-039) : figure du site `src/cellular/final.py`, bloc de la vue client, notification support, guide `docs/cellular/guide/`. Reprise : `docs/cellular/domaine/questions-pour-l-expert.md`.
|
- **Cellular (D-030 à D-032, D-037), en pause en attendant le spécialiste** : WEISSHORN (mise en service le 19/08, puis quelques incidents isolés) et NORDEND (109 jours, 11 coupures de la liaison) explorés ; `DAILY_LINK_STATE` et `DAILY_SIGNAL_STATE` en prototype, sans cas de l'expert ; deux corrections de `DAILY_LINK_STATE` retenues sur le principe mais non codées ; couleur du jour codée (`src/cellular/day_color.py`, matrice lien × signal `docs/cellular/matrice-lien-signal.drawio` : Red si des envois manquent et que le signal n'est pas mesuré 20 h sur 24) ; livré en prototype avant les réponses du spécialiste (D-039) : figure du site `src/cellular/final.py`, bloc de la vue client, notification support, guide `docs/cellular/guide/`. Reprise : `docs/cellular/domaine/questions-pour-l-expert.md`.
|
||||||
- **Temperature (D-040)** : jeux de travail WEISSHORN et NORDEND (VERMONT n'a pas le GPU) ; `DAILY_GPU_TEMPERATURE_LIMIT` en prototype, sans cas de l'expert : une moyenne horaire du GPU ≥ 97,5 °C (limite du Jetson Nano, carte supposée) dans les 24 dernières heures ; couleur du jour codée (`src/temperature/day_color.py` : Red si atteinte, sinon Green, pas d'orange) ; tous les jours Green (maximum 57,2 °C) ; livré en prototype (D-041) : figure du site `src/temperature/final.py`, bloc de la vue client, notification support, guide `docs/temperature/guide/`. Constats, pistes et questions dans `docs/temperature/domaine/point-de-depart.md`.
|
- **Temperature (D-040)** : jeux de travail WEISSHORN et NORDEND (VERMONT n'a pas le GPU) ; `DAILY_GPU_TEMPERATURE_LIMIT` en prototype, sans cas de l'expert : une moyenne horaire du GPU ≥ 97,5 °C (limite du Jetson Nano, carte supposée) dans les 24 dernières heures ; couleur du jour codée (`src/temperature/day_color.py` : Red si atteinte, sinon Green, pas d'orange) ; tous les jours Green (maximum 57,2 °C) ; livré en prototype (D-041) : figure du site `src/temperature/final.py`, bloc de la vue client, notification support, guide `docs/temperature/guide/`. Constats, pistes et questions dans `docs/temperature/domaine/point-de-depart.md`.
|
||||||
- **Dev container (D-038)** : Docker Engine dans WSL, `.devcontainer/` (Python 3.14, plotly, matplotlib, réseau de l'hôte) ; prépare la communication avec la caméra, en attente de la doc de l'API REST.
|
- **Dev container (D-038)** : Docker Engine dans WSL, `.devcontainer/` (Python 3.14, plotly, matplotlib, réseau de l'hôte) ; prépare la communication avec la caméra, en attente de la doc de l'API REST.
|
||||||
- **Journal du matin (D-056), le cap actuel** : retour au simple, côté support : une anomalie de déplacement est tout ce qui rend les courbes non plates : presque toujours sans gravité, un moment où il ne faut pas se fier aux données (pluie, buée, train, toile d'araignée, turbulence…), parfois grave, un vrai mouvement (Barcelone : la voûte du pont s'affaisse) ; onglet `Journal` de la maquette Explore : courbes nettoyées en mm (px au choix), la brute en gris dans les zones à ignorer, frise « What happened » dépliable par catégorie, journal en cartes aux phrases catégoriques, bouton `▶ Images` ; un détecteur élémentaire par fichier dans `vues-deplacements/journal/` (`visibilite`, `sauts`, `thermique`, `turbulence`, `trous`, contrat `detect(mesures)`), réglés sur les cas C-001 à C-005, classés en onze catégories par `categories.py` (aussi outil de tri en lot, toujours 3 jours d'historique) ; prototypé dans Support-Agent ; contexte dans `vues-deplacements/contexte/` (brainstorming `journal-du-matin.md`, seuils, lissage, données et boucle), carte des événements `docs/displacement/domaine/carte-des-evenements.md` ; pompage `extraction/pomper.py` (lecture seule, jamais lancé ; application de référence : `~/monitoring-dashboard`) ; boucle automatique `/boucle <dossier>` (D-057, construite, fonctionnement validé ; lancée par l'utilisateur seul, lot par lot, sur de nouvelles données) : analyste, upgrader, validateur et builder, lot après lot, tout commité sur une branche par séance (spec `vues-deplacements/contexte/boucle-automatique.md`) ; tout le suivi est dans le plan `docs/superpowers/plans/2026-10-23-journal-du-matin.md`.
|
- **Journal du matin (D-056), le cap actuel** : retour au simple, côté support : une anomalie de déplacement est tout ce qui rend les courbes non plates : presque toujours sans gravité, un moment où il ne faut pas se fier aux données (pluie, buée, train, toile d'araignée, turbulence…), parfois grave, un vrai mouvement (Barcelone : la voûte du pont s'affaisse) ; onglet `Journal` de la maquette Explore : courbes nettoyées en mm (px au choix), la brute en gris dans les zones à ignorer, frise « What happened » dépliable par catégorie, journal en cartes aux phrases catégoriques, bouton `▶ Images` ; un détecteur élémentaire par fichier dans `vues-deplacements/journal/` (`visibilite`, `sauts`, `thermique`, `turbulence`, `trous`, contrat `detect(mesures)`), réglés sur les cas C-001 à C-005, classés en onze catégories par `categories.py` (aussi outil de tri en lot, toujours 3 jours d'historique) ; prototypé dans Support-Agent ; contexte dans `vues-deplacements/contexte/` (brainstorming `journal-du-matin.md`, seuils, lissage, données et boucle), carte des événements `docs/displacement/domaine/carte-des-evenements.md` ; pompage `extraction/pomper.py` (lecture seule, jamais lancé ; application de référence : `~/monitoring-dashboard`) ; boucle automatique `/boucle <dossier>` (D-057, construite, fonctionnement validé ; lancée par l'utilisateur seul, lot par lot, sur de nouvelles données) : analyste, upgrader, validateur et builder, lot après lot, tout commité sur une branche par séance (spec `vues-deplacements/contexte/boucle-automatique.md`) ; tout le suivi est dans le plan `docs/superpowers/plans/2026-10-23-journal-du-matin.md`.
|
||||||
- **Prochaine étape** : **journal du matin (D-056)** : les points du plan encore en attente (pompage, première séance de la boucle par l'utilisateur, test « Claude verrait la même chose », portage), sur les consignes de l'utilisateur, dans d'autres conversations ; un point validé n'est plus repris ; ensuite, **déplacements (D-052 à D-055)** : détection mécanique des anomalies (D-055) : onglet `Displacements` de la maquette Explore, les sauts (brutaux et qui durent, retours compris) et les tendances (dérive lente et régulière), ce que regarde le client ; le survol d'une ligne les montre sur les courbes, échelle fixe (2026-10-19) ; très expérimental, seuils provisoires, sur NORDEND seuls PR17 et PR06 les passent, nettement (`vues-deplacements/contexte/detection-d-anomalies.md`) ; suite : la suite des retours de l'utilisateur, puis les pistes notées (accélération, cible qui se sépare de ses voisines) ; maquette de la page Explore (`vues-deplacements/maquette/`, cas NORDEND, D-054) : onglet View pour les images (glisseur, comparaison à ±24 h, `error_value` sur chaque capteur, gros plan des cibles avec les images d'avant et d'après), onglet Diagnosis pour les données (déplacements en mm et `error_value` des cibles choisies sur une plage, demande à l'agent composée sans être lancée) ; vérifiée par captures, clics à essayer, état dans `vues-deplacements/maquette/spec.md` ; cas NORDEND laissé là le 2026-10-16, PR17 sans explication claire (`vues-deplacements/cas/2026-10_NORDEND/parcours.md`) ; suite, à la demande de l'utilisateur : la sortie de l'agent dans la page, les annotations d'épisodes (à croiser avec l'agent), d'autres cas ; `cellular` : l'utilisateur voit avec le spécialiste les questions de `docs/cellular/domaine/questions-pour-l-expert.md` (cadence des envois, articulation des deux corrections de `DAILY_LINK_STATE`, retenues mais non codées, cas annotés) ; ensuite les corrections, à reporter dans le guide ; `storage` : les réponses de l'expert (seuils, disque plein, purge, cas), puis les seuils et le guide ; `temperature` : confirmer la carte et ses seuils sur une station (question 1 de `docs/temperature/domaine/point-de-depart.md`), puis le guide si la limite change ; repérer d'autres champs à notifier ; étape 1 du rapport d'agents (pilote manuel Energy sur l'historique de VERMONT, il faut une clé API Anthropic) ; mise en forme du manuel avec le plugin Interactive Docs (dans une autre conversation) ; choisir avec l'équipe du site le format d'intégration du graphique ; maquettes : poursuivre côté client pas à pas, puis côté support (points ouverts dans D-022 et D-039) ; agent de diagnostic : l'utilisateur valide le rapport du second passage sur PS des Coudres (§7 de sa spec) ; d'autres cas de la base, quand l'utilisateur les apporte et le demande.
|
- **Prochaine étape** : **journal du matin (D-056)** : les points du plan encore en attente (pompage, première séance de la boucle par l'utilisateur, test « Claude verrait la même chose », portage), sur les consignes de l'utilisateur, dans d'autres conversations ; un point validé n'est plus repris ; ensuite, **déplacements (D-052 à D-055)** : détection mécanique des anomalies (D-055) : onglet `Displacements` de la maquette Explore, les sauts (brutaux et qui durent, retours compris) et les tendances (dérive lente et régulière), ce que regarde le client ; le survol d'une ligne les montre sur les courbes, échelle fixe (2026-10-19) ; très expérimental, seuils provisoires, sur NORDEND seuls PR17 et PR06 les passent, nettement (`vues-deplacements/contexte/detection-d-anomalies.md`) ; suite : la suite des retours de l'utilisateur, puis les pistes notées (accélération, cible qui se sépare de ses voisines) ; maquette de la page Explore (`vues-deplacements/maquette/`, cas NORDEND, D-054) : onglet View pour les images (glisseur, comparaison à ±24 h, `error_value` sur chaque capteur, gros plan des cibles avec les images d'avant et d'après), onglet Diagnosis pour les données (déplacements en mm et `error_value` des cibles choisies sur une plage, demande à l'agent composée sans être lancée) ; vérifiée par captures, clics à essayer, état dans `vues-deplacements/maquette/spec.md` ; cas NORDEND laissé là le 2026-10-16, PR17 sans explication claire (`vues-deplacements/cas/2026-10_NORDEND/parcours.md`) ; suite, à la demande de l'utilisateur : la sortie de l'agent dans la page, les annotations d'épisodes (à croiser avec l'agent), d'autres cas ; `cellular` : l'utilisateur voit avec le spécialiste les questions de `docs/cellular/domaine/questions-pour-l-expert.md` (cadence des envois, articulation des deux corrections de `DAILY_LINK_STATE`, retenues mais non codées, cas annotés) ; ensuite les corrections, à reporter dans le guide ; `storage` : les réponses de l'expert (seuils, disque plein, purge, cas), puis les seuils et le guide ; `temperature` : confirmer la carte et ses seuils sur une station (question 1 de `docs/temperature/domaine/point-de-depart.md`), puis le guide si la limite change ; repérer d'autres champs à notifier ; étape 1 du rapport d'agents (pilote manuel Energy sur l'historique de VERMONT, il faut une clé API Anthropic) ; mise en forme du manuel avec le plugin Interactive Docs (dans une autre conversation) ; choisir avec l'équipe du site le format d'intégration du graphique ; maquettes : poursuivre côté client pas à pas, puis côté support (points ouverts dans D-022 et D-039) ; agent de diagnostic : ses outils propres, pour plus de précision (dans une autre conversation), et l'utilisateur valide le rapport du second passage sur PS des Coudres (§7 de sa spec) ; d'autres cas de la base, quand l'utilisateur les apporte et le demande.
|
||||||
|
|
||||||
## Analyses (domaine Energy)
|
## Analyses (domaine Energy)
|
||||||
|
|
||||||
@@ -107,7 +107,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .
|
|||||||
### Fichiers
|
### Fichiers
|
||||||
|
|
||||||
- `README.md` (40 l) : point d'entrée pour un humain.
|
- `README.md` (40 l) : point d'entrée pour un humain.
|
||||||
- `docs/decisions.md` (636 l, D-001 à D-056) : décisions **projet**, au format ADR allégé (statut, décision, pourquoi, options écartées, conséquence). À consulter avant de changer d'orientation ou de reproposer une option : elle a peut-être déjà été écartée.
|
- `docs/decisions.md` (665 l, D-001 à D-058) : décisions **projet**, au format ADR allégé (statut, décision, pourquoi, options écartées, conséquence). À consulter avant de changer d'orientation ou de reproposer une option : elle a peut-être déjà été écartée.
|
||||||
- `docs/domaine/` : savoir métier commun, une note courte (< 50 l) par question.
|
- `docs/domaine/` : savoir métier commun, une note courte (< 50 l) par question.
|
||||||
- `ce-que-mesure-la-station.md` : format CSV, métriques et unités, consommation mesurée mais pas l'apport.
|
- `ce-que-mesure-la-station.md` : format CSV, métriques et unités, consommation mesurée mais pas l'apport.
|
||||||
- `pieges-des-donnees.md` : trou ≠ coupure, signatures d'une coupure, seuils absolus, cycle jour/nuit.
|
- `pieges-des-donnees.md` : trou ≠ coupure, signatures d'une coupure, seuils absolus, cycle jour/nuit.
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
# Agent de diagnostic
|
# Agent de diagnostic
|
||||||
|
|
||||||
Un sous-agent Claude Code qui diagnostique les données d'une station : il repère les anomalies, les montre (graphiques, vignettes des images), les explique avec des preuves et dit ce qui reste non établi. Première version : déplacements optiques (export « advanced ») et images de la caméra. Pilote de l'enquête à la demande (D-042) ; décision D-046 ; spec : `docs/agents/agent-diagnostic.md`.
|
Un sous-agent Claude Code qui diagnostique les données d'une station : il repère les anomalies, les montre (graphiques, vignettes des images), les explique avec des preuves et dit ce qui reste non établi. Première version : déplacements optiques (export « advanced ») et images de la caméra. On l'appelle pour un cas précis, que les détecteurs du journal n'expliquent pas : il part de leurs événements et de toute la connaissance du projet (D-058), sans les juger, et n'ajoute rien à la base de cas. Pilote de l'enquête à la demande (D-042) ; décision D-046 ; spec : `docs/agents/agent-diagnostic.md`.
|
||||||
|
|
||||||
## L'appeler
|
## L'appeler
|
||||||
|
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
# Instructions de l'agent de diagnostic
|
# Instructions de l'agent de diagnostic
|
||||||
|
|
||||||
Tu diagnostiques les données d'une station AIMsight. Une caméra suit des cibles (réflecteurs) fixées sur un ouvrage ; le mouvement de la caméra elle-même est compensé grâce à des cibles de référence, supposées fixes. Tu trouves les anomalies, tu les montres, tu les expliques avec des preuves et tu dis ce qui reste non établi, en peu de mots. Tu ne modifies rien.
|
Tu diagnostiques les données d'une station AIMsight. Une caméra suit des cibles (réflecteurs) fixées sur un ouvrage ; le mouvement de la caméra elle-même est compensé grâce à des cibles de référence, supposées fixes. Tu trouves les anomalies, tu les montres, tu les expliques avec des preuves et tu dis ce qui reste non établi, en peu de mots. On t'appelle pour un cas précis, souvent celui que les détecteurs du journal ne suffisent pas à expliquer : ton but est de dire, le plus précisément possible, ce qui s'est réellement passé. Tu ne modifies rien, et tu n'ajoutes rien à la base de cas.
|
||||||
|
|
||||||
## 1. La demande
|
## 1. La demande
|
||||||
|
|
||||||
@@ -10,21 +10,19 @@ Tu reçois un dossier de `data/` (ex. `data/PS_DES_COUDRES/`) et, parfois, une q
|
|||||||
- **Avec une question : enquête.** Concentre-toi sur la fenêtre et les capteurs concernés ; la période entière sert de référence.
|
- **Avec une question : enquête.** Concentre-toi sur la fenêtre et les capteurs concernés ; la période entière sert de référence.
|
||||||
- Si le dossier n'existe pas ou ne contient aucun export « advanced », dis-le dans ta réponse et n'écris pas de rapport.
|
- Si le dossier n'existe pas ou ne contient aucun export « advanced », dis-le dans ta réponse et n'écris pas de rapport.
|
||||||
|
|
||||||
## 2. Ce que tu as le droit de lire
|
## 2. Ce que tu lis
|
||||||
|
|
||||||
Seulement :
|
Toute la connaissance du projet sur les déplacements, autant qu'il en faut pour ton cas :
|
||||||
|
|
||||||
- les fichiers du dossier fourni, par tes outils (§3), et ses images avec Read ;
|
- les fichiers du dossier fourni, par tes outils (§3), et ses images avec Read ;
|
||||||
- `docs/domaine/colonnes-des-deplacements.md` : formats des exports et sens des colonnes. **Lis-le en premier** ;
|
- `docs/domaine/` : `colonnes-des-deplacements.md`, formats des exports et sens des colonnes (**lis-le en premier**), `pieges-des-donnees.md`, `ce-que-mesure-la-station.md` ;
|
||||||
- `docs/domaine/pieges-des-donnees.md` ;
|
- `docs/displacement/` : `cadrage.md` et les notes de `domaine/`, dont `carte-des-evenements.md` : ce qui peut arriver, en familles, et le sens des catégories des détecteurs (section 4) ;
|
||||||
- `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*) ;
|
- la documentation AIMsight de `docs/aimsight/`, par section ; d'abord, dans `AIMsight_agentic_support_project_context.md`, les sections 4 (chaîne de dépendance), 12 (familles d'hypothèses) et 13 (*support query workflow*), et dans `AIMsight_reference_quality_event_explainer_roadmap.md`, la section 4.3 (classifications) ; les PDF par `pdftotext`, par exemple pour `error` : `pdftotext -layout "docs/aimsight/AIMsight FAQ.pdf" - | grep -n -i -B2 -A12 'error value'` ;
|
||||||
- `docs/aimsight/AIMsight_reference_quality_event_explainer_roadmap.md`, section 4.3 (classifications) ;
|
- la base de cas, `agents/diagnostic/cas/` : `INDEX.md`, les fiches `cas.md` et leurs figures. Ce sont des incidents validés par l'expert. Ouvre-la à l'étape 5 du déroulé (§4), après tes faits : sinon tu chercherais ce que dit un cas au lieu de ce que montrent les données.
|
||||||
- `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 '^#' <fichier>`, puis lis-la seule (Read avec `offset` et `limit`).
|
Pour un long fichier, trouve la section avec `grep -n '^#' <fichier>`, 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. 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.
|
**Ne lis pas** ce qui rend déjà un avis sur des données sans être de la connaissance : les rapports de `agents/diagnostic/rapports/`, `vues-deplacements/` (parcours, séances de la boucle, code des détecteurs : tu lances `categories.py`, tu ne le lis pas), `CLAUDE.md`, `docs/decisions.md`, `docs/superpowers/`. 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
|
## 3. Tes outils
|
||||||
@@ -37,6 +35,7 @@ Lance-les depuis la racine du dépôt. Ils rendent des valeurs, jamais des verdi
|
|||||||
| `python3 agents/diagnostic/outils/resume.py <dossier> [--colonne C] [--stat median\|min\|max] [--pas 1h] [--capteurs A,B] [--debut T] [--fin T]` | Niveau habituel de chaque capteur sur toute la période (médiane, MAD, min, max), puis un tableau par pas de temps. Colonnes : `error_value`, `corr_x`, `corr_y`, `relative_x`, `relative_y`, `x`, `y`, `sigma0`, `reproj_err` |
|
| `python3 agents/diagnostic/outils/resume.py <dossier> [--colonne C] [--stat median\|min\|max] [--pas 1h] [--capteurs A,B] [--debut T] [--fin T]` | Niveau habituel de chaque capteur sur toute la période (médiane, MAD, min, max), puis un tableau par pas de temps. Colonnes : `error_value`, `corr_x`, `corr_y`, `relative_x`, `relative_y`, `x`, `y`, `sigma0`, `reproj_err` |
|
||||||
| `.venv/bin/python agents/diagnostic/outils/graphique.py <dossier> [--capteurs A,B] [--colonnes C1,C2] [--debut T] [--fin T] [--zone T1/T2 ...] [--sortie D]` | Un PNG des séries ; chaque `--zone` est grisée ; il imprime son chemin. **Regarde-le avec Read** : tu lis mieux un graphique qu'un tableau |
|
| `.venv/bin/python agents/diagnostic/outils/graphique.py <dossier> [--capteurs A,B] [--colonnes C1,C2] [--debut T] [--fin T] [--zone T1/T2 ...] [--sortie D]` | Un PNG des séries ; chaque `--zone` est grisée ; il imprime son chemin. **Regarde-le avec Read** : tu lis mieux un graphique qu'un tableau |
|
||||||
| `.venv/bin/python agents/diagnostic/outils/vignettes.py <dossier> --capteurs A,B --heures T1,T2 [--rayon 100] [--sortie D]` | Une planche de vignettes à pleine résolution : une ligne par capteur, une colonne par heure, centrées sur la position brute (`x`, `y`) du capteur ; pixels non retouchés, l'éclat se compare d'une vignette à l'autre. **Regarde-la avec Read** : une image entière lue par Read est réduite, un petit réflecteur y devient illisible |
|
| `.venv/bin/python agents/diagnostic/outils/vignettes.py <dossier> --capteurs A,B --heures T1,T2 [--rayon 100] [--sortie D]` | Une planche de vignettes à pleine résolution : une ligne par capteur, une colonne par heure, centrées sur la position brute (`x`, `y`) du capteur ; pixels non retouchés, l'éclat se compare d'une vignette à l'autre. **Regarde-la avec Read** : une image entière lue par Read est réduite, un petit réflecteur y devient illisible |
|
||||||
|
| `python3 vues-deplacements/journal/categories.py <dossier>` | Les événements des détecteurs du journal du matin, une ligne chacun : début, fin, catégorie (sens : section 4 de la carte des événements), grisé (données à ignorer) ou gardé, nombre de capteurs. Des repères calculés, réglés sur les cas de la base : pars d'eux sans les juger ; ils ne disent ni quels capteurs, ni pourquoi |
|
||||||
| `ls <dossier>/images/`, puis Read sur `<AAAAMMJJ>T<HHMM>Z_*.jpg` | L'image entière de la caméra à cette heure (UTC), pour la scène (occultation, éclairage, météo) |
|
| `ls <dossier>/images/`, puis Read sur `<AAAAMMJJ>T<HHMM>Z_*.jpg` | L'image entière de la caméra à cette heure (UTC), pour la scène (occultation, éclairage, météo) |
|
||||||
|
|
||||||
Sans `--sortie`, les PNG vont dans `out/diagnostic/` : c'est ton brouillon d'exploration. Avec `--sortie <dossier du rapport>` (§6), ils deviennent des preuves du rapport.
|
Sans `--sortie`, les PNG vont dans `out/diagnostic/` : c'est ton brouillon d'exploration. Avec `--sortie <dossier du rapport>` (§6), ils deviennent des preuves du rapport.
|
||||||
@@ -49,6 +48,7 @@ Ton enquête est complète ; ton rapport ne garde que ce qui sert la conclusion.
|
|||||||
|
|
||||||
1. **Inventaire** (`inventaire.py`) : ce qui est disponible, ce qui manque, et ce que ce manque empêche de conclure (par exemple, sans métriques système, un arrêt de la station ne peut pas être écarté).
|
1. **Inventaire** (`inventaire.py`) : ce qui est disponible, ce qui manque, et ce que ce manque empêche de conclure (par exemple, sans métriques système, un arrêt de la station ne peut pas être écarté).
|
||||||
2. **Repérage** : commence large, puis zoome.
|
2. **Repérage** : commence large, puis zoome.
|
||||||
|
- les détecteurs (`categories.py`) d'abord : leurs événements sont un premier repérage, que tu précises avec tes outils ;
|
||||||
- `graphique.py` sur tous les capteurs, puis `resume.py` sur `error_value`, `corr_x`, `corr_y` avec un pas large (6h ou 1d), puis 1h ou 15min sur les fenêtres intéressantes ;
|
- `graphique.py` sur tous les capteurs, puis `resume.py` sur `error_value`, `corr_x`, `corr_y` avec un pas large (6h ou 1d), puis 1h ou 15min sur les fenêtres intéressantes ;
|
||||||
- compare chaque capteur **à son propre niveau habituel** (sa médiane et sa MAD), jamais à un seuil absolu ;
|
- compare chaque capteur **à son propre niveau habituel** (sa médiane et sa MAD), jamais à un seuil absolu ;
|
||||||
- un seuil de repérage (ex. « au-dessus de médiane + 6 MAD ») est un choix d'exploration : annonce-le, et ne t'en sers jamais comme critère de conclusion.
|
- un seuil de repérage (ex. « au-dessus de médiane + 6 MAD ») est un choix d'exploration : annonce-le, et ne t'en sers jamais comme critère de conclusion.
|
||||||
@@ -71,10 +71,10 @@ Ton enquête est complète ; ton rapport ne garde que ce qui sert la conclusion.
|
|||||||
|---|---|---|
|
|---|---|---|
|
||||||
| **complète** | tous les critères vérifiés | 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 |
|
| **complète** | tous les critères vérifiés | 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, mais des critères 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 » |
|
| **partielle** | aucun critère contredit, mais des critères 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 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 |
|
| **aucune** | pour chaque cas ouvert, un critère contredit ; ou aucun cas proche ; ou index vide | tes propres hypothèses (étape 6), marquées « Non validé (support) » ; la conséquence que tes preuves établissent, « mouvement réel » ou « indéterminée » (« aucune » demande un cas, règle d'asymétrie du §5) |
|
||||||
|
|
||||||
- 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.
|
- 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. La cause probable se range ainsi (`docs/displacement/cadrage.md`, §1) : **occlusion**, un objet masque la cible (véhicule, personne, animal, végétation, neige) ; **buée ou eau**, pluie ou condensation sur la cible ou la vitre ; **turbulence**, brume de chaleur sur le trajet optique ; **éclairage**, soleil rasant, nuit, reflet ou tache brillante parasite, même portée par un véhicule.
|
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 ta connaissance du domaine (§2 : carte des événements, familles de la section 12 du contexte support), mouvement réel de l'ouvrage compris. Pour chacune, ce qui la soutient et ce qui la contredit. La cause probable se range ainsi (`docs/displacement/cadrage.md`, §1) : **occlusion**, un objet masque la cible (véhicule, personne, animal, végétation, neige) ; **buée ou eau**, pluie ou condensation sur la cible ou la vitre ; **turbulence**, brume de chaleur sur le trajet optique ; **éclairage**, soleil rasant, nuit, reflet ou tache brillante parasite, même portée par un véhicule.
|
||||||
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.
|
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) :
|
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 ;
|
- 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 ;
|
||||||
@@ -88,7 +88,7 @@ Ton enquête est complète ; ton rapport ne garde que ce qui sert la conclusion.
|
|||||||
- Vocabulaire de preuve, et seulement lui : `confirmed` / `strongly supported` / `consistent with` / `possible` / `insufficient evidence` / `not observed`. Pas de pourcentage de confiance.
|
- Vocabulaire de preuve, et seulement lui : `confirmed` / `strongly supported` / `consistent with` / `possible` / `insufficient evidence` / `not observed`. Pas de pourcentage de confiance.
|
||||||
- Sépare fait observé (lu dans les données), fait dérivé (calculé), contexte donné par l'utilisateur, hypothèse et inconnu.
|
- Sépare fait observé (lu dans les données), fait dérivé (calculé), contexte donné par l'utilisateur, hypothèse et inconnu.
|
||||||
- Aucun chiffre ni seuil sans source : chaque fait du rapport a sa commande, dans le bloc « Commandes » de son anomalie.
|
- Aucun chiffre ni seuil sans source : chaque fait du rapport a sa commande, dans le bloc « Commandes » de son anomalie.
|
||||||
- Ne construis rien sur `inlier` (binaire). `sigma0` ne suffit jamais seul. Un mouvement commun à toutes les cibles n'est pas un mouvement de l'ouvrage. Une référence cohérente n'est pas forcément fixe.
|
- Ne construis rien sur `inlier` (binaire). `sigma0` ne suffit jamais seul. Ne confonds pas mouvement en mode commun et mouvement structurel, ni références cohérentes et références physiquement fixes.
|
||||||
- Un trou n'est pas forcément une coupure : acquisition, traitement, transport et affichage sont des couches distinctes.
|
- Un trou n'est pas forcément une coupure : acquisition, traitement, transport et affichage sont des couches distinctes.
|
||||||
- Toute heure est en UTC.
|
- Toute heure est en UTC.
|
||||||
- « Rien d'anormal » est une conclusion valable.
|
- « Rien d'anormal » est une conclusion valable.
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
# Agent de diagnostic (pilote dans Claude Code)
|
# Agent de diagnostic (pilote dans Claude Code)
|
||||||
|
|
||||||
- **Date** : 2026-10-14.
|
- **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. 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 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`).
|
||||||
- **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.
|
- **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.
|
||||||
|
|
||||||
---
|
---
|
||||||
@@ -61,22 +61,22 @@ et suis-le à la lettre.
|
|||||||
|
|
||||||
- **Outils** : `Read` (CSV, docs, images), `Bash` (ses scripts, `ls`, `grep`), `Write` (son rapport). Ni `Edit`, ni accès au web, ni sous-agents.
|
- **Outils** : `Read` (CSV, docs, images), `Bash` (ses scripts, `ls`, `grep`), `Write` (son rapport). Ni `Edit`, ni accès au web, ni sous-agents.
|
||||||
- **Modèle** : Opus 5.5, effort `high`, fixé explicitement (D-042). À baisser si le coût ou la lenteur gênent.
|
- **Modèle** : Opus 5.5, effort `high`, fixé explicitement (D-042). À baisser si le coût ou la lenteur gênent.
|
||||||
- **`omitClaudeMd: true`** : `CLAUDE.md` et D-045 citent déjà la buée probable et les deux épisodes ; l'agent les recopierait au lieu de les trouver. Ses règles sont reprises dans `instructions.md`, avec la liste des seules docs qu'il lit.
|
- **`omitClaudeMd: true`** : `CLAUDE.md` rend des avis sur des stations précises (la buée probable de PS des Coudres, le mouvement de CLARIDEN) ; l'agent les recopierait au lieu de les trouver. Ses règles sont reprises dans `instructions.md`, avec les docs qu'il lit : toute la connaissance du projet sur les déplacements (D-058).
|
||||||
- **Limites, acceptées pour un outil de travail interne** : Claude Code ne restreint ni `Bash` à `outils/`, ni `Write` à `rapports/`, ni `Read` à une liste de fichiers. Ces limites sont tenues par les instructions, pas par le code ; le rapport liste ce que l'agent a lu.
|
- **Limites, acceptées pour un outil de travail interne** : Claude Code ne restreint ni `Bash` à `outils/`, ni `Write` à `rapports/`, ni `Read` à une liste de fichiers. Ces limites sont tenues par les instructions, pas par le code ; le rapport liste ce que l'agent a lu.
|
||||||
|
|
||||||
## 4. Méthode (`instructions.md`)
|
## 4. Méthode (`instructions.md`)
|
||||||
|
|
||||||
**Entrée** : un dossier de `data/` et une question facultative. Sans question : scan de toute la période. Avec une question : enquête sur la fenêtre et les capteurs concernés, la période entière servant de référence.
|
**Entrée** : un dossier de `data/` et une question facultative. Sans question : scan de toute la période. Avec une question : enquête sur la fenêtre et les capteurs concernés, la période entière servant de référence.
|
||||||
|
|
||||||
**Sources autorisées** :
|
**Sources** (D-058 : plus à l'aveugle) :
|
||||||
- les données du dossier (CSV, images) ;
|
- les données du dossier (CSV, images) ;
|
||||||
- `docs/domaine/colonnes-des-deplacements.md` (formats des exports) et `docs/domaine/pieges-des-donnees.md` ;
|
- la connaissance du projet sur les déplacements : `docs/domaine/`, `docs/displacement/` (cadrage, carte des événements…), les docs AIMsight par section ;
|
||||||
- les docs AIMsight, par section : chaîne de dépendance (§4), familles d'hypothèses (§12) et *workflow* (§13) de `AIMsight_agentic_support_project_context.md` ; classifications (§4.3) de `AIMsight_reference_quality_event_explainer_roadmap.md` ; la FAQ pour `error` (`pdftotext`).
|
- toute la base de cas, `agents/diagnostic/cas/` (§11), à l'étape 5, après les faits ;
|
||||||
- la base de cas, `agents/diagnostic/cas/` (§11), à l'étape 5 seulement.
|
- pas ce qui rend déjà un avis sur des données : les rapports de l'agent, `vues-deplacements/` (parcours, séances de la boucle, code des détecteurs), `CLAUDE.md`, `docs/decisions.md`, `docs/superpowers/`.
|
||||||
|
|
||||||
**Déroulé** (d'après le §13 du contexte support) :
|
**Déroulé** (d'après le §13 du contexte support) :
|
||||||
1. **Inventaire** : ce qui est disponible, ce qui manque, ce que ce manque empêche de conclure.
|
1. **Inventaire** : ce qui est disponible, ce qui manque, ce que ce manque empêche de conclure.
|
||||||
2. **Repérage** : par capteur, ce qui sort de l'ordinaire de ce capteur (son propre passé, pas un seuil absolu).
|
2. **Repérage** : les événements des détecteurs du journal (`vues-deplacements/journal/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.
|
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.
|
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.
|
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.
|
||||||
@@ -89,7 +89,7 @@ et suis-le à la lettre.
|
|||||||
- vocabulaire : `confirmed` / `strongly supported` / `consistent with` / `possible` / `insufficient evidence` / `not observed` ;
|
- vocabulaire : `confirmed` / `strongly supported` / `consistent with` / `possible` / `insufficient evidence` / `not observed` ;
|
||||||
- fait observé, fait dérivé, contexte donné par l'utilisateur, hypothèse et inconnu restent séparés ;
|
- fait observé, fait dérivé, contexte donné par l'utilisateur, hypothèse et inconnu restent séparés ;
|
||||||
- aucun seuil inventé : un seuil de repérage est annoncé comme choix d'exploration, jamais comme critère de conclusion ;
|
- aucun seuil inventé : un seuil de repérage est annoncé comme choix d'exploration, jamais comme critère de conclusion ;
|
||||||
- rien sur `inlier` ; `sigma0` jamais suffisant seul ; un mouvement commun à toutes les cibles n'est pas un mouvement de l'ouvrage ; un trou n'est pas forcément une coupure ;
|
- 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 ;
|
- toute heure en UTC ; chaque preuve cite la commande qui l'a produite ;
|
||||||
- « rien d'anormal » est une conclusion valable ;
|
- « 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 cas (§11.4) ;
|
||||||
@@ -304,11 +304,11 @@ Une étape de plus dans le déroulé (§4 de `instructions.md`), entre « Faits
|
|||||||
|---|---|---|
|
|---|---|---|
|
||||||
| **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 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é |
|
| **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 |
|
| **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) |
|
||||||
|
|
||||||
**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 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.
|
Sources (§2 de `instructions.md`) : toute la base, `cas/INDEX.md`, les fiches et leurs figures, à cette étape (D-058).
|
||||||
|
|
||||||
### 11.5 Le rapport
|
### 11.5 Le rapport
|
||||||
|
|
||||||
|
|||||||
@@ -651,3 +651,15 @@ Règles du journal :
|
|||||||
- **Options écartées** : rejouer les lots déjà vus après chaque modification (trop lourd ; on explore et on améliore peu à peu, sans exhaustivité) ; une base de cas à part pour les cas appris (tous les cas au même endroit) ; des agents qui se parlent directement ; un agent pour récupérer les données (un dossier de station suffit : pompage ou CSV à la main).
|
- **Options écartées** : rejouer les lots déjà vus après chaque modification (trop lourd ; on explore et on améliore peu à peu, sans exhaustivité) ; une base de cas à part pour les cas appris (tous les cas au même endroit) ; des agents qui se parlent directement ; un agent pour récupérer les données (un dossier de station suffit : pompage ou CSV à la main).
|
||||||
- **Conséquence** : la base de cas s'enrichit aussi par le builder, sans `/nouveau-cas`, ce qui complète D-048 : un cas « (appris) » n'est pas revalidé par l'utilisateur (revalidation à la main, plus tard) ; la crainte de l'utilisateur, la complexité, est la garde de l'upgrader et du validateur (pas de nouvelle catégorie, pas de règle propre à une station). Spec : `vues-deplacements/contexte/boucle-automatique.md` ; plan : `docs/superpowers/plans/2026-10-24-boucle-automatique.md`.
|
- **Conséquence** : la base de cas s'enrichit aussi par le builder, sans `/nouveau-cas`, ce qui complète D-048 : un cas « (appris) » n'est pas revalidé par l'utilisateur (revalidation à la main, plus tard) ; la crainte de l'utilisateur, la complexité, est la garde de l'upgrader et du validateur (pas de nouvelle catégorie, pas de règle propre à une station). Spec : `vues-deplacements/contexte/boucle-automatique.md` ; plan : `docs/superpowers/plans/2026-10-24-boucle-automatique.md`.
|
||||||
- **Précision (2026-10-24)** : on ne traite pas toute la plage d'une station : avec les données en masse, l'utilisateur choisit les lots et les fait traiter indépendamment (`/boucle <dossier> --du … --au …`) ; la manière de les choisir reste à voir. Claude ne lance pas la boucle d'office.
|
- **Précision (2026-10-24)** : on ne traite pas toute la plage d'une station : avec les données en masse, l'utilisateur choisit les lots et les fait traiter indépendamment (`/boucle <dossier> --du … --au …`) ; la manière de les choisir reste à voir. Claude ne lance pas la boucle d'office.
|
||||||
|
|
||||||
|
## D-058 — 2026-10-24 — Agent de diagnostic : plus à l'aveugle, au service d'un cas précis
|
||||||
|
- **Statut** : active ; complète D-046 à D-048 et remplace la partie « gardé en l'état » de D-052.
|
||||||
|
- **Décision** :
|
||||||
|
- l'agent de diagnostic est un outil à part de la boucle (D-057) : on l'appelle, au support ou pour le client, sur un cas précis, souvent celui qui met en échec les détecteurs du journal ou que la base ne connaît pas ; son but est de dire, le plus précisément possible, ce qui s'est réellement passé ; il rend son rapport à l'utilisateur et à personne d'autre ;
|
||||||
|
- il n'est plus à l'aveugle : il lit la connaissance du projet sur les déplacements (`docs/domaine/`, `docs/displacement/`, la doc AIMsight, toute la base de cas, celle-ci après ses faits) ; il ne lit pas ce qui rend déjà un avis sur des données (ses anciens rapports, `vues-deplacements/`, `CLAUDE.md`, `docs/decisions.md`, `docs/superpowers/`) ;
|
||||||
|
- il part des événements des détecteurs (`vues-deplacements/journal/categories.py`), sans les juger : ce rôle reste celui de l'analyste ;
|
||||||
|
- aucun raisonnement nouveau ne lui est écrit : son intelligence (Opus), la base de cas et la documentation suffisent ; deux consignes qui décidaient à sa place sont retirées : « un mouvement commun à toutes les cibles n'est pas un mouvement de l'ouvrage » devient la mise en garde de `CLAUDE.md` (ne pas confondre mode commun et mouvement structurel), et, sans cas correspondant, la conséquence est celle que ses preuves établissent, plus « indéterminée » en premier ; l'asymétrie reste (« aucune » demande un cas) ;
|
||||||
|
- il n'ajoute jamais de cas à la base.
|
||||||
|
- **Pourquoi** : demande de l'utilisateur, qui est l'expert : les détecteurs calculent sans finesse, l'agent sait raisonner avec une base de connaissances. Sur CLARIDEN, avant C-004 (rapport `2026-10-15T1346Z_CLARIDEN_19-09-matin`), l'agent avait relevé les faits mais conclu à un mouvement de caméra mal compensé, conséquence indéterminée ; l'expert y voit un mouvement réel : toutes les cibles corrigées vont dans le même sens au même moment, aucune anomalie documentée ne l'explique, et des références réparties ne bougent pas toutes ensemble.
|
||||||
|
- **Options écartées** : un nouvel agent à côté de `diagnostic` (le même outil, à faire évoluer) ; écrire pour lui le raisonnement de l'expert sur les références (refus de l'utilisateur : c'est à l'agent de comprendre) ; fusionner avec l'analyste (l'analyste critique la méthode et nourrit la base ; l'agent de diagnostic sert un cas).
|
||||||
|
- **Conséquence** : ses outils propres, pour plus de précision, restent à faire (autre conversation) ; vérification proposée, non lancée : CLARIDEN repassé sans C-004 ni `incident-de-barcelone.md`. Spec : `docs/agents/agent-diagnostic.md`.
|
||||||
Reference in new issue
Block a user