Files
Support-Agent/agents/diagnostic
maximeandClaude Opus 5.5 56b93e9b82 Agent tools: reading tools moved to agent-tools/ (D-081)
The reading tools leave agents/diagnostic/outils/ for a root folder of their
own; paths updated in skills, agents, detectors, scripts, case fiches,
support/, contexts and CLAUDE.md; graphique, vignettes and gif find the repo
root one level up; history keeps old paths.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-28 16:36:45 +01:00
..

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. On l'appelle pour un cas précis, que les détecteurs du journal n'expliquent pas : il part de leurs événements et de toute la connaissance du projet (D-058), sans les juger, et n'ajoute rien à la base de cas. 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 » y note la décision ; l'ajout se fait par /nouveau-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.
  • agent-tools/ (racine du dépôt, D-081) : 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.
  • events/ (racine du dépôt) : la base de cas validés par l'expert (D-048) : INDEX.md, une ligne par incident, et un dossier par incident (cas.md, ses figures et ses données). L'agent la lit après avoir établi ses faits. Spec : §11 de docs/agents/agent-diagnostic.md.

Ajouter un cas

Avec le skill /nouveau-cas (.claude/skills/nouveau-cas/SKILL.md), que seul l'utilisateur lance : de nouvelles données et le diagnostic de l'expert donnent un cas, après un passage de l'agent à l'aveugle et un test de correspondance. Rien d'autre n'ajoute un cas.

Rejouer un cas : retirer sa ligne de cas/INDEX.md sans commiter, lancer l'agent sur sa fenêtre, comparer son rapport au Verdict et au Diagnostic de la fiche, restaurer la ligne (git checkout events/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.