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
@@ -14,13 +14,13 @@ L'état courant seulement ; l'historique est dans `git log` et `docs/decisions.m
|
|||||||
- **Energy, comparaison seulement** : les deux moyennes glissantes sur 7 jours. Point ouvert : l'accoutumance après ~30 jours de déficit (fiche `moving_average_7_days_drop`).
|
- **Energy, comparaison seulement** : les deux moyennes glissantes sur 7 jours. Point ouvert : l'accoutumance après ~30 jours de déficit (fiche `moving_average_7_days_drop`).
|
||||||
- **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 pour une station (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 ; 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 pour une station (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 ; exploration confiée d'abord à l'agent de diagnostic (D-046), chaîne analytique au second plan.
|
||||||
- **Enquête à la demande (D-042)** : approche auxiliaire pour les données de mesure : un agent enquête sur un événement (outils typés, réfutation obligatoire, preuves tracées), support d'abord puis client ; document seulement, rien n'est construit.
|
- **Agent de diagnostic (D-046)** : 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 dans `agents/diagnostic/rapports/` ; déplacements et images seulement. 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, 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, réseau de l'hôte) ; prépare la communication avec la caméra, en attente de la doc de l'API REST.
|
||||||
- **Prochaine étape** : `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) ; séries optiques : décider avec l'utilisateur de l'exploration de PS des Coudres (étape 1 du cadrage).
|
- **Prochaine étape** : `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 : test à l'aveugle sur PS des Coudres (§7 de sa spec), puis validation du rapport par l'utilisateur.
|
||||||
|
|
||||||
## Analyses (domaine Energy)
|
## Analyses (domaine Energy)
|
||||||
|
|
||||||
@@ -89,7 +89,7 @@ python3 src/temperature/all_analyses.py [données] # limite du GPU : out/<
|
|||||||
python3 maquettes/user/summary.py [début] [fin] # maquette client : out/maquette_user_<STATION>.html, une page par station de data/
|
python3 maquettes/user/summary.py [début] [fin] # maquette client : out/maquette_user_<STATION>.html, une page par station de data/
|
||||||
python3 maquettes/support/home.py [début] [fin] # maquette support : out/maquette_support_home.html
|
python3 maquettes/support/home.py [début] [fin] # maquette support : out/maquette_support_home.html
|
||||||
pdftotext -layout "docs/aimsight/<fichier>.pdf" - # lire un PDF AIMsight
|
pdftotext -layout "docs/aimsight/<fichier>.pdf" - # lire un PDF AIMsight
|
||||||
python3 -m venv .venv && .venv/bin/pip install plotly # recréer .venv
|
python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .venv
|
||||||
```
|
```
|
||||||
|
|
||||||
- `[données]` : CSV ou dossiers, défaut `data/VERMONT/`. Dates des maquettes en `AAAA-MM-JJ`, défaut 2026-09-18 à 2026-09-28 ; la maquette support mène aux maquettes client : les lancer avec les mêmes dates (`2026-08-12 2026-08-22` montre des notifications Cellular).
|
- `[données]` : CSV ou dossiers, défaut `data/VERMONT/`. Dates des maquettes en `AAAA-MM-JJ`, défaut 2026-09-18 à 2026-09-28 ; la maquette support mène aux maquettes client : les lancer avec les mêmes dates (`2026-08-12 2026-08-22` montre des notifications Cellular).
|
||||||
@@ -108,7 +108,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly # recréer .venv
|
|||||||
### 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` (503 l, D-001 à D-045) : 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` (518 l, D-001 à D-046) : 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.
|
||||||
@@ -120,8 +120,9 @@ python3 -m venv .venv && .venv/bin/pip install plotly # recréer .venv
|
|||||||
- `matrice-etat-tendance.drawio` : matrice état × tendance, tenue par l'utilisateur.
|
- `matrice-etat-tendance.drawio` : matrice état × tendance, tenue par l'utilisateur.
|
||||||
- `docs/storage/`, `docs/cellular/` : domaines Storage (espace disque) et Cellular (signal 4G), D-030. Storage a sa matrice état × horizon, `matrice-etat-horizon.drawio`, Cellular sa matrice lien × signal, `matrice-lien-signal.drawio`, tenues par l'utilisateur. Chacun a une note de départ, `domaine/point-de-depart.md` (mesures du collecteur, données reçues, pièges, pistes), ses fiches dans `analyses/`, ses questions ouvertes dans `domaine/questions-pour-l-expert.md` et son guide (~90 l, client puis support) dans `guide/`, dont la partie 1 est affichée dans la vue client.
|
- `docs/storage/`, `docs/cellular/` : domaines Storage (espace disque) et Cellular (signal 4G), D-030. Storage a sa matrice état × horizon, `matrice-etat-horizon.drawio`, Cellular sa matrice lien × signal, `matrice-lien-signal.drawio`, tenues par l'utilisateur. Chacun a une note de départ, `domaine/point-de-depart.md` (mesures du collecteur, données reçues, pièges, pistes), ses fiches dans `analyses/`, ses questions ouvertes dans `domaine/questions-pour-l-expert.md` et son guide (~90 l, client puis support) dans `guide/`, dont la partie 1 est affichée dans la vue client.
|
||||||
- `docs/temperature/` : domaine Temperature (D-040), sans matrice ; guide dans `guide/` (D-041). `domaine/point-de-depart.md` : zones thermiques, carte supposée (Jetson Nano) et ses limites, constats sur trois stations, pistes, questions au spécialiste ; fiche dans `analyses/`.
|
- `docs/temperature/` : domaine Temperature (D-040), sans matrice ; guide dans `guide/` (D-041). `domaine/point-de-depart.md` : zones thermiques, carte supposée (Jetson Nano) et ses limites, constats sur trois stations, pistes, questions au spécialiste ; fiche dans `analyses/`.
|
||||||
- `docs/agents/rapport-exploratoire.md` (290 l) : cadre d'agents LLM (D-027) : choix retenus, architecture, démarrage par étapes (§6) ; annexe A : pistes à revoir étape par étape. Le code d'agent vivra à part (`agents/`, proposé, pas créé).
|
- `docs/agents/rapport-exploratoire.md` (290 l) : cadre d'agents LLM (D-027) : choix retenus, architecture, démarrage par étapes (§6) ; annexe A : pistes à revoir étape par étape. Le code d'agent vit à part, dans `agents/`.
|
||||||
- `docs/agents/enquete-a-la-demande.md` (233 l) : enquête à la demande sur un événement de mesure (D-042), même cadre ; harnais (§3), déroulé (§4), sortie et règle d'asymétrie (§5), étapes (§6), questions ouvertes (§9).
|
- `docs/agents/enquete-a-la-demande.md` (233 l) : enquête à la demande sur un événement de mesure (D-042), même cadre ; harnais (§3), déroulé (§4), sortie et règle d'asymétrie (§5), étapes (§6), questions ouvertes (§9).
|
||||||
|
- `docs/agents/agent-diagnostic.md` : spec de l'agent de diagnostic (D-046) ; code dans `agents/diagnostic/` (`instructions.md`, `outils/`, `rapports/`). Appel : `@agent-diagnostic data/<STATION>/ [question]`, ou `claude --agent diagnostic` dans un terminal.
|
||||||
- `docs/displacement/cadrage.md` (156 l) : séries optiques (D-044) : événements externes et correction des courbes ; règles de correction (§3), chaîne en trois étapes (§4), données nécessaires (§5), étapes (§6), questions ouvertes (§7).
|
- `docs/displacement/cadrage.md` (156 l) : séries optiques (D-044) : événements externes et correction des courbes ; règles de correction (§3), chaîne en trois étapes (§4), données nécessaires (§5), étapes (§6), questions ouvertes (§7).
|
||||||
- `docs/aimsight/` : documentation AIMsight d'origine, en anglais, non modifiée. À lire avant de concevoir, **par section** ; ne pas re-demander à l'utilisateur ce qui y figure.
|
- `docs/aimsight/` : documentation AIMsight d'origine, en anglais, non modifiée. À lire avant de concevoir, **par section** ; ne pas re-demander à l'utilisateur ce qui y figure.
|
||||||
- `AIMsight_reference_quality_event_explainer_roadmap.md` (1 180 l) : **référence qui fait autorité** : couche diagnostique commune, explainer d'événements, classifications (§4.3), API indépendante de l'estimateur (§10).
|
- `AIMsight_reference_quality_event_explainer_roadmap.md` (1 180 l) : **référence qui fait autorité** : couche diagnostique commune, explainer d'événements, classifications (§4.3), API indépendante de l'estimateur (§10).
|
||||||
@@ -143,7 +144,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly # recréer .venv
|
|||||||
- `storage/` : calcul embarquable `storage_state.py`, `days_until_full.py`, `day_color.py` (D-035) ; plotly : `final.py` (figure du site, D-039), `all_analyses.py` (D-034).
|
- `storage/` : calcul embarquable `storage_state.py`, `days_until_full.py`, `day_color.py` (D-035) ; plotly : `final.py` (figure du site, D-039), `all_analyses.py` (D-034).
|
||||||
- `temperature/` : calcul embarquable `gpu_temperature_limit.py`, `day_color.py` ; plotly : `final.py` (figure du site, D-041), `all_analyses.py` (D-040).
|
- `temperature/` : calcul embarquable `gpu_temperature_limit.py`, `day_color.py` ; plotly : `final.py` (figure du site, D-041), `all_analyses.py` (D-040).
|
||||||
- `maquettes/` : maquettes du site en HTML sur données réelles (D-022), Figma seulement sur demande. Un script remplit son gabarit HTML : `user/summary.py` + `summary_template.html` (client, une page par station, un bloc par domaine), `support/home.py` + `home_template.html` (support). Les deux parcourent une liste de domaines (`DOMAINS`, D-039).
|
- `maquettes/` : maquettes du site en HTML sur données réelles (D-022), Figma seulement sur demande. Un script remplit son gabarit HTML : `user/summary.py` + `summary_template.html` (client, une page par station, un bloc par domaine), `support/home.py` + `home_template.html` (support). Les deux parcourent une liste de domaines (`DOMAINS`, D-039).
|
||||||
- `.claude/` : `rules/analyses.md` (se charge seule, voir « Analyses »), `skills/nouvelle-analyse/` (procédure et modèle de fiche), `skills/nouveau-domaine/` (procédure pour un nouveau domaine), `settings.json` (lecture de `.env` interdite).
|
- `.claude/` : `rules/analyses.md` (se charge seule, voir « Analyses »), `agents/diagnostic.md` (point d'entrée de l'agent de diagnostic, D-046), `skills/nouvelle-analyse/` (procédure et modèle de fiche), `skills/nouveau-domaine/` (procédure pour un nouveau domaine), `settings.json` (lecture de `.env` interdite).
|
||||||
- `.devcontainer/devcontainer.json` : environnement de dev en conteneur (D-038), réseau de l'hôte pour joindre la caméra.
|
- `.devcontainer/devcontainer.json` : environnement de dev en conteneur (D-038), réseau de l'hôte pour joindre la caméra.
|
||||||
- `architecture.drawio` : schéma d'architecture tenu par l'utilisateur. Ne pas le modifier sans demande.
|
- `architecture.drawio` : schéma d'architecture tenu par l'utilisateur. Ne pas le modifier sans demande.
|
||||||
- `out/` : pages et JSON générés. Tout le projet est versionné, sauf `out/`, `.venv/` et `__pycache__/` (D-014).
|
- `out/` : pages et JSON générés. Tout le projet est versionné, sauf `out/`, `.venv/` et `__pycache__/` (D-014).
|
||||||
@@ -194,5 +195,5 @@ python3 -m venv .venv && .venv/bin/pip install plotly # recréer .venv
|
|||||||
## Environnement
|
## Environnement
|
||||||
|
|
||||||
- `pandas` n'est pas installé ; la bibliothèque standard suffit pour explorer les CSV (`csv`, `datetime.fromisoformat`).
|
- `pandas` n'est pas installé ; la bibliothèque standard suffit pour explorer les CSV (`csv`, `datetime.fromisoformat`).
|
||||||
- `.venv/` (Python 3.14) ne contient que plotly, pour le poste de dev. Le code d'analyse reste en bibliothèque standard.
|
- `.venv/` (Python 3.14) ne contient que plotly et matplotlib (graphiques de l'agent de diagnostic), pour le poste de dev. Le code d'analyse reste en bibliothèque standard.
|
||||||
- Dev container (D-038) : Docker Engine dans WSL (réseau `mirrored`), VS Code « Reopen in Container » ; dans le conteneur, les pages restent dans `out/` sans s'ouvrir seules.
|
- Dev container (D-038) : Docker Engine dans WSL (réseau `mirrored`), VS Code « Reopen in Container » ; dans le conteneur, les pages restent dans `out/` sans s'ouvrir seules.
|
||||||
@@ -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** : 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.
|
- **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).
|
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
|
À appeler avec un dossier de data/ et, si on veut, une question. Rend un rapport
|
||||||
traçable dans agents/diagnostic/rapports/.
|
traçable dans agents/diagnostic/rapports/.
|
||||||
tools: Read, Glob, Grep, Bash, Write
|
tools: Read, Bash, Write
|
||||||
model: opus
|
model: opus
|
||||||
effort: high
|
effort: high
|
||||||
omitClaudeMd: true
|
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.
|
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.
|
- **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` 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.
|
- **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 |
|
| 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 |
|
| `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`) |
|
| `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.
|
- 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.
|
- **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)
|
## 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** :
|
- **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 ;
|
- 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 ;
|
- 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** :
|
- **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 ;
|
- 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).
|
- 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