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:
1 parent
94670c2c92
commit
dcda007681
3 files changed
+29
-13
No files matched your search
@@ -1,7 +1,7 @@
|
||||
# Agent de diagnostic (pilote dans Claude Code)
|
||||
|
||||
- **Date** : 2026-10-14.
|
||||
- **Statut** : design validé par l'utilisateur, à construire. Décision liée : D-046 (`docs/decisions.md`).
|
||||
- **Statut** : construit le 2026-10-14 (outils, instructions, point d'entrée) ; test à l'aveugle : §7. Décision liée : D-046 (`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.
|
||||
|
||||
---
|
||||
@@ -49,7 +49,7 @@ name: diagnostic
|
||||
description: Diagnostic des données d'une station AIMsight (déplacements optiques, images).
|
||||
À appeler avec un dossier de data/ et, si on veut, une question. Rend un rapport
|
||||
traçable dans agents/diagnostic/rapports/.
|
||||
tools: Read, Glob, Grep, Bash, Write
|
||||
tools: Read, Bash, Write
|
||||
model: opus
|
||||
effort: high
|
||||
omitClaudeMd: true
|
||||
@@ -58,7 +58,7 @@ Tu es l'agent de diagnostic du projet. Commence par lire agents/diagnostic/instr
|
||||
et suis-le à la lettre.
|
||||
```
|
||||
|
||||
- **Outils** : `Read` (CSV, docs, images), `Glob`, `Grep`, `Bash` (ses scripts), `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.
|
||||
- **`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.
|
||||
- **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.
|
||||
@@ -113,7 +113,7 @@ Scripts en ligne de commande. Ils renvoient des valeurs, jamais des verdicts. Bi
|
||||
| Script | Sortie |
|
||||
|---|---|
|
||||
| `inventaire.py <dossier>` | Fichiers par type (« advanced », horaire, images), période, cadence, capteurs (cible ou référence, seuil d'erreur), trous de mesure, points rejetés par capteur, heures couvertes par les images |
|
||||
| `resume.py <dossier> [--capteurs] [--debut] [--fin] [--pas 1h]` | Par capteur et par pas : médiane, minimum, maximum de `error_value`, `corr_x`, `corr_y` ; mesures valides et rejetées. Par capteur, son niveau habituel sur la période (médiane, dispersion) |
|
||||
| `resume.py <dossier> [--colonne C] [--stat median\|min\|max] [--pas 1h] [--capteurs] [--debut] [--fin]` | Pour une colonne : le niveau habituel de chaque capteur sur la période (médiane, MAD, min, max), puis un tableau, une ligne par pas de temps et une colonne par capteur, avec la statistique choisie ; « rej » quand toutes les mesures du pas sont rejetées |
|
||||
| `graphique.py <dossier> [--capteurs] [--colonnes] [--debut] [--fin]` | Un PNG des séries dans `out/diagnostic/`, que l'agent regarde (matplotlib, `.venv`) |
|
||||
|
||||
- Un module de lecture de l'export « advanced », partagé par les trois scripts.
|
||||
|
||||
+16
-1
@@ -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).
|
||||
Reference in new issue
Block a user