From ba2e9da3abdfee14921343c92b72e8cb4699219f Mon Sep 17 00:00:00 2001 From: maxime Date: Thu, 29 Oct 2026 08:02:25 +0100 Subject: [PATCH] Analyst: consults the event base whenever it wants (D-088) The event base is the analyst's knowledge base, read before or during its reading; a known event is a lead to check on the data, not a conclusion. No measurement of the analyst's progress. Co-Authored-By: Claude Opus 5.5 --- .claude/skills/critiquer-lot/SKILL.md | 4 ++-- .claude/skills/read-event/SKILL.md | 2 +- CLAUDE.md | 2 +- docs/decisions.md | 11 +++++++++-- docs/superpowers/plans/2026-10-23-journal-du-matin.md | 11 +++++++---- 5 files changed, 20 insertions(+), 10 deletions(-) diff --git a/.claude/skills/critiquer-lot/SKILL.md b/.claude/skills/critiquer-lot/SKILL.md index 62052e6..73d4a40 100644 --- a/.claude/skills/critiquer-lot/SKILL.md +++ b/.claude/skills/critiquer-lot/SKILL.md @@ -18,7 +18,7 @@ Tu reçois : le dossier de station, le lot (début et fin, UTC), la commande du - le dossier de station, par ces outils, et ses images avec Read ; - `docs/domaine/colonnes-des-deplacements.md` et `docs/domaine/pieges-des-donnees.md`, que ce skill cite ; - `events/carte-des-evenements.md` : ce qui peut arriver, en familles, et les catégories du journal (section 4 : définition de chacune, éventualités du terrain qui la font, détecteurs ; D-074) ; -- à l'étape 4 seulement, jamais avant : la base d'events, comme le dit `.claude/skills/read-event/SKILL.md` (`events/INDEX.md`, puis les fiches `event.md` qu'il cite et leurs figures). +- la base d'events, ta base de connaissance, quand tu veux, avant ta lecture comme pendant : comme le dit `.claude/skills/read-event/SKILL.md` (`events/INDEX.md`, puis les fiches `event.md` qu'il cite, leurs figures et leurs données). Un event connu est une piste à vérifier sur tes données, pas une conclusion (D-088). Rien d'autre : ni `CLAUDE.md`, ni `docs/decisions.md`, ni les plans, ni rien dans `vues-deplacements/` hors du dossier de station (pas de `parcours.md`, pas de `plateforme/`), ni les séances de `aiguiser/`, ni les critiques et bilans d'autres lots dans `boucle/`, ni le code des détecteurs. Ils contiennent des conclusions sur ces données ; ton jugement doit partir des données. Tu listes tout ce que tu as lu dans « Sources lues ». @@ -31,7 +31,7 @@ Ceux de `lire-les-donnees`, avec `--debut` et `--fin` du lot et `--sortie `), puis la seule section utile (Read avec `offset` et `limit`). -- `docs/decisions.md` (885 l, D-001 à D-087) : index par `grep -n '^## D-' docs/decisions.md`, puis l'entrée citée seulement ; son **Statut** dit si elle est remplacée. +- `docs/decisions.md` (892 l, D-001 à D-088) : index par `grep -n '^## D-' docs/decisions.md`, puis l'entrée citée seulement ; son **Statut** dit si elle est remplacée. - `data/` : explorer par script (`common.stations.load_stations`, outils de `agent-tools/`), jamais en affichant les CSV. - Ne pas lire : `docs/superpowers/` (historique, sauf le plan vivant et la spec du support), `out/`, `.venv/`, `graphify-out/`. diff --git a/docs/decisions.md b/docs/decisions.md index b5d5c1a..67fea63 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -864,7 +864,7 @@ Règles du journal : - **Conséquence** : vérifié après le déplacement : chaque détecteur et l'archive tournent sur C-001, les tests de `score.py`, `etiquettes.py` et `anonymiser.py` passent, le benchmark et le score sur les étiquettes de `boucle/` tournent, les pages Explore, détecteurs, fin de séance (NIEDERHORN), `voir.py` et `/revue-cas` (C-012 retrouve son lot dans `boucle/`) sont produites. ## D-085 — 2026-10-28 — Consulter la base de cas : le skill `read-event` -- **Statut** : active. Complète D-048 (§11 de `docs/agents/agent-diagnostic.md`). +- **Statut** : active. Complète D-048 (§11 de `docs/agents/agent-diagnostic.md`) ; le moment de l'analyste change par D-088. - **Décision** : la façon de consulter `events/` s'écrit une seule fois, dans le skill `read-event` : la carte des événements et l'index d'abord, puis la fiche des seuls cas proches (au plus 3 par phénomène), puis leurs données par les commandes de la signature et les outils de `lire-les-donnees` ; jamais toutes les fiches d'un coup, ni un CSV affiché, ni le registre des noms. L'en-tête d'`INDEX.md` y renvoie ; les consignes de l'agent de diagnostic (donc `/support`), de `critiquer-lot` et du builder le citent au lieu de redire la procédure. Le skill dit comment lire, pas quand : chaque consigne garde son moment (après les faits pour le diagnostic et l'analyste, D-058 ; jamais pour le lecteur de `/aiguiser`). Ceux qui écrivent l'index (`/nouveau-cas`, le builder, la revue) visent une Signature d'environ 250 caractères, une indication et non une limite, le détail dans la fiche. - **Pourquoi** : idée de l'utilisateur : un agent ne peut pas lire tous les cas, trop volumineux ; il lit un index sommaire, ouvre la fiche d'un cas qui l'intéresse, puis ses données s'il veut aller plus loin. La procédure existait (D-048) mais redite autrement dans chaque consigne, et l'index n'était plus sommaire : 13 lignes de 654 caractères en moyenne, quand la spec voulait une signature courte ; avec `/boucle` qui ajoute des cas, il deviendrait aussi lourd que ce qu'il devait éviter. - **Options écartées** : la procédure dans le seul en-tête d'`INDEX.md` (pas de chargement par sa description en conversation) ; un hook qui bloquerait la lecture d'une fiche sans l'index (mécanique lourde pour une règle de quelques lignes) ; une limite stricte de longueur de la Signature (refus de l'utilisateur : une longueur souhaitée suffit) ; filtre par script ou recherche vectorielle, déjà prévus pour quelques centaines de cas (§11.8 de la spec). @@ -882,4 +882,11 @@ Règles du journal : - **Décision** : la carte des événements (`events/carte-des-evenements.md`) apprend de chaque event validé ou corrigé par l'expert. À la validation (`/new-event`, `/review-event`), ce que l'event enseigne y entre, en termes généraux : l'event dans « Event / source » de son événement, un trait nouveau dans « Ce qu'on voit », ou une ligne de plus ; une ressemblance trompeuse dans une section 5, « Faux amis ». L'utilisateur le voit avec la fiche et le valide avec elle. Un event « (appris) » n'y entre qu'une fois revu ; le builder n'y touche pas. Rien d'autre ne change : fiches, index, `read-event`, le builder, et l'analyste, qui lit déjà la carte avant ses étiquettes. Rattrapage le 2026-10-29 : E-004, E-006, E-007, E-008, E-010, E-011 ; la carte ne cite plus E-009 (rejeté), ni E-011 comme cible mal configurée. - **Pourquoi** : l'analyste de `/boucle` doit progresser de séance en séance (l'utilisateur, 2026-10-28). Avant ses étiquettes, il ne lit que la carte, restée à E-005 : aucun processus ne la tenait. Les leçons des events validés dormaient dans le Diagnostic des fiches, lues après les étiquettes, et seulement si l'event ressemble au lot. - **Options écartées** : une compilation à part dans `events/` (idée de l'utilisateur, une « learning-map ») : une troisième description des mêmes events après la carte et l'index, à tenir à jour (choix de l'utilisateur, 2026-10-29) ; lire l'index et les fiches validées avant les étiquettes : la lecture grossit avec la base (D-085) ; nourrir la carte des events « (appris) » : l'analyste apprendrait ses propres erreurs ; une mise à jour en lot, plus tard (l'utilisateur : avec la fiche). -- **Conséquence** : « Target stuck » (`degradee`) a été fait pour E-011, que l'expert a validé depuis comme configuration voulue (`aucune`) : écart à trancher, noté dans la carte. La mesure des progrès de l'analyste (events témoins, question 2 du point 51) reste ouverte. +- **Conséquence** : « Target stuck » (`degradee`) a été fait pour E-011, que l'expert a validé depuis comme configuration voulue (`aucune`) : écart à trancher, noté dans la carte. La mesure des progrès de l'analyste (question 2 du point 51) : écartée, D-088. + +## D-088 — 2026-10-29 — L'analyste consulte la base d'events quand il veut +- **Statut** : active. Modifie D-085 pour l'analyste de `/boucle` ; l'agent de diagnostic garde son moment (après ses faits, D-048, D-058). +- **Décision** : la base d'events est la base de connaissance de l'analyste ; il la consulte quand il veut, avant sa lecture comme pendant, comme le dit le skill `read-event`. Un event connu est une piste à vérifier sur ses données, pas une conclusion. La section « Events connus » de sa critique reste : le builder s'en sert pour séparer les nouveautés de ce que la base connaît. +- **Pourquoi** : l'utilisateur, 2026-10-29 : l'ordre importe peu ; l'analyste doit simplement savoir qu'une base est à sa disposition et qu'il peut la consulter. Avec la carte qui apprend (D-087), c'est ce qui fait progresser son jugement. +- **Options écartées** : la base à l'étape 4 seulement, après les étiquettes (D-085) : ce qu'apprend la base n'atteignait jamais ses étiquettes ; mesurer ses progrès, par des events témoins étiquetés sans leur fiche ou par les verdicts de l'expert à `/review-event` (l'utilisateur, 2026-10-29 : on ne mesure pas). +- **Conséquence** : un risque, déjà nommé pour l'agent de diagnostic : chercher dans les données ce que dit l'event plutôt que ce qu'elles montrent ; d'où la règle de la piste à vérifier, et `read-event` qui fait vérifier chaque critère sur ses propres données. Un lot qui recouvre un event de la base y lit la réponse de l'expert : sans mal pour ses étiquettes. diff --git a/docs/superpowers/plans/2026-10-23-journal-du-matin.md b/docs/superpowers/plans/2026-10-23-journal-du-matin.md index 4c8149b..daa29d2 100644 --- a/docs/superpowers/plans/2026-10-23-journal-du-matin.md +++ b/docs/superpowers/plans/2026-10-23-journal-du-matin.md @@ -104,7 +104,7 @@ Types : **Comprendre** (lire, expliquer, rien ne change), **Décider** (l'utilis | 36 | Porter le journal dans la vraie application | Coder | 10 | en attente | | 49 | Le graphe des éventualités du terrain et deux catégories nouvelles | Décider, Coder | 5 | catégories (D-074) dans la carte, l'analyste et les détecteurs le 2026-10-27 ; à entraîner par `/boucle` | | 50 | Une ligne Status : la compilation de tous les détecteurs | Décider, Coder | 47, 49 | ligne Status dans `detecteurs.py` le 2026-10-27, refaite le même jour : ce qui se passe, l'événement qui englobe ; ordre des catégories à confirmer | -| 51 | Un analyste qui progresse de séance en séance | Décider | 45, 48 | idée du 2026-10-28 ; compilation dans `events/` (l'utilisateur), la carte apprend, montrée avec la fiche à chaque validation (D-087) ; rattrapage écrit, à relire ; mesure ouverte | +| 51 | Un analyste qui progresse de séance en séance | Décider | 45, 48 | idée du 2026-10-28 ; compilation dans `events/` (l'utilisateur), la carte apprend à chaque validation (D-087) ; l'analyste consulte la base quand il veut (D-088) ; pas de mesure ; écart E-011 ouvert | | | **VIII. Suivi du chantier** | | | | | 37 | Ménage : commit, `CLAUDE.md`, Mermaid, sorties | Lancer | — | validé le 2026-10-24 | @@ -1095,11 +1095,12 @@ Rapport de l'agent : `vues-deplacements/contexte/donnees-et-boucle.md`. Script : **Étapes.** - [x] La carte, mémoire de l'analyste (réponse à la question 1, 2026-10-29, D-087). - [x] L'étape carte dans `/review-event` (agent `revue` : « Ce que la carte apprendrait » à la présentation, écrit à la validation) et `/new-event` (2026-10-29). -- [ ] Le rattrapage de la carte (E-004, E-006, E-007, E-008, E-010, E-011, section 5 « Faux amis »), écrit le 2026-10-29 : relu par l'utilisateur. +- [x] Le rattrapage de la carte (E-004, E-006, E-007, E-008, E-010, E-011, section 5 « Faux amis »), validé par l'utilisateur le 2026-10-29. - [ ] L'écart « Target stuck » face à E-011 (configuration voulue, `aucune`). -- [ ] La mesure de l'analyste (question 2). +- [x] L'analyste consulte la base quand il veut, avant ou pendant sa lecture ; un event connu est une piste à vérifier (l'utilisateur, 2026-10-29, D-088). +- [x] La mesure de l'analyste (question 2) : écartée par l'utilisateur, 2026-10-29 (on ne mesure pas ses progrès ; proposées : events témoins, verdicts de `/review-event`). -**Fini quand.** D'une séance à l'autre, l'analyste profite de ce que l'utilisateur a validé ou corrigé, et on le mesure. +**Fini quand.** D'une séance à l'autre, l'analyste profite de ce que l'utilisateur a validé ou corrigé. --- @@ -1307,3 +1308,5 @@ Une ligne par séance : date, point(s) traités, ce qui a changé, ce qui reste. - 2026-10-29 : point 51, idée de l'utilisateur : une compilation de ce que les events enseignent, dans `events/` ; après la restructuration D-085, avis de Claude : pas de fichier de plus, la carte (arrêtée à E-005) apprend à chaque validation ; écart E-011 relevé dans la section 4 de la carte. - 2026-10-29 : point 51, l'utilisateur choisit la carte comme mémoire de l'analyste, pas de fichier à part. - 2026-10-29 : point 51, D-087 : la carte apprend à chaque validation, montrée avec la fiche ; étape ajoutée à `/review-event` et `/new-event` ; rattrapage écrit (E-004, E-006, E-007, E-008, E-010, E-011, « Faux amis »), E-009 rejeté retiré de la carte ; à relire par l'utilisateur. +- 2026-10-29 : point 51, l'utilisateur : la base d'events est la base de connaissance de l'analyste, consultée quand il veut (D-088) ; rattrapage de la carte validé. +- 2026-10-29 : point 51, l'utilisateur : on ne mesure pas les progrès de l'analyste.