> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
**Goal :** un sous-agent Claude Code `diagnostic`, appelable à tout moment, qui diagnostique un dossier de `data/` (déplacements optiques et images) et écrit un rapport traçable.
**Architecture :** un point d'entrée `.claude/agents/diagnostic.md` (outils, modèle, `omitClaudeMd`) qui renvoie à `agents/diagnostic/instructions.md` (méthode, règles, format du rapport). Trois scripts en ligne de commande dans `agents/diagnostic/outils/` rendent des valeurs (inventaire, résumé chiffré, graphique PNG) ; l'agent juge et écrit son rapport dans `agents/diagnostic/rapports/`.
**Tech Stack :** Python 3.14, bibliothèque standard ; matplotlib dans `.venv` pour le seul graphique ; Claude Code (sous-agent, Opus 5.5).
**Spec :**`docs/agents/agent-diagnostic.md`
## Global Constraints
- Python 3.14 ; `donnees.py`, `inventaire.py`, `resume.py` en bibliothèque standard seulement ; `graphique.py` importe matplotlib et se lance avec `.venv/bin/python`.
- Toute heure est en UTC ; une heure saisie sans fuseau est lue en UTC.
- Les outils rendent des valeurs, jamais des verdicts : aucun seuil de décision dans les outils.
- Lecture seule : les outils n'écrivent que dans `out/diagnostic/` ; l'agent n'écrit que dans `agents/diagnostic/rapports/`.
- Pas de tests automatisés (D-008) : chaque tâche se vérifie par des commandes et leurs sorties attendues, sur `data/PS_DES_COUDRES/`.
- Documents en français, termes AIMsight en anglais.
-`CLAUDE.md` reste sous 200 lignes (D-012).
- Commits : message en anglais, terminé par `Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>`.
## Review Focus
1.**Dossier sans export « advanced »** (ex. `data/WEISSHORN/`, métriques système seulement) : `inventaire.py` le dit ; `resume.py` et `graphique.py` s'arrêtent avec un message clair, sans trace d'erreur Python. Vérifié aux tâches 1, 2 et 3.
2.**Fenêtre sans mesure** (`--debut` après la fin des données) : message clair, pas de tableau vide ni de graphique vide. Tâches 2 et 3.
3.**Capteur ou colonne inconnu** : message qui liste les noms connus. Tâches 2 et 3.
4.**Heure sans fuseau** (`--debut "2026-10-14 02:00"`) : même résultat qu'avec `2026-10-14T02:00Z`. Tâche 2.
5.**Capteur rejeté sur toute la période** (PM_G, `corr_x` vide) : « rej » dans le tableau et « aucune valeur » au niveau habituel, pas de plantage. Tâche 2.
---
## Structure des fichiers
| Fichier | Rôle |
|---|---|
| `agents/diagnostic/outils/donnees.py` | Lecture : trouver les fichiers d'un dossier par type, charger l'export « advanced », heures d'image, conversion des instants (UTC) |
| `agents/diagnostic/outils/inventaire.py` | Ce qui est disponible et ce qui manque |
| `agents/diagnostic/outils/resume.py` | Niveau habituel par capteur et tableau par pas de temps |
| `agents/diagnostic/outils/graphique.py` | PNG des séries dans `out/diagnostic/` |
| `agents/diagnostic/instructions.md` | Méthode, règles, format du rapport (le « cerveau » de l'agent) |
| `agents/diagnostic/rapports/` | Un rapport par diagnostic (créé par l'agent) |
| `.claude/agents/diagnostic.md` | Point d'entrée Claude Code |
| `.devcontainer/devcontainer.json` | Ajout de matplotlib |
| `docs/decisions.md`, `CLAUDE.md`, `docs/agents/agent-diagnostic.md` | D-046, carte et état, statut et résultats de la spec |
Les scripts s'importent entre eux par `from donnees import …` : Python ajoute le dossier du script lancé à `sys.path`, il n'y a donc rien à configurer.
Run : `python3 agents/diagnostic/outils/inventaire.py data/PS_DES_COUDRES/`
Expected (chiffres établis à la main le 2026-10-14, spec §7) :
```
Exports « advanced » (source des mesures) : 1
Exports horaires : 1 (...)
Autres fichiers : 0
Images : 24, du 2026-10-13T12:00Z au 2026-10-14T11:00Z
heures pleines sans image entre la première et la dernière : aucune
Période des mesures : 2026-10-08T22:00Z → 2026-10-14T09:45Z, 525 instants
Cadence (pas médian) : 15 min
Mesures manquantes (instants absents de la cadence) : 3
entre 2026-10-09T11:45Z et 2026-10-09T12:15Z : 1
entre 2026-10-10T10:30Z et 2026-10-10T11:00Z : 1
entre 2026-10-14T09:15Z et 2026-10-14T09:45Z : 1
Capteurs : 15 (3 références, 12 cibles)
```
puis `REF_CT` seuil 0.45, `REF_D` et `REF_G` 0.7, rejetées 0 ; `PM_G` seuil 0.3, mesures 525, rejetées 525 ; toutes les autres cibles seuil 0.7, rejetées 0.
- [ ]**Step 4 : vérifier un dossier sans export « advanced » (Review Focus 1)**
Run : `python3 agents/diagnostic/outils/inventaire.py data/WEISSHORN/`
Expected : `Exports « advanced » (source des mesures) : 0`, `Autres fichiers : 27` suivis des 27 CSV, `Images : 0`, puis `Aucune mesure : pas d'export « advanced » dans ce dossier.` Pas de trace d'erreur.
Run : `python3 agents/diagnostic/outils/inventaire.py` (sans argument). Expected : le docstring d'usage, code de sortie 1.
- [ ]**Step 2 : vérifier le pic de la seconde nuit**
Run : `python3 agents/diagnostic/outils/resume.py data/PS_DES_COUDRES/ --stat max --capteurs REF_CT,REF_G,REF_D --debut 2026-10-13T22:00Z --fin 2026-10-14T06:00Z`
Expected :
- niveau habituel : `REF_G` médiane ≈ 0.084, max ≈ 0.674 ; `REF_D` médiane ≈ 0.132, max ≈ 0.692 ; `REF_CT` médiane ≈ 0.151, max ≈ 0.226 ;
- tableau de `2026-10-13T22:00Z` à `2026-10-14T05:00Z` (8 lignes) ; à la ligne `2026-10-14T02:00Z`, `REF_G` ≈ 0.670 et `REF_D` ≈ 0.690 ; `REF_CT` reste sous 0.23 sur toutes les lignes.
- [ ]**Step 3 : vérifier les cas limites (Review Focus 2 à 5)**
Expected : `PM_G` « 0 (aucune valeur) » au niveau habituel, « rej » sur chaque ligne ; `BJ_C` des valeurs (médiane ≈ 0.258).
Run : `python3 agents/diagnostic/outils/resume.py data/PS_DES_COUDRES/ --capteurs REF_G --debut "2026-10-14 02:00" --fin "2026-10-14 02:59"` puis la même commande avec `--debut 2026-10-14T02:00Z --fin 2026-10-14T02:59Z`.
Expected : sorties identiques (une ligne `2026-10-14T02:00Z`).
Run : `python3 agents/diagnostic/outils/resume.py data/PS_DES_COUDRES/ --debut 2027-01-01T00:00Z`
Expected : `Aucune mesure dans la fenêtre demandée.`, code 1.
Run : `python3 agents/diagnostic/outils/resume.py data/PS_DES_COUDRES/ --capteurs REF_X`
- Produces : CLI `.venv/bin/python agents/diagnostic/outils/graphique.py <dossier> [--capteurs A,B] [--colonnes C1,C2] [--debut T] [--fin T]`, qui imprime le chemin du PNG écrit dans `out/diagnostic/`.
- [ ]**Step 1 : installer matplotlib dans `.venv` et le dev container**
Run : `.venv/bin/python agents/diagnostic/outils/graphique.py data/PS_DES_COUDRES/ --capteurs REF_CT,REF_G,REF_D --colonnes error_value`
Expected : imprime `/home/maxime/Support-Agent/out/diagnostic/PS_DES_COUDRES_error_value_REF_CT-REF_G-REF_D_debut_fin.png`. Ouvrir le PNG avec Read : trois courbes, deux bosses nocturnes de `REF_G` et `REF_D` (13/10 et 14/10), `REF_CT` plate, axe des temps lisible en UTC.
Run : `.venv/bin/python agents/diagnostic/outils/graphique.py data/PS_DES_COUDRES/`
Expected : PNG des 15 capteurs sur trois panneaux (`error_value`, `corr_x`, `corr_y`), légende à droite ; PM_G absente des panneaux `corr_*`.
- [ ]**Step 4 : vérifier les cas limites (Review Focus 1 à 3)**
Tu diagnostiques les données d'une station AIMsight. Une caméra suit des cibles (réflecteurs) fixées sur un ouvrage ; le mouvement de la caméra elle-même est compensé grâce à des cibles de référence, supposées fixes. Tu trouves ce qui sort de l'ordinaire, tu l'expliques avec des preuves, et tu dis ce qui reste non établi. Tu ne modifies rien.
## 1. La demande
Tu reçois un dossier de `data/` (ex. `data/PS_DES_COUDRES/`) et, parfois, une question.
- **Sans question : scan.** Trouve les événements de toute la période et explique chacun.
- **Avec une question : enquête.** Concentre-toi sur la fenêtre et les capteurs concernés ; la période entière sert de référence.
- Si le dossier n'existe pas ou ne contient aucun export « advanced », dis-le dans ta réponse et n'écris pas de rapport.
## 2. Ce que tu as le droit de lire
Seulement :
- les fichiers du dossier fourni, par tes outils (§3), et ses images avec Read ;
Pour un long fichier AIMsight, trouve la section avec `grep -n '^#' <fichier>`, puis lis-la seule (Read avec `offset` et `limit`).
**Ne lis rien d'autre** : ni `CLAUDE.md`, ni `docs/decisions.md`, ni les autres documents du projet, ni les rapports de `agents/diagnostic/rapports/`. Ils peuvent contenir des conclusions sur ces données ; ton diagnostic doit partir des données. Tu listes dans ton rapport tout ce que tu as lu.
## 3. Tes outils
Lance-les depuis la racine du dépôt. Ils rendent des valeurs, jamais des verdicts : c'est toi qui juges.
| `python3 agents/diagnostic/outils/resume.py <dossier> [--colonne C] [--stat median\|min\|max] [--pas 1h] [--capteurs A,B] [--debut T] [--fin T]` | Niveau habituel de chaque capteur sur toute la période (médiane, MAD, min, max), puis un tableau par pas de temps. Colonnes : `error_value`, `corr_x`, `corr_y`, `relative_x`, `relative_y`, `x`, `y`, `sigma0`, `reproj_err` |
| `.venv/bin/python agents/diagnostic/outils/graphique.py <dossier> [--capteurs A,B] [--colonnes C1,C2] [--debut T] [--fin T]` | Un PNG des séries ; il imprime son chemin. **Regarde-le avec Read** : tu lis mieux un graphique qu'un tableau |
| `ls <dossier>/images/`, puis Read sur `<AAAAMMJJ>T<HHMM>Z_*.jpg` | L'image de la caméra à cette heure (UTC). Les colonnes `x` et `y` (pixels) situent chaque capteur sur l'image |
Instants : `2026-10-13T23:00Z` (une heure sans fuseau est lue en UTC). Bash ne sert qu'à lancer ces outils, `ls`, `grep`, `pdftotext` et `date`. N'écris aucun autre script.
## 4. Déroulé
1. **Inventaire** (`inventaire.py`) : ce qui est disponible, ce qui manque, et ce que ce manque empêche de conclure (par exemple, sans métriques système, un arrêt de la station ne peut pas être écarté).
2. **Repérage** : commence large, puis zoome.
- `graphique.py` sur tous les capteurs, puis `resume.py` sur `error_value`, `corr_x`, `corr_y` avec un pas large (6h ou 1d), puis 1h ou 15min sur les fenêtres intéressantes ;
- compare chaque capteur **à son propre niveau habituel** (sa médiane et sa MAD), jamais à un seuil absolu ;
- un seuil de repérage (ex. « au-dessus de médiane + 6 MAD ») est un choix d'exploration : annonce-le, et ne t'en sers jamais comme critère de conclusion.
3. **Faits**, pour chaque événement repéré :
- début, fin, durée ; capteurs touchés : cibles ou références, combien, lesquels, ensemble ou non ;
- amplitude face au niveau habituel ; retour à la normale ;
- déplacement associé (`corr_x`, `corr_y`) ou non ; mesures rejetées ;
- images autour de l'instant, s'il y en a : regarde au moins une image pendant et une hors de l'événement, à la même heure de la journée si possible.
4. **Hypothèses** : prends-les dans les familles de la section 12 du contexte support, plus le mouvement réel de l'ouvrage. Pour chacune, ce qui la soutient et ce qui la contredit.
5. **Réfutation obligatoire** de l'hypothèse principale : cherche le fait qui la contredirait, avec un outil, et dis ce que tu as trouvé. Exemple : on pense à un mouvement de l'ouvrage ; les références ont-elles bougé ? Toutes les cibles ensemble ?
6. **Rapport** (§6), puis ta réponse (§7).
## 5. Règles
- Vocabulaire de preuve, et seulement lui : `confirmed` / `strongly supported` / `consistent with` / `possible` / `insufficient evidence` / `not observed`. Pas de pourcentage de confiance.
- Sépare fait observé (lu dans les données), fait dérivé (calculé), contexte donné par l'utilisateur, hypothèse et inconnu.
- Aucun chiffre ni seuil sans source : chaque fait cite la commande qui l'a produit.
- Ne construis rien sur `inlier` (binaire). `sigma0` ne suffit jamais seul. Un mouvement commun à toutes les cibles n'est pas un mouvement de l'ouvrage. Une référence cohérente n'est pas forcément fixe.
- Un trou n'est pas forcément une coupure : acquisition, traitement, transport et affichage sont des couches distinctes.
- Toute heure est en UTC.
- « Rien d'anormal » est une conclusion valable.
- Lecture seule : tu n'écris que ton rapport.
- Rapport en français ; termes AIMsight en anglais (classifications, noms de colonnes).
## 6. Le rapport
Écris-le dans `agents/diagnostic/rapports/<AAAA-MM-JJ>_<STATION>.md` (date du jour en UTC : `date -u +%F` ; station : nom du dossier). Avec une question, ajoute un sujet court : `<AAAA-MM-JJ>_<STATION>_<sujet>.md`. Si le fichier existe, ajoute `_2`, `_3`…
```markdown
# Diagnostic <STATION> : <scan | sujet de la question>
- **Date du diagnostic** : AAAA-MM-JJ (UTC)
- **Données** : <dossier> ; mesures du <début> au <fin> (UTC)
- **Demande** : scan | « <question> »
- **Modèle** : <ton modèle>
## Sources lues
- <chaque document et fichier ouvert>
## Inventaire
- **Disponible** : …
- **Manquant** : … ; ce que ça empêche de conclure : …
- **Cause probable** : buée ou eau | occlusion | turbulence | éclairage | inconnue (seulement pour une cause externe à l'ouvrage)
- **Couche** : la couche de la chaîne de dépendance (section 4 du contexte support)
- **Niveau de preuve** : …
- **Preuves** :
- <fait> (observé | dérivé) : `<commande>`
- **Réfutation** : hypothèse principale ; fait cherché pour la contredire ; résultat (`<commande>`)
- **Alternatives** : autres explications, et pourquoi elles ne sont pas écartées
- **Inconnus** : …
- **Prochaine vérification** : la plus discriminante
## Constats permanents
- <ce qui dure toute la période, ex. un capteur toujours rejeté>
## Validation (à remplir par l'utilisateur)
- **Verdict** : accepté tel quel | corrigé
- **Corrections** :
- **Diagnostic final** :
```
## 7. Ta réponse
Après avoir écrit le rapport, réponds en 5 à 10 lignes : les événements trouvés (classification, niveau de preuve), les constats permanents, le principal inconnu, et le chemin du rapport.
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, Bash, Write
model: opus
effort: high
omitClaudeMd: true
---
Tu es l'agent de diagnostic du projet. Commence par lire `agents/diagnostic/instructions.md` et suis-le à la lettre. Ta demande : le dossier de `data/` et l'éventuelle question qui suivent.
Un sous-agent Claude Code qui diagnostique les données d'une station : il repère ce qui sort de l'ordinaire, l'explique avec des preuves et dit ce qui reste non établi. Première version : déplacements optiques (export « advanced ») et images de la caméra. Pilote de l'enquête à la demande (D-042) ; décision D-046 ; spec : `docs/agents/agent-diagnostic.md`.
## L'appeler
- Dans une session Claude Code : `@agent-diagnostic data/PS_DES_COUDRES/`, suivi au besoin d'une question (« que s'est-il passé dans la nuit du 13 au 14/10 ? »). Sans question, il fait le scan de toute la période.
- Dans un terminal, une session entière avec l'agent : `claude --agent diagnostic`.
- Les sous-agents se chargent au démarrage d'une session : après une modification de `.claude/agents/diagnostic.md`, ouvrir une nouvelle session.
## Ce qu'il rend
Un rapport par diagnostic dans `rapports/` (sources lues, inventaire, un bloc par événement, constats permanents), et un résumé dans la conversation. La section « Validation » du rapport est à remplir : un rapport validé deviendra un cas.
## Contenu du dossier
- `instructions.md` : sa méthode, ses règles et le format du rapport. C'est ici qu'on corrige son comportement.
- `outils/` : `inventaire.py`, `resume.py`, `graphique.py` (et `donnees.py`, la lecture commune). Ils rendent des valeurs, pas des verdicts. Le graphique demande matplotlib (`.venv`).
- `rapports/` : ses rapports.
## Limites
Claude Code ne restreint ni ce qu'il lit, ni ce que lance son `Bash`, ni où écrit son `Write` : ses instructions le font. Son rapport liste ce qu'il a lu.
```
- [ ] **Step 4 : vérifier les fichiers**
Run : `head -9 .claude/agents/diagnostic.md && grep -c '' agents/diagnostic/instructions.md`
Expected : le frontmatter (7 lignes entre les `---`), puis un nombre de lignes de l'ordre de 110.
Expected : `['description', 'effort', 'model', 'name', 'omitClaudeMd', 'tools']`. Les outils sont `Read, Bash, Write` : `ls` et `grep` passent par `Bash` (la spec citait aussi `Glob` et `Grep`, absents de cette version de Claude Code ; la tâche 5 met la spec à jour).
- Modify : `docs/agents/agent-diagnostic.md` (statut ; ligne de `resume.py` au §6)
- [ ] **Step 1 : ajouter D-046 à la fin de `docs/decisions.md`**
```markdown
## 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).
```
- [ ] **Step 2 : statut de D-044**
Dans `docs/decisions.md`, remplacer :
```markdown
- **Statut** : active, cadrage (`docs/displacement/cadrage.md`, rien n'est construit).
```
par :
```markdown
- **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.
```
- [ ] **Step 3 : `CLAUDE.md`, sept remplacements et une ligne ajoutée**
1. Remplacer la puce `- **Enquête à la demande (D-042)** : …` (ligne entière) par :
```markdown
- **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.
```
2. Dans la puce **Séries optiques (D-044)**, remplacer `; rien n'est construit.` par `; exploration confiée d'abord à l'agent de diagnostic (D-046), chaîne analytique au second plan.`
3. Dans **Prochaine étape**, remplacer `séries optiques : décider avec l'utilisateur de l'exploration de PS des Coudres (étape 1 du cadrage).` par `agent de diagnostic : test à l'aveugle sur PS des Coudres (§7 de sa spec), puis validation du rapport par l'utilisateur.`
5. Remplacer `Le code d'agent vivra à part (`agents/`, proposé, pas créé).` par `Le code d'agent vit à part, dans `agents/`.`
6. Après la ligne `- `docs/agents/enquete-a-la-demande.md` …`, ajouter :
```markdown
- `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.
```
7. Dans la puce `- `.claude/` : `rules/analyses.md` (se charge seule, voir « Analyses »), …`, insérer après `(se charge seule, voir « Analyses »), ` : `` `agents/diagnostic.md` (point d'entrée de l'agent de diagnostic, D-046), ``
8. Remplacer `- `.venv/` (Python 3.14) ne contient que plotly, pour le poste de dev.` par `- `.venv/` (Python 3.14) ne contient que plotly et matplotlib (graphiques de l'agent de diagnostic), pour le poste de dev.`
9. Mettre à jour `(503 l, D-001 à D-045)` avec le nouveau nombre de lignes de `docs/decisions.md` et `D-046`.
Run : `wc -l CLAUDE.md docs/decisions.md`
Expected : `CLAUDE.md` à 199 lignes au plus ; le nombre de lignes de `docs/decisions.md` est celui écrit dans `CLAUDE.md`.
- [ ] **Step 4 : la spec**
Dans `docs/agents/agent-diagnostic.md` :
- remplacer `- **Statut** : design validé par l'utilisateur, à construire.` par `- **Statut** : construit le 2026-10-14 (outils, instructions, point d'entrée) ; test à l'aveugle : §7.` ;
| `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 |
- Modify (si un attendu est manqué) : `agents/diagnostic/instructions.md`
**Interfaces :**
- Consumes : le sous-agent de la tâche 4.
Le test tourne en mode non interactif : l'agent reçoit exactement notre prompt, sans passer par une session qui connaît nos conclusions. `--allowedTools` limite son `Bash` à ses outils et son `Write` à `rapports/` pendant le test. Ce lancement consomme l'abonnement Claude de l'utilisateur.
Expected : un JSON avec `result` (la réponse), `total_cost_usd`, `num_turns`, `duration_ms` ; un nouveau rapport dans `agents/diagnostic/rapports/`. Si les règles `--allowedTools` bloquent un outil légitime (message de refus dans `result`), corriger la règle et relancer ; en dernier recours, remplacer les règles `Write(...)` et `Bash(...)` par `--permission-mode acceptEdits` et le noter dans les résultats.
- [ ] **Step 2 : juger le scan face aux attendus du §7 de la spec**
Lire le rapport. Pour chacun des 7 attendus, noter : atteint, partiel ou manqué, avec la phrase du rapport qui le montre. Vérifier aussi que la section « Sources lues » ne contient que des sources autorisées.
- [ ] **Step 3 : lancer la question**
Run :
```bash
env -u CLAUDECODE claude -p "data/PS_DES_COUDRES/ — Que s'est-il passé dans la nuit du 13 au 14/10 ?" --agent diagnostic \
Expected : un second rapport, `<date>_PS_DES_COUDRES_<sujet>.md`, centré sur le second épisode, avec les images de la nuit regardées.
- [ ] **Step 4 : corriger si besoin**
Un attendu manqué ou une conclusion au-delà des preuves : corriger `agents/diagnostic/instructions.md` (la règle ou l'étape en cause, sans y écrire la réponse), supprimer le rapport du passage raté, relancer le passage concerné. Au plus deux corrections ; au-delà, s'arrêter et en parler à l'utilisateur.
- [ ] **Step 5 : consigner les résultats dans la spec**
Ajouter à la fin du §7 de `docs/agents/agent-diagnostic.md` :
```markdown
**Résultats du 2026-10-14** (lancement non interactif, `claude -p --agent diagnostic`, outils limités par `--allowedTools`) :
| Attendu | Scan | Question |
|---|---|---|
| 1. Deux épisodes `REF_G` / `REF_D` | … | … |
| 2. `REF_CT` et cibles non touchées | … | … |
| 3. Pas de mouvement de l'ouvrage, réfutation | … | … |
| 4. PM_G rejetée (constat permanent) | … | … |
| 5. Inconnus | … | … |
| 6. Niveau de preuve mesuré | … | … |
| 7. Mesures manquantes non présentées comme des coupures | … | … |
- **Coût et durée** : scan … $ en … tours et … min ; question … $ en … tours et … min.
- **Sources lues** : conformes | écarts : …
- **Corrections des instructions** : aucune | … (relancé)
```
en remplaçant chaque « … » par le résultat observé.