Document the diagnostic agent case base: spec, D-048, README and CLAUDE.md
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
f056da2875
commit
ee61d62d79
5 files changed
+623
-15
No files matched your search
@@ -11,13 +11,25 @@ Un sous-agent Claude Code qui diagnostique les données d'une station : il repè
|
||||
|
||||
## 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 : un rapport validé deviendra un cas.
|
||||
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/<STATION>/` (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/<STATION>/ que s'est-il passé du <début> au <fin> (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-<numéro>_<STATION>_<AAAA-MM-JJ>/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
|
||||
|
||||
|
||||
Reference in new issue
Block a user