Record the diagnostic agent (D-046) in decisions, CLAUDE.md and its spec

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-14 15:15:04 +02:00
1 parent 94670c2c92
commit dcda007681
3 files changed
+29 -13

No files matched your search

+16 -1
View File
@@ -476,7 +476,7 @@ Règles du journal :
- **Conséquence** : `day_color.run()` fusionne les faits des trois analyses (`power`, `hours_lost` en plus) ; `focus_jour.py` cite la règle secteur quand elle a décidé ; limites dans la fiche `docs/energy/analyses/daily_power_source.md`, dont 3 jours sans statut après chaque coupure.
## D-044 — 2026-10-14 — Séries optiques : détecter les événements externes et corriger les courbes (cadrage)
- **Statut** : active, cadrage (`docs/displacement/cadrage.md`, rien n'est construit).
- **Statut** : active, cadrage (`docs/displacement/cadrage.md`, rien n'est construit) ; l'exploration passe d'abord par l'agent de diagnostic (D-046), la chaîne analytique au second plan.
- **Décision** :
- nouveau chantier, premier du cas d'usage « déplacements » : détecter dans les séries optiques les événements externes à l'ouvrage (occlusion passagère, eau ou neige, turbulence, éclairage), les expliquer, et produire une courbe corrigée ;
- couche déterministe, analytique et embarquable (D-003), domaine `displacement` (`src/displacement/`, `docs/displacement/`, D-026) ; chaîne en trois étapes : qualifier chaque observation (poids continu), détecter et classer les événements, corriger ;
@@ -501,3 +501,18 @@ Règles du journal :
- **Conséquence** :
- aucun événement annoté sur la plage : la buée est un contexte de l'utilisateur, pas une vérité de référence. Deux épisodes nocturnes de l'erreur de `REF_G` et `REF_D` (13/10 et 14/10) en sont des candidats, `consistent with` au plus. Les images couvrent le second (13/10 23:45 → 14/10 04:45 UTC), pas le premier ;
- le HDF5 et la raison du seuil d'erreur de PM_G (0,3) sont inconnus de l'utilisateur ; l'unité de `corr_x`/`corr_y` est à confirmer : questions 3, 9 et 10 du cadrage (§7).
## D-046 — 2026-10-14 — Agent de diagnostic : pilote de l'enquête à la demande dans Claude Code
- **Statut** : active. Version pilote de D-042 ; déroge à D-027 sur le harnais, pour ce pilote seulement ; met au second plan la chaîne analytique de D-044.
- **Décision** :
- un sous-agent Claude Code `diagnostic` (`.claude/agents/diagnostic.md`), avec son dossier `agents/diagnostic/` (instructions, outils, rapports), diagnostique à la demande un dossier de `data/` : scan sans question, enquête avec une question ; un rapport par diagnostic dans `agents/diagnostic/rapports/`, avec une section de validation pour l'utilisateur ;
- première version : déplacements (export « advanced ») et images ; métriques système plus tard ;
- outils en lecture qui rendent des valeurs, pas des verdicts : `inventaire.py`, `resume.py`, `graphique.py` (matplotlib, ajouté à `.venv` et au dev container) ;
- Opus 5.5, effort `high` ; `omitClaudeMd` : l'agent ne lit que les sources listées dans ses instructions, pour diagnostiquer sans connaître nos conclusions ;
- spec : `docs/agents/agent-diagnostic.md`.
- **Pourquoi** : demande de l'utilisateur : profiter de la souplesse d'un agent plutôt que d'écrire des méthodes analytiques complexes, et pouvoir l'appeler à tout moment. Claude Code ne demande ni clé API ni harnais, prérequis bloquants de D-027 et D-042.
- **Options écartées** : un skill dans la conversation courante (il hériterait des hypothèses de la conversation) ; un skill seul avec `context: fork` (caché sous `.claude/`) ; les graphiques par plotly (kaleido embarque un navigateur) ; pas de graphique (l'agent verrait mal les formes des séries).
- **Conséquence** :
- D-027 avait écarté un harnais de codage pour l'agent serveur, à cause d'un Bash large et peu auditable ; ce refus vaut toujours pour un agent qui notifie des clients. Ici, outil de travail interne : Claude Code ne restreint ni `Read`, ni `Bash`, ni `Write` à des chemins ; les instructions le font, et le rapport liste ses sources ;
- pas de LLM dans `src/` : la couche déterministe ne change pas ;
- vérification par un test à l'aveugle sur PS des Coudres, attendus écrits avant le premier passage (§7 de la spec).