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