Events: read-event skill to consult the base (D-085), cases renamed events E-xxx (D-086)
- read-event: map and index first, then the card of close events only, then their data with the reading tools; never all cards at once. Diagnostic agent, critiquer-lot and builder point to it; the index header too. Signature length: about 250 characters, a guideline. - "Cas" becomes "event": events/E-xxx/event.md, skills new-event, review-event, anonymize-event. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
4d99585474
commit
446fde3192
1206 files changed
+2172
-2129
No files matched your search
@@ -13,27 +13,27 @@ On veut donc un autre processus automatique, à part de `/boucle`, qui ne travai
|
||||
**Buts.**
|
||||
- Une commande lance une séance sur un dossier de station ; elle tourne seule jusqu'au bout ; tout est commité, étape par étape, directement sur `master`, comme `/boucle` (D-070 ; d'abord sur une branche à part, accepté le 2026-10-24, remplacée par D-077).
|
||||
- À la fin, un skill de lecture meilleur (§4) : ses outils et son mode d'emploi. Il sert à l'analyste et à l'agent de diagnostic, donc chaque gain profite aux deux (accepté).
|
||||
- Elle tourne sur n'importe quelles données, sans vérité connue : pas seulement sur les cinq cas validés (l'utilisateur).
|
||||
- Elle tourne sur n'importe quelles données, sans vérité connue : pas seulement sur les cinq events validés (l'utilisateur).
|
||||
|
||||
**Non-buts.**
|
||||
- Les détecteurs du journal : c'est `/boucle`.
|
||||
- La base de cas : la séance n'ajoute aucun cas ; ce que le correcteur trouve de nouveau va au bilan, pour `/boucle` ou `/nouveau-cas` *(choix de Claude)*.
|
||||
- Le raisonnement de diagnostic : classer, comparer aux cas, faire des hypothèses, conclure. Seule la lecture change.
|
||||
- La base d'events : la séance n'ajoute aucun event ; ce que le correcteur trouve de nouveau va au bilan, pour `/boucle` ou `/new-event` *(choix de Claude)*.
|
||||
- Le raisonnement de diagnostic : classer, comparer aux events, faire des hypothèses, conclure. Seule la lecture change.
|
||||
- Récupérer les données (un dossier de station au format de `data/<STATION>/`, comme `/boucle`) ; les autres domaines.
|
||||
- L'exhaustivité : pas de rejeu des lots déjà vus, comme `/boucle`.
|
||||
|
||||
**Ce qui serait un échec.**
|
||||
- **Des outils qui jugent** : un seuil, une catégorie, « anomalie ici » dans ce que rend un outil. Ils deviendraient des détecteurs de plus, et l'analyste finirait par valider ce qu'il lit (accepté).
|
||||
- **Des outils taillés pour les cas** : un outil qui « sait » où chercher la buée de C-001, une règle propre à une station, à un capteur ou à une date (accepté).
|
||||
- **Des outils taillés pour les events** : un outil qui « sait » où chercher la buée de E-001, une règle propre à une station, à un capteur ou à une date (accepté).
|
||||
- **La complexité** : des outils qui se multiplient et un mode d'emploi qui s'allonge pour un petit gain (même crainte que pour `/boucle`, accepté).
|
||||
- Casser une commande citée par une fiche de cas : les fiches C-001 à C-005 citent des commandes de `resume.py`, `inventaire.py` et `vignettes.py` avec leurs options, et les cas existants ne se modifient jamais *(constaté dans les fiches)*.
|
||||
- Casser une commande citée par une fiche d'events : les fiches E-001 à E-005 citent des commandes de `resume.py`, `inventaire.py` et `vignettes.py` avec leurs options, et les events existants ne se modifient jamais *(constaté dans les fiches)*.
|
||||
- Un lecteur qui voit le corrigé, ou un correcteur qui lit avec les outils qu'on améliore : la mesure ne vaudrait plus rien.
|
||||
|
||||
## 3. Ce qui existe
|
||||
|
||||
- **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 `agent-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.
|
||||
- **Les cinq events validés**, `events/E-001/` à `E-005/` : données (`displacement/`, `images/`), fiche `event.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).
|
||||
|
||||
## 4. Ce qu'on optimise : le skill `lire-les-donnees`
|
||||
@@ -44,7 +44,7 @@ Un skill, `.claude/skills/lire-les-donnees/SKILL.md`, devient la seule source du
|
||||
- la méthode de lecture d'un lot : inventaire ; large puis zoom ; chaque capteur face à son propre niveau habituel ; vignettes espacées, plus serrées là où les courbes bougent, avec un capteur témoin ; images entières pour la scène ;
|
||||
- ce que la lecture rend : une ligne par moment (début, fin, capteurs, colonnes, ce qu'on voit, ce que montrent les images).
|
||||
|
||||
Il ne contient ni catégorie, ni cas, ni hypothèse, ni verdict : c'est l'affaire de celui qui l'appelle.
|
||||
Il ne contient ni catégorie, ni event, ni hypothèse, ni verdict : c'est l'affaire de celui qui l'appelle.
|
||||
|
||||
**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)*.
|
||||
|
||||
@@ -69,9 +69,9 @@ Il ne contient ni catégorie, ni cas, ni hypothèse, ni verdict : c'est l'affair
|
||||
|
||||
La séance suivante tourne avec le skill tel qu'il est devenu.
|
||||
|
||||
**Commandes des fiches, une fois, en fin de séance** : l'orchestrateur lance les commandes que citent les fiches de la base de cas (pas d'agent) ; les échecs vont au bilan. Rien n'est annulé d'office : le bilan le dit et l'utilisateur décide. Il n'y a plus de contrôle de lecture sur les cinq cas validés (D-064) : l'utilisateur a validé les diagnostics de ces cas, pas les outils qui les lisent.
|
||||
**Commandes des fiches, une fois, en fin de séance** : l'orchestrateur lance les commandes que citent les fiches de la base d'events (pas d'agent) ; les échecs vont au bilan. Rien n'est annulé d'office : le bilan le dit et l'utilisateur décide. Il n'y a plus de contrôle de lecture sur les cinq events validés (D-064) : l'utilisateur a validé les diagnostics de ces events, pas les outils qui les lisent.
|
||||
|
||||
**Bilan** : `bilan.md`, une ligne pour le lot (verdict du premier écart ; passages gardés, annulés ; verdict du dernier écart), les commandes des fiches en échec, les manques imputés au lecteur (que le skill ne pouvait pas corriger), les nouveautés vues par le correcteur (pour `/boucle` ou `/nouveau-cas`), les erreurs. Commit.
|
||||
**Bilan** : `bilan.md`, une ligne pour le lot (verdict du premier écart ; passages gardés, annulés ; verdict du dernier écart), les commandes des fiches en échec, les manques imputés au lecteur (que le skill ne pouvait pas corriger), les nouveautés vues par le correcteur (pour `/boucle` ou `/new-event`), les erreurs. Commit.
|
||||
|
||||
**Difficultés** : le releveur note celles de la séance (D-060) ; avec `--ameliorer`, l'améliorateur (`.claude/agents/ameliorateur.md`, le même que pour `/boucle`) corrige ensuite le skill `/aiguiser`, ses agents, `voir.py`, cette spec et `run.md` d'après ces relevés, et marque les entrées **traité** ; les outils de lecture et `lire-les-donnees` restent à l'optimiseur (D-076). Commit `Sharpen <STATION>: process fixes`.
|
||||
|
||||
@@ -87,7 +87,7 @@ Lancé par l'utilisateur seulement (`disable-model-invocation: true`). Il dérou
|
||||
|
||||
### Lecteur : `.claude/agents/lecteur.md`
|
||||
|
||||
Il teste le skill : il lit `lire-les-donnees/SKILL.md` et le suit, rien d'autre. Outils : Read, Bash, Write. Il lit le dossier de station par les outils du skill, les images par Read, et les deux notes de `docs/domaine/` que le skill cite. **Il ne lit pas** : les détecteurs ni leur sortie, la base de cas, la carte des événements, les rendus de la séance (ni le corrigé, ni les écarts, ni les modifications), `CLAUDE.md`, `docs/decisions.md`, `vues-deplacements/` hors du dossier de station, les autres séances de `aiguiser/` et `boucle/`. Il n'écrit aucun script.
|
||||
Il teste le skill : il lit `lire-les-donnees/SKILL.md` et le suit, rien d'autre. Outils : Read, Bash, Write. Il lit le dossier de station par les outils du skill, les images par Read, et les deux notes de `docs/domaine/` que le skill cite. **Il ne lit pas** : les détecteurs ni leur sortie, la base d'events, la carte des événements, les rendus de la séance (ni le corrigé, ni les écarts, ni les modifications), `CLAUDE.md`, `docs/decisions.md`, `vues-deplacements/` hors du dossier de station, les autres séances de `aiguiser/` et `boucle/`. Il n'écrit aucun script.
|
||||
|
||||
`lecture-K.md` : le tableau des moments (début, fin, capteurs, colonnes, ce que je vois, ce que montrent les images) ; **ce qui m'a manqué** : où il a peiné, ce qu'il aurait voulu pouvoir regarder ; les sources lues. Ses figures dans `lot-NN/lecture-K/`, une lecture par dossier, pour qu'une lecture n'écrase pas les figures d'une autre (même nom de PNG).
|
||||
|
||||
@@ -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** `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).
|
||||
- **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 d'events, 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` :
|
||||
@@ -133,7 +133,7 @@ Il reprend les défauts du dernier écart (et la modification annulée, s'il y e
|
||||
- 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 (`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.
|
||||
- **Ne rien casser** : les options et les sorties existantes restent ; une commande citée par une fiche d'events marche toujours *(constaté dans les fiches)*. Il relance l'outil modifié sur le lot, et une commande d'une fiche qui l'emploie.
|
||||
- `modification-K.md` : le défaut traité, ce qui a changé et pourquoi, la commande de l'essai et ce qu'elle rend, ce qu'il n'a pas pu faire.
|
||||
|
||||
## 7. Coût
|
||||
@@ -160,7 +160,7 @@ Ordre de grandeur, à mesurer au premier essai : une lecture ≈ un passage de l
|
||||
|
||||
## 10. Laissé au constructeur
|
||||
|
||||
Le texte des consignes de chaque agent ; le format exact des messages de commit ; le lot (la plage donnée, sans découpe, D-078) ; comment le lecteur lit un cas sans voir sa fiche ni ses figures au contrôle (proposition : un dossier de liens vers `displacement/` et `images/`, hors du dépôt) ; ce qui reste du §3 et du §4 des instructions de l'agent de diagnostic une fois le mode d'emploi passé dans le skill, sans changer son raisonnement ; le mode de permission qui laisse une séance tourner sans demander d'accord (le correcteur écrit et lance des scripts).
|
||||
Le texte des consignes de chaque agent ; le format exact des messages de commit ; le lot (la plage donnée, sans découpe, D-078) ; comment le lecteur lit un event sans voir sa fiche ni ses figures au contrôle (proposition : un dossier de liens vers `displacement/` et `images/`, hors du dépôt) ; ce qui reste du §3 et du §4 des instructions de l'agent de diagnostic une fois le mode d'emploi passé dans le skill, sans changer son raisonnement ; le mode de permission qui laisse une séance tourner sans demander d'accord (le correcteur écrit et lance des scripts).
|
||||
|
||||
À faire avec la construction : une entrée D-059 dans `docs/decisions.md` (le skill de lecture, seule source du mode d'emploi ; `/aiguiser` ; ce qui reste de « ses outils propres » de D-058) ; une ligne dans `CLAUDE.md` et dans `vues-deplacements/CLAUDE.md` ; dans `boucle-automatique.md` (§3), les outils ne sont plus « utilisés tels quels » mais évoluent par `/aiguiser` ; la spec de l'agent de diagnostic, `docs/agents/agent-diagnostic.md`, pour le renvoi au skill.
|
||||
|
||||
|
||||
Reference in new issue
Block a user