# Agent de diagnostic Un sous-agent Claude Code qui diagnostique les données d'une station : il repère les anomalies, les montre (graphiques, vignettes des images), les 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. - Ne lui passer que le dossier et la question : le sous-agent ne voit pas la conversation, seulement ce qu'on lui transmet. - Dans un terminal, une session entière avec l'agent : `claude --agent diagnostic`. Attention : en session principale, `CLAUDE.md` est chargé (`omitClaudeMd` ne vaut que pour un sous-agent) ; l'agent connaît alors nos conclusions. - 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 dossier par diagnostic dans `rapports/` : `rapport.md` (verdict, une section courte par anomalie avec ses figures, « Hors anomalie », annexe) et ses figures PNG ; un résumé dans la conversation. La section « Validation » du rapport est à remplir ; « Devient un cas : oui » y demande d'en faire un cas (ci-dessous). ## 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`, `vignettes.py` (recadrage des images autour des capteurs), et `donnees.py`, la lecture commune. Ils rendent des valeurs, pas des verdicts. Le graphique et les vignettes demandent matplotlib (`.venv`). - `rapports/` : ses rapports, un dossier chacun. - `cas/` : la base de cas validés par l'expert (D-048) : `INDEX.md`, une ligne par incident, et un dossier par incident (`cas.md` et ses figures). L'agent la lit après avoir établi ses faits. Spec : §11 de `docs/agents/agent-diagnostic.md`. ## Ajouter un cas Seulement sur demande explicite de l'utilisateur : en conversation, ou « Devient un cas : oui » dans la validation d'un rapport. Recevoir des données ou valider un rapport sans ce « oui » ne suffit pas. 1. Les données vont dans `data//` (D-029) ; l'avis de l'expert reste hors du dépôt jusqu'à l'étape 4. 2. Commiter (arbre propre : un `git status` sale a déjà fuité), puis lancer l'agent à l'aveugle sur la fenêtre de l'incident : `@agent-diagnostic data// que s'est-il passé du au (UTC) ?`. Il doit répondre « aucun cas connu » ou citer le bon cas, jamais un faux. 3. Comparer son rapport à l'avis de l'expert ; un attendu manqué se corrige dans `instructions.md`. 4. Écrire `cas/C-__/cas.md` au modèle du §11.3 de la spec (signature tirée des faits et des commandes du rapport, diagnostic de l'expert), y copier les figures du rapport, ajouter sa ligne à `cas/INDEX.md` (et retirer « Base vide pour l'instant »), commiter. **Rejouer un cas** : retirer sa ligne de `cas/INDEX.md` sans commiter, lancer l'agent sur sa fenêtre, comparer son rapport à « Attendu de l'agent » de la fiche, restaurer la ligne (`git checkout agents/diagnostic/cas/INDEX.md`). ## 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.