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>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-28 16:36:45 +01:00
1 parent cb98818712
commit 56b93e9b82
55 files changed
+135 -127

No files matched your search

@@ -31,7 +31,7 @@ On veut donc un autre processus automatique, à part de `/boucle`, qui ne travai
## 3. Ce qui existe
- **Les outils de lecture**, `agents/diagnostic/outils/` (419 lignes) : `donnees.py` (lecture commune des exports), `inventaire.py`, `resume.py`, `graphique.py` (PNG des séries), `vignettes.py` (gros plans des capteurs sur les images). Bibliothèque standard, matplotlib par `.venv` pour les figures. Ils rendent des valeurs, jamais des verdicts.
- **Les outils de lecture**, `agent-tools/` (419 lignes) : `donnees.py` (lecture commune des exports), `inventaire.py`, `resume.py`, `graphique.py` (PNG des séries), `vignettes.py` (gros plans des capteurs sur les images). Bibliothèque standard, matplotlib par `.venv` pour les figures. Ils rendent des valeurs, jamais des verdicts.
- **Leur mode d'emploi est recopié à deux endroits** : le tableau « Tes outils » et l'étape 1 de `.claude/skills/critiquer-lot/SKILL.md` (l'analyste), le §3 et une partie du §4 (étapes 1, 2 et 4) de `agents/diagnostic/instructions.md` (l'agent de diagnostic).
- **Les cinq cas validés**, `events/C-001/` à `C-005/` : données (`displacement/`, `images/`), fiche `cas.md` (signature en critères, avec leurs commandes) et figures, dans le même dossier.
- **Le modèle de `/boucle`** (D-057, `vues-deplacements/contexte/boucle-automatique.md`, skill `.claude/skills/boucle/SKILL.md`) : un skill orchestrateur dans la conversation principale, des sous-agents qui ne se parlent pas et écrivent chacun un rendu, une ligne `**Verdict** :` lue par `grep`, des commits par chemin, une branche par séance, un `bilan.md`. Un passage de l'analyste coûte environ 250 000 jetons et 8 min 30 (essai du 2026-10-24).
@@ -48,7 +48,7 @@ Il ne contient ni catégorie, ni cas, ni hypothèse, ni verdict : c'est l'affair
**Ceux qui l'utilisent** : l'analyste (« Tes outils » et l'étape 1 de `critiquer-lot` renvoient au skill ; l'étape 1 garde la catégorie de la carte, ajoutée après la lecture), l'agent de diagnostic (le §3 de ses instructions renvoie au skill et garde la ligne `categories.py` et la remarque sur `--sortie` ; ses étapes de diagnostic ne changent pas) et le lecteur (§6). Les sous-agents le lisent par Read, comme l'analyste lit `critiquer-lot` *(choix de Claude)*.
**L'optimiseur touche à deux choses, et seulement à elles** : les scripts de `agents/diagnostic/outils/` (y compris un nouveau script) et `lire-les-donnees/SKILL.md`.
**L'optimiseur touche à deux choses, et seulement à elles** : les scripts de `agent-tools/` (y compris un nouveau script) et `lire-les-donnees/SKILL.md`.
## 5. Une séance
@@ -95,7 +95,7 @@ Il teste le skill : il lit `lire-les-donnees/SKILL.md` et le suit, rien d'autre.
C'est le validateur des outils de lecture ; « correcteur » parce qu'il compare une copie à un corrigé (accepté). Outils : Read, Bash, Write. Deux demandes :
- **Lecture lente** : il lit le lot sans limite, avec **ses propres scripts** (bibliothèque standard, matplotlib par `.venv`), rangés avec ses figures dans `lot-NN/corrige/`, sur les exports bruts, et autant d'images qu'il le juge utile. Il peut lire `docs/domaine/` et la carte des événements. **Il n'utilise pas** `agents/diagnostic/outils/`, pas même `donnees.py` (une erreur de lecture commune passerait inaperçue) *(choix de Claude)*, ne lit pas `lire-les-donnees/SKILL.md`, ni les détecteurs, ni la base de cas, et il écrit `corrige.md` **avant** d'ouvrir la lecture. `corrige.md` a le même tableau que la lecture, pour comparer ligne à ligne *(choix de Claude)*. Puis il écrit l'écart (ci-dessous).
- **Lecture lente** : il lit le lot sans limite, avec **ses propres scripts** (bibliothèque standard, matplotlib par `.venv`), rangés avec ses figures dans `lot-NN/corrige/`, sur les exports bruts, et autant d'images qu'il le juge utile. Il peut lire `docs/domaine/` et la carte des événements. **Il n'utilise pas** `agent-tools/`, pas même `donnees.py` (une erreur de lecture commune passerait inaperçue) *(choix de Claude)*, ne lit pas `lire-les-donnees/SKILL.md`, ni les détecteurs, ni la base de cas, et il écrit `corrige.md` **avant** d'ouvrir la lecture. `corrige.md` a le même tableau que la lecture, pour comparer ligne à ligne *(choix de Claude)*. Puis il écrit l'écart (ci-dessous).
- **Écart seul** : `corrige.md`, la nouvelle lecture et le dernier écart ; il peut revenir aux données pour trancher (le lecteur a pu voir juste là où le corrigé s'est trompé : alors il corrige le corrigé et le dit).
`ecart-K.md` :
@@ -130,7 +130,7 @@ aucune | - <moment, capteurs, ce qui le montre>
Il reprend les défauts du dernier écart (et la modification annulée, s'il y en a une) et modifie le skill. Outils : Read, Edit, Write, Bash. Il peut lire le corrigé, les scripts du correcteur, la partie « ce qui m'a manqué » des lectures et les données du lot.
- Il ne touche qu'à `agents/diagnostic/outils/` et à `lire-les-donnees/SKILL.md` (§4).
- Il ne touche qu'à `agent-tools/` et à `lire-les-donnees/SKILL.md` (§4).
- **Le plus simple d'abord** (accepté) : une phrase du mode d'emploi ou un réglage par défaut ; sinon une option d'un outil existant ; un nouvel outil en dernier recours.
- **Interdits** (accepté) : aucun jugement dans ce que rend un outil (ni seuil, ni catégorie, ni « anomalie ») ; rien de propre à une station, à un capteur ou à une date ; aucun import des détecteurs (`vues-deplacements/detectors/`) ; bibliothèque standard, matplotlib pour les figures seulement.
- **Ne rien casser** : les options et les sorties existantes restent ; une commande citée par une fiche de cas marche toujours *(constaté dans les fiches)*. Il relance l'outil modifié sur le lot, et une commande d'une fiche qui l'emploie.
@@ -32,7 +32,7 @@ L'analyste et le validateur ne laissent rien de durable eux-mêmes : ce sont les
## 3. Ce qui existe et que la boucle réutilise
- Les détecteurs du journal : `vues-deplacements/detectors/*.py`, contrat `detect(mesures)`, classés en événements par `categories.py`. Le tri en lot existe (point 30, validé) : `python3 vues-deplacements/detectors/categories.py <dossier> --du AAAA-MM-JJ --au AAAA-MM-JJ --tranche 4 --historique 3`. Chaque lot est classé avec les 3 jours d'avant : c'est la règle pour la boucle (D-056).
- Les outils de lecture des données, `agents/diagnostic/outils/` : `inventaire.py`, `resume.py`, `graphique.py` (PNG des séries), `vignettes.py` (gros plans des cibles sur les images) ; leur mode d'emploi est le skill `.claude/skills/lire-les-donnees/`, que suit l'analyste ; ils évoluent par `/aiguiser` (D-059, `aiguiser-la-lecture.md`), pas par la boucle. Seuls les outils servent : l'agent de diagnostic, lui, n'est pas appelé.
- Les outils de lecture des données, `agent-tools/` : `inventaire.py`, `resume.py`, `graphique.py` (PNG des séries), `vignettes.py` (gros plans des cibles sur les images) ; leur mode d'emploi est le skill `.claude/skills/lire-les-donnees/`, que suit l'analyste ; ils évoluent par `/aiguiser` (D-059, `aiguiser-la-lecture.md`), pas par la boucle. Seuls les outils servent : l'agent de diagnostic, lui, n'est pas appelé.
- La carte des événements, `events/carte-des-evenements.md` : ce qui peut arriver, en familles, et les catégories du journal (section 4).
- La base de cas, `events/` : l'index `INDEX.md`, le modèle de fiche (§11.3 de `docs/agents/agent-diagnostic.md`), le skill `anonymiser-cas` (données copiées dans le dossier du cas, noms codés, D-049, D-050). Les cas existants ne se modifient jamais ; la boucle en ajoute.
- Le registre des seuils, `vues-deplacements/contexte/seuils-du-journal.md` : une constante changée le met à jour dans le même changement.
@@ -4,7 +4,7 @@
## Recommandation
**Option A, avec un seul script** (`extraction/pomper.py`, essayé le 2026-10-26) : il réutilise les lectures de l'appli, ouvre un moteur PostgreSQL **en lecture seule** (comme `scripts/domain_diagnostics.py`, déjà lancé avec succès dans le container le 2026-10-21) et écrit, un fichier par jour, les métriques système (`data/<STATION>/metrics/<STATION>_<métrique>_….csv`, le format du téléchargement de la page System, que lit `common.stations`), `data/<STATION>/displacement/…_advanced_….csv` et `data/<STATION>/images/…jpg`, les formats que `agents/diagnostic/outils/donnees.py` (`trouver`, `heure_image`) lit déjà (point 43 du plan). B n'est pas une autre solution : c'est ce même script lancé depuis WSL, si la base y est joignable (non vérifié). C (une route d'export) vient seulement si la boucle prouve sa valeur.
**Option A, avec un seul script** (`extraction/pomper.py`, essayé le 2026-10-26) : il réutilise les lectures de l'appli, ouvre un moteur PostgreSQL **en lecture seule** (comme `scripts/domain_diagnostics.py`, déjà lancé avec succès dans le container le 2026-10-21) et écrit, un fichier par jour, les métriques système (`data/<STATION>/metrics/<STATION>_<métrique>_….csv`, le format du téléchargement de la page System, que lit `common.stations`), `data/<STATION>/displacement/…_advanced_….csv` et `data/<STATION>/images/…jpg`, les formats que `agent-tools/donnees.py` (`trouver`, `heure_image`) lit déjà (point 43 du plan). B n'est pas une autre solution : c'est ce même script lancé depuis WSL, si la base y est joignable (non vérifié). C (une route d'export) vient seulement si la boucle prouve sa valeur.
## Ce que j'ai trouvé