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:
maximeandClaude Opus 5.5 committed 2026-10-24 15:46:30 +02:00
1 parent 54d1c6a142
commit 4d14f5ea5d
5 files changed
+40 -28

No files matched your search

+10 -10
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. 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.
---
@@ -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.
- **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.
## 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.
**Sources autorisées** :
**Sources** (D-058 : plus à l'aveugle) :
- les données du dossier (CSV, images) ;
- `docs/domaine/colonnes-des-deplacements.md` (formats des exports) et `docs/domaine/pieges-des-donnees.md` ;
- 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`).
- la base de cas, `agents/diagnostic/cas/` (§11), à l'étape 5 seulement.
- 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, `agents/diagnostic/cas/` (§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, 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) :
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.
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.
@@ -89,7 +89,7 @@ et suis-le à la lettre.
- 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 ;
- 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 ;
- « 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) ;
@@ -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 |
| **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.
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
+12
View File
@@ -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).
- **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.
## 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`.