Files
Support-Agent/agents/diagnostic
maximeandClaude Opus 5.5 4d14f5ea5d Open the diagnostic agent to project knowledge and the journal detectors (D-058)
The agent now serves one precise case, reads the project's displacement
knowledge and the whole case base, starts from the detectors' events
without judging them, and no longer has conclusions imposed on it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-24 15:46:30 +02: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.
  • 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, 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 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.