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.