Record the reading sharpening decision (D-059)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
03c50f74aa
commit
e5c03b1d4a
9 files changed
+481
-4
No files matched your search
@@ -90,6 +90,7 @@ Types : **Comprendre** (lire, expliquer, rien ne change), **Décider** (l'utilis
|
||||
| 30 | L'outil de tri en lot | Coder | 6, 27 | validé le 2026-10-24 |
|
||||
| 31 | La boucle Claude, première séance | Lancer, Coder | 30 | construite (D-057), fonctionnement validé le 2026-10-24 ; séance par l'utilisateur, plus tard |
|
||||
| 32 | Le test « Claude verrait la même chose » | Lancer | 10 | en attente (autre conversation) |
|
||||
| 42 | Aiguiser la lecture : les outils de lecture de Claude | Décider, Coder | 31 | construit (D-059), essai fait le 2026-10-24 ; séance par l'utilisateur |
|
||||
| | **VII. Idées gardées pour plus tard** | | | |
|
||||
| 33 | Les autres métriques de certains projets | Comprendre | 27 | en attente |
|
||||
| 34 | Météo et HDF5 pour dire la cause | Comprendre | 27 | en attente |
|
||||
@@ -846,6 +847,22 @@ Rapport de l'agent : `vues-deplacements/contexte/donnees-et-boucle.md`. Script :
|
||||
|
||||
**En attente depuis le 2026-10-24** : l'utilisateur le traitera dans une autre conversation.
|
||||
|
||||
### Point 42 : Aiguiser la lecture : les outils de lecture de Claude
|
||||
|
||||
**Pourquoi** (l'utilisateur, 2026-10-24). L'analyste et l'agent de diagnostic jugent à partir des données ; pour bien juger, il faut bien lire. La lecture n'est pas le diagnostic : s'ils lisaient avec les détecteurs, ils seraient biaisés et tendraient à les valider. Un autre processus automatique, à part de `/boucle`, ne travaille que sur les outils de lecture, lot après lot, pour « aiguiser la vision de Claude ».
|
||||
|
||||
**Le principe** (brainstorming du 2026-10-24, accepté par l'utilisateur) : un skill de lecture, `lire-les-donnees`, seule source des outils et de leur mode d'emploi, suivi par l'analyste, l'agent de diagnostic et un **lecteur** ; un **correcteur** lit chaque lot à fond avec ses propres scripts, sans ces outils, et cette lecture lente sert de corrigé ; un **optimiseur** modifie le skill d'après l'écart ; un changement sans gain est annulé ; contrôle sur C-001 à C-005 en fin de séance ; `/aiguiser <dossier>`, lancé par l'utilisateur seul.
|
||||
|
||||
**Étapes.**
|
||||
- [x] Conception écrite : `vues-deplacements/contexte/aiguiser-la-lecture.md`.
|
||||
- [x] Approbation de la conception par l'utilisateur (2026-10-24).
|
||||
- [x] Plan de construction : `docs/superpowers/plans/2026-10-24-aiguiser-la-lecture.md` (6 tâches).
|
||||
- [x] Construction (tâches 1 à 5 du plan, D-059) : skill `lire-les-donnees`, agents `lecteur`, `correcteur`, `optimiseur`, skill `/aiguiser`, avec le releveur (D-060).
|
||||
- [x] Essai (2026-10-24) : lecteur et correcteur sur le lot 1 de NORDEND d'octobre, sans l'optimiseur ; écart `à reprendre`, deux défauts (positions brutes devant une vague commune ; chaque capteur face à lui-même) ; ~210 000 et ~136 000 jetons ; détail au §9 de la spec.
|
||||
- [ ] Première séance, **par l'utilisateur seul**, dans une session neuve : `/aiguiser <dossier> [--du … --au …]` ; Claude ne la lance pas (tâche 6 du plan).
|
||||
|
||||
**Fini quand.** `/aiguiser` est construit et son essai montré à l'utilisateur ; les séances, il les lance lui-même.
|
||||
|
||||
---
|
||||
|
||||
## Partie VII — Idées gardées pour plus tard
|
||||
@@ -991,3 +1008,6 @@ Une ligne par séance : date, point(s) traités, ce qui a changé, ce qui reste.
|
||||
- 2026-10-24 : point 31 : conception approuvée par l'utilisateur (agent de diagnostic hors de la boucle, cas appris dans la base commune) ; plan de construction écrit, `docs/superpowers/plans/2026-10-24-boucle-automatique.md`.
|
||||
- 2026-10-24 : point 31 : boucle construite (tâches 1 à 6 du plan `2026-10-24-boucle-automatique.md`, D-057) ; reste la première séance sur NORDEND d'octobre, lancée par l'utilisateur.
|
||||
- 2026-10-24 : point 31 : essai de l'analyste sur le lot 1 de NORDEND ; **fonctionnement de la boucle validé** par l'utilisateur ; il lancera lui-même les séances, lot par lot, sur de nouvelles données ; travail commité.
|
||||
- 2026-10-24 : point 42 ajouté (aiguiser la lecture : un skill de lecture, un lecteur, un correcteur qui lit à fond sans les outils, un optimiseur) ; conception écrite dans `vues-deplacements/contexte/aiguiser-la-lecture.md`, à approuver.
|
||||
- 2026-10-24 : point 42 : conception approuvée par l'utilisateur ; plan de construction écrit, `docs/superpowers/plans/2026-10-24-aiguiser-la-lecture.md` (6 tâches) ; rien construit.
|
||||
- 2026-10-24 : point 42 : `/aiguiser` construit (D-059), avec le releveur (D-060) ; essai du lecteur et du correcteur sur le lot 1 de NORDEND : écart « à reprendre », deux défauts ; reste la première séance, par l'utilisateur.
|
||||
@@ -0,0 +1,268 @@
|
||||
# Aiguiser la lecture : plan de construction
|
||||
|
||||
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
||||
|
||||
**Goal :** une commande `/aiguiser <dossier de station>` qui, lot après lot, fait lire les données par un lecteur avec le skill de lecture, les fait lire à fond par un correcteur qui sert de corrigé, fait modifier le skill par un optimiseur d'après l'écart et annule tout changement sans gain, puis contrôle le skill sur les cas validés ; chaque étape commitée.
|
||||
|
||||
**Architecture :** un skill de lecture partagé (`.claude/skills/lire-les-donnees/`), seule source du mode d'emploi des outils de `agents/diagnostic/outils/`, suivi par l'analyste, l'agent de diagnostic et le lecteur ; un skill orchestrateur (`.claude/skills/aiguiser/`) lancé dans la conversation principale ; trois sous-agents (`lecteur`, `correcteur`, `optimiseur`) qui ne se parlent pas : chacun écrit son rendu dans le dossier du lot, l'orchestrateur transmet et commite. Tout est en Markdown (des consignes) ; aucun code nouveau.
|
||||
|
||||
**Tech Stack :** Claude Code (skills, sous-agents Opus), git ; outils existants : `agents/diagnostic/outils/`, `vues-deplacements/journal/categories.py` (découpe des lots seulement).
|
||||
|
||||
**Spec :** `vues-deplacements/contexte/aiguiser-la-lecture.md` (approuvée le 2026-10-24). Point 42 du plan vivant `docs/superpowers/plans/2026-10-23-journal-du-matin.md`. Modèle suivi : `/boucle` (`.claude/skills/boucle/SKILL.md`, plan `docs/superpowers/plans/2026-10-24-boucle-automatique.md`).
|
||||
|
||||
## Global Constraints
|
||||
|
||||
- Documents et consignes en français ; heures en UTC, instants au format `2026-10-05T00:00Z`.
|
||||
- Agents sur Opus (`model: opus`, `effort: high`), `omitClaudeMd: true`.
|
||||
- Lots de 4 jours par défaut, même découpe que `/boucle` (§2 de son skill).
|
||||
- Correcteur : au plus **deux** défauts par écart. Optimiseur : au plus **trois** passages par lot. Comparaison `pareil` ou `moins bien` : le passage est annulé.
|
||||
- Outils de lecture : bibliothèque standard, matplotlib par `.venv` pour les figures seulement ; **aucun jugement** dans ce qu'ils rendent (ni seuil, ni catégorie, ni « anomalie ») ; rien de propre à une station, un capteur ou une date ; aucun import de `vues-deplacements/journal/` ; options et sorties existantes gardées : les 44 commandes citées par les fiches C-001 à C-005 passent toutes aujourd'hui (vérifié le 2026-10-24) et doivent toujours passer. **Commandes des fiches**, toutes (pour un seul outil, mettre son nom de fichier juste après `outils/` dans le motif) :
|
||||
|
||||
```bash
|
||||
grep -oh '`[^`]*agents/diagnostic/outils/[^`]*`' agents/diagnostic/cas/*/cas.md | tr -d '`' | while read -r c; do eval "$c" >/dev/null 2>&1 || echo "ÉCHEC $c"; done
|
||||
```
|
||||
- Le correcteur n'utilise jamais `agents/diagnostic/outils/` (pas même `donnees.py`) ni `lire-les-donnees/SKILL.md`, et écrit son corrigé avant d'ouvrir une lecture.
|
||||
- Le lecteur ne lit que le skill et ce qu'il cite ; jamais un corrigé, un écart, une modification, une fiche de cas, les détecteurs.
|
||||
- Aucun cas ajouté ; les cas de `agents/diagnostic/cas/` ne se modifient jamais.
|
||||
- Le raisonnement de l'agent de diagnostic et les étapes 2 à 6 de `critiquer-lot` ne changent pas : seul leur mode d'emploi de lecture passe dans le skill.
|
||||
- Tout se commite par chemin (`git commit -- <chemins>`), message `Sharpen <STATION> …` terminé par une ligne vide puis `Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>`.
|
||||
- Pas de tests automatiques (D-008) ; on vérifie en lançant (consigne « processus léger »).
|
||||
- Identifiants (`SIM_CCID`, `ip`) jamais recopiés ; pas de données synthétiques.
|
||||
|
||||
## Review Focus
|
||||
|
||||
1. **Annulation qui laisse un nouvel outil** : `git checkout <base> -- <dossier>` ne supprime pas un fichier créé après la base (vérifié le 2026-10-24). Attendu : l'orchestrateur annule par `git restore --source=<base> --staged --worktree -- <chemins>`, qui le supprime (tâche 4, étape 2).
|
||||
2. **Fiche ou figures d'un cas lues comme données** : `donnees.py` range tout `.png` d'un dossier parmi les images de la caméra, et le dossier d'un cas a sa fiche et ses figures à la racine. Attendu : au contrôle, le lecteur lit un dossier de liens vers `displacement/` et `images/` seulement, hors du suivi git, dans `out/` (tâche 4, étape 2 ; `inventaire.py` lit un tel dossier, vérifié le 2026-10-24).
|
||||
3. **Figures écrasées d'une lecture à l'autre** : les outils nomment leurs PNG d'après les capteurs, les colonnes et les dates ; deux lectures du même lot donneraient les mêmes noms. Attendu : chaque lecture range ses figures dans son propre dossier, `lecture-K/`, et le correcteur dans `corrige/` (tâches 2 et 3).
|
||||
4. **Agents créés en cours de session** : Claude Code charge `.claude/agents/` au démarrage. Attendu : les essais passent par un sous-agent `general-purpose` qui lit le fichier de l'agent ; la séance se lance dans une session neuve (tâche 6).
|
||||
5. **Correcteur qui retombe sur les outils** : un script du correcteur qui importe `donnees.py` ou appelle un outil. Attendu : `grep -rlE 'agents/diagnostic/outils|donnees' <lot>/corrige/` ne rend rien (tâche 3, essai).
|
||||
|
||||
---
|
||||
|
||||
### Task 1 : Le skill de lecture et ses deux utilisateurs
|
||||
|
||||
**Files :**
|
||||
- Create : `.claude/skills/lire-les-donnees/SKILL.md`
|
||||
- Modify : `.claude/skills/critiquer-lot/SKILL.md` (« Ce que tu as le droit de lire », « Tes outils », étape 1)
|
||||
- Modify : `agents/diagnostic/instructions.md` (§2, §3, §4 étape 2)
|
||||
|
||||
**Interfaces :**
|
||||
- Produces : `.claude/skills/lire-les-donnees/SKILL.md`, lu par Read par l'analyste, l'agent de diagnostic, le lecteur (tâche 2) ; modifié par l'optimiseur (tâche 3). Il définit le tableau des moments : `| Début | Fin | Capteurs | Colonnes | Ce que je vois | Images |`.
|
||||
|
||||
- [x] **Step 1 : Écrire `.claude/skills/lire-les-donnees/SKILL.md`**
|
||||
|
||||
Frontmatter : `name: lire-les-donnees`, `description:` (lire un dossier de données de déplacement d'une station AIMsight, courbes et images, avec les outils de lecture : ce qu'ils rendent et comment s'en servir ; suivi par l'analyste, l'agent de diagnostic et le lecteur de `/aiguiser` ; amélioré par `/aiguiser`). Corps, dans cet ordre, repris des textes actuels sans rien perdre :
|
||||
- **À lire d'abord** : `docs/domaine/colonnes-des-deplacements.md` (en premier), `docs/domaine/pieges-des-donnees.md`.
|
||||
- **Les outils** : le tableau du §3 de `agents/diagnostic/instructions.md`, sans la ligne `categories.py` (un détecteur, pas un outil de lecture) ; `--sortie <dossier>` : là où celui qui t'appelle range tes figures ; « Ils rendent des valeurs, jamais des verdicts : c'est toi qui juges. »
|
||||
- **Conventions** : les instants (`2026-01-01T00:00Z`, heure sans fuseau lue en UTC, `--fin` inclusive) ; Bash pour lancer ces outils, `ls`, `grep` et `date`, une commande par appel, sans boucle `for` (un tube vers `grep` est permis) ; aucun autre script ; chaque PNG regardé avec Read.
|
||||
- **La méthode** : inventaire ; large puis zoom (`graphique.py` sur tous les capteurs, puis `resume.py` sur `error_value`, `corr_x`, `corr_y` à pas large, 6h ou 1d, puis 1h ou 15min sur les fenêtres qui bougent) ; chaque capteur face à son propre niveau habituel (médiane, MAD), jamais à un seuil absolu ; vignettes espacées (une toutes les 2 à 3 h), plus serrées là où les courbes bougent, toujours avec un capteur témoin non touché ; images entières pour la scène (occultation, éclairage, météo).
|
||||
- **Ce que la lecture rend** : une ligne par moment du tableau des moments ci-dessus ; un moment, c'est un capteur ou un groupe qui sort de son niveau habituel pendant une fenêtre datée ; pas de catégorie, de cas, d'hypothèse ni de verdict : c'est l'affaire de celui qui t'appelle.
|
||||
|
||||
- [x] **Step 2 : `critiquer-lot` renvoie au skill**
|
||||
|
||||
« Ce que tu as le droit de lire » : ajouter `.claude/skills/lire-les-donnees/SKILL.md` (le premier) ; ses deux notes de `docs/domaine/` y sont déjà. « Tes outils » : remplacer le tableau par « Ceux de `lire-les-donnees`, avec `--debut`/`--fin` du lot et `--sortie <dossier de sortie>` ; Bash sert aussi à lancer la commande du lot. » Étape 1 : « Lis le lot comme le dit `lire-les-donnees` ; à chaque moment de son tableau, ajoute la catégorie de la carte qui conviendrait, ou « aucune catégorie ». » Le plan du fichier (`## 1. Ma lecture`) prend les colonnes du tableau des moments, plus `Catégorie`.
|
||||
|
||||
- [x] **Step 3 : les instructions de l'agent de diagnostic renvoient au skill**
|
||||
|
||||
§2 : ajouter `.claude/skills/lire-les-donnees/SKILL.md` en tête de la liste. §3 : remplacer le tableau par « Ceux de `lire-les-donnees` (lis-le avant tout), plus : » suivi de la seule ligne `categories.py` du tableau actuel ; garder tels quels le paragraphe sur `--sortie` (brouillon `out/diagnostic/`, preuves du rapport) et la règle Bash, qui ajoute `pdftotext`. §4, étape 2 : remplacer les deux puces d'outils (`graphique.py` … ; compare chaque capteur …) par « lis la période comme le dit `lire-les-donnees` » ; garder la puce `categories.py` et celle du seuil de repérage. Rien d'autre ne change.
|
||||
|
||||
- [x] **Step 4 : Vérifier**
|
||||
|
||||
Run : `grep -rln 'outils/resume.py <dossier>' .claude/ agents/diagnostic/instructions.md`
|
||||
Expected : `.claude/skills/lire-les-donnees/SKILL.md` seul.
|
||||
Run : `grep -n 'lire-les-donnees' .claude/skills/critiquer-lot/SKILL.md agents/diagnostic/instructions.md`
|
||||
Expected : au moins deux lignes dans chaque fichier.
|
||||
|
||||
- [x] **Step 5 : Commit**
|
||||
|
||||
```bash
|
||||
git add .claude/skills/lire-les-donnees/SKILL.md .claude/skills/critiquer-lot/SKILL.md agents/diagnostic/instructions.md
|
||||
git commit -m "Move the reading method into a shared lire-les-donnees skill" -- .claude/skills/lire-les-donnees/SKILL.md .claude/skills/critiquer-lot/SKILL.md agents/diagnostic/instructions.md
|
||||
```
|
||||
|
||||
### Task 2 : Le lecteur
|
||||
|
||||
**Files :**
|
||||
- Create : `.claude/agents/lecteur.md`
|
||||
|
||||
**Interfaces :**
|
||||
- Consumes : `lire-les-donnees/SKILL.md` (tâche 1).
|
||||
- Produces : la demande `Dossier : <dossier>. Lot NN : <début> → <fin> (UTC). Écris <lot>/lecture-K.md, figures dans <lot>/lecture-K/.` ; au contrôle : `Dossier : <dossier de liens>. Toute la période. Écris <séance>/controle/C-xxx/lecture.md, figures dans <séance>/controle/C-xxx/lecture/.` Le rendu :
|
||||
|
||||
```markdown
|
||||
# Lecture K : lot NN, <STATION>, <début> → <fin> (UTC)
|
||||
|
||||
## Moments
|
||||
| Début | Fin | Capteurs | Colonnes | Ce que je vois | Images |
|
||||
|
||||
## Ce qui m'a manqué
|
||||
<où j'ai peiné ; ce que j'aurais voulu pouvoir regarder ; « rien »>
|
||||
|
||||
## Sources lues
|
||||
```
|
||||
|
||||
- [x] **Step 1 : Écrire `.claude/agents/lecteur.md`**
|
||||
|
||||
Frontmatter : `name: lecteur`, `description:` (lecteur de `/aiguiser` : lit un lot de données de déplacement avec le seul skill de lecture ; appelé avec un dossier, un lot et le chemin de sa lecture), `tools: Read, Bash, Write`, `model: opus`, `effort: high`, `omitClaudeMd: true`. Corps : lis `.claude/skills/lire-les-donnees/SKILL.md` et suis-le ; le dossier par les outils du skill, ses images par Read, les notes que le skill cite, rien d'autre ; la liste de ce qu'il ne lit pas (spec, §6 « Lecteur »), dont les autres fichiers du dossier du lot ; aucun script ; le plan du rendu ci-dessus ; « Ce qui m'a manqué » est franc et concret ; réponse en 2 lignes : nombre de moments, chemin.
|
||||
|
||||
- [x] **Step 2 : Essai sur le lot 1 de NORDEND d'octobre**
|
||||
|
||||
Sous-agent `general-purpose` (l'agent `lecteur` n'est pas encore chargé ; il charge `CLAUDE.md`, ce que « Sources lues » doit signaler) : `Lis .claude/agents/lecteur.md (sans son frontmatter) et suis-le. Dossier : vues-deplacements/cas/2026-10_NORDEND/NORDEND/. Lot 01 : 2026-10-05T00:00Z → 2026-10-09T00:00Z (UTC). Écris out/aiguiser-essai/lot-01/lecture-1.md, figures dans out/aiguiser-essai/lot-01/lecture-1/.`
|
||||
Expected : les trois titres du rendu ; au moins un PNG dans `lecture-1/` ; « Sources lues » sans `parcours.md`, ni `categories.py`, ni `agents/diagnostic/cas/`. Noter le nombre d'appels d'outils, les jetons et la durée. Corriger l'agent si un attendu manque, puis relancer une fois.
|
||||
|
||||
- [x] **Step 3 : Commit**
|
||||
|
||||
```bash
|
||||
git add .claude/agents/lecteur.md
|
||||
git commit -m "Add the /aiguiser reader agent" -- .claude/agents/lecteur.md
|
||||
```
|
||||
|
||||
### Task 3 : Le correcteur et l'optimiseur
|
||||
|
||||
**Files :**
|
||||
- Create : `.claude/agents/correcteur.md`
|
||||
- Create : `.claude/agents/optimiseur.md`
|
||||
|
||||
**Interfaces :**
|
||||
- Consumes : le tableau des moments (tâche 1), `lecture-K.md` (tâche 2).
|
||||
- Produces, correcteur, trois demandes :
|
||||
- `Lecture lente. Dossier : <dossier>. Lot NN : <début> → <fin> (UTC). Écris <lot>/corrige.md, scripts et figures dans <lot>/corrige/ ; puis, après seulement, lis <lot>/lecture-1.md et écris <lot>/ecart-1.md.`
|
||||
- `Écart seul. Dossier : <dossier>. Lot NN : … Corrigé : <lot>/corrige.md. Lecture : <lot>/lecture-J.md. Écart de référence : <lot>/ecart-I.md. Écris <lot>/ecart-J.md.`
|
||||
- `Contrôle. Fiche : agents/diagnostic/cas/C-xxx/cas.md. Lecture : <séance>/controle/C-xxx/lecture.md. Écris <séance>/controle/C-xxx/ecart.md.`
|
||||
- `ecart-J.md` au plan de la spec (§6, « Correcteur ») : `**Verdict** : rien à reprendre | à reprendre` ; à partir de J = 2, la ligne `**Par rapport à la lecture précédente** : mieux | pareil | moins bien` (précédente = celle de l'écart de référence), motivée en une ligne dessous ; `## Moments`, `## Défauts à corriger` (`### D1 : …`, au plus deux), `## Nouveautés`, `## Sources lues`. Au contrôle : `**Verdict** : retrouvé | manqué`, puis `## Critères` (un par critère de la signature : retrouvé, manqué, de travers ; faute ; pourquoi), `## Défauts à corriger`, `## Sources lues`.
|
||||
- Produces, optimiseur : la demande `Dossier : <dossier>. Lot NN : … Écart : <lot>/ecart-I.md. [Modification annulée : <lot>/modification-L.md.] Passage K. Écris <lot>/modification-K.md.` ; le rendu : `## Défaut traité`, `## Ce qui a changé` (fichiers, et pourquoi), `## Essai` (commande, ce qu'elle rend), `## Commandes des fiches relancées`, `## Pas fait`.
|
||||
|
||||
- [x] **Step 1 : Écrire `.claude/agents/correcteur.md`**
|
||||
|
||||
Frontmatter : `name: correcteur`, `description:` (correcteur de `/aiguiser` : lit un lot à fond avec ses propres scripts pour en faire le corrigé, puis juge l'écart d'une lecture faite avec le skill ; appelé avec une des trois demandes), `tools: Read, Bash, Write`, `model: opus`, `effort: high`, `omitClaudeMd: true`. Corps : la section « Correcteur » de la spec, les trois demandes ci-dessus, et :
|
||||
- lecture lente : ses scripts lisent les exports « advanced » eux-mêmes (`csv` de la bibliothèque standard, colonnes dans `docs/domaine/colonnes-des-deplacements.md`), figures par `.venv/bin/python` ; il peut lire `docs/domaine/` et `docs/displacement/domaine/carte-des-evenements.md` ; il ne lit ni n'utilise `agents/diagnostic/outils/`, `lire-les-donnees/SKILL.md`, `vues-deplacements/journal/`, `agents/diagnostic/cas/`, ni aucune lecture avant d'avoir écrit `corrige.md` ; `corrige.md` a le tableau des moments ;
|
||||
- la faute : outil, mode d'emploi, lecteur (définitions de la spec) ; seules les deux premières font un défaut ; un défaut est une règle générale, en mots, jamais propre à une station, un capteur ou une date ;
|
||||
- écart seul : il peut revenir aux données pour trancher, et corriger `corrige.md` s'il s'était trompé, en le disant dans l'écart ;
|
||||
- réponse en 2 lignes : verdict (et comparaison), chemin.
|
||||
|
||||
- [x] **Step 2 : Écrire `.claude/agents/optimiseur.md`**
|
||||
|
||||
Frontmatter : `name: optimiseur`, `description:` (optimiseur de `/aiguiser` : modifie les outils de lecture et le skill `lire-les-donnees` d'après l'écart du correcteur ; appelé avec un dossier, un lot, un écart et le numéro du passage), `tools: Read, Edit, Write, Bash`, `model: opus`, `effort: high`, `omitClaudeMd: true`. Corps : la section « Optimiseur » de la spec (ce qu'il lit, ce qu'il touche, le plus simple d'abord, interdits), et :
|
||||
- une modification annulée qu'on lui passe : essayer autre chose ;
|
||||
- il relance l'outil modifié sur le lot (`--debut`/`--fin` du lot, `--sortie <lot>/modification-K/`), et les commandes des fiches qui l'emploient (bloc « Commandes des fiches » des Global Constraints, recopié dans l'agent, pour son outil) : aucune ligne `ÉCHEC` ;
|
||||
- un outil nouveau ou une option nouvelle entre dans le tableau du skill dans le même passage ;
|
||||
- réponse en 2 lignes : ce qui a changé, chemin.
|
||||
|
||||
- [x] **Step 3 : Essai du correcteur sur la lecture de la tâche 2**
|
||||
|
||||
Sous-agent `general-purpose` : `Lis .claude/agents/correcteur.md (sans son frontmatter) et suis-le. Lecture lente. Dossier : vues-deplacements/cas/2026-10_NORDEND/NORDEND/. Lot 01 : 2026-10-05T00:00Z → 2026-10-09T00:00Z (UTC). Écris out/aiguiser-essai/lot-01/corrige.md, scripts et figures dans out/aiguiser-essai/lot-01/corrige/ ; puis, après seulement, lis out/aiguiser-essai/lot-01/lecture-1.md et écris out/aiguiser-essai/lot-01/ecart-1.md.`
|
||||
Expected : `grep -c '^\*\*Verdict\*\* : \(rien à reprendre\|à reprendre\)$' out/aiguiser-essai/lot-01/ecart-1.md` rend `1` ; `grep -rlE 'agents/diagnostic/outils|donnees' out/aiguiser-essai/lot-01/corrige/` ne rend rien ; la buée du 07/10 17:15 → 08/10 12:15 (vérité du point 30) est dans `corrige.md`. Noter appels, jetons, durée. Corriger l'agent si un attendu manque, puis relancer une fois.
|
||||
|
||||
- [x] **Step 4 : Montrer l'essai à l'utilisateur**
|
||||
|
||||
L'écart (moments manqués, fautes, défauts) et le coût des deux agents, en quelques lignes. L'optimiseur n'est pas essayé (spec, §9).
|
||||
|
||||
- [x] **Step 5 : Commit**
|
||||
|
||||
```bash
|
||||
git add .claude/agents/correcteur.md .claude/agents/optimiseur.md
|
||||
git commit -m "Add the /aiguiser corrector and optimiser agents" -- .claude/agents/correcteur.md .claude/agents/optimiseur.md
|
||||
```
|
||||
|
||||
### Task 4 : L'orchestrateur `/aiguiser`
|
||||
|
||||
**Files :**
|
||||
- Create : `.claude/skills/aiguiser/SKILL.md`
|
||||
|
||||
**Interfaces :**
|
||||
- Consumes : les demandes et rendus des tâches 2 et 3, leurs lignes `**Verdict** :` et `**Par rapport à la lecture précédente** :`.
|
||||
- Produces : la branche `aiguiser/<SEANCE>_<STATION>` (`SEANCE` = `date -u +%Y-%m-%dT%H%MZ`, `STATION` = nom du dossier), le dossier `vues-deplacements/aiguiser/<SEANCE>_<STATION>/` (ci-dessous `<séance>`), un `lot-NN/` par lot (ci-dessous `<lot>`), `controle/`, `bilan.md`.
|
||||
|
||||
- [x] **Step 1 : Écrire `.claude/skills/aiguiser/SKILL.md`**
|
||||
|
||||
Frontmatter : `name: aiguiser`, `description:` (séance automatique d'amélioration des outils de lecture et du skill `lire-les-donnees`, lot après lot, sur une station ; lecteur, correcteur, optimiseur), `disable-model-invocation: true`, `argument-hint: "<dossier de station> [--du AAAA-MM-JJ] [--au AAAA-MM-JJ] [--lot 4]"`. Corps, sur le plan de `.claude/skills/boucle/SKILL.md` (tu ne juges rien, tu ne poses aucune question, tu ne lis que les lignes de verdict) :
|
||||
1. **Mise en place** : comme `/boucle` §1, branche `aiguiser/…`, dossier `<séance>`.
|
||||
2. **Lots** : `python3 vues-deplacements/journal/categories.py <dossier> --tranche <lot> [--du …] [--au …] | grep '^=='` (les en-têtes seuls : l'orchestrateur ne voit pas les événements) ; un en-tête = un lot, `01`, `02`…
|
||||
3. **Par lot** (les demandes exactes des Interfaces des tâches 2 et 3 ; verdicts par `grep '^\*\*Verdict\*\* :'` et `grep '^\*\*Par rapport'`) :
|
||||
- lecteur → `lecture-1.md` ; commit `<lot>/`, `Sharpen <STATION> lot NN: lecture 1` ;
|
||||
- correcteur, lecture lente → `corrige.md`, `ecart-1.md` ; commit `<lot>/`, `Sharpen <STATION> lot NN: corrigé, écart 1 (<verdict>)` ; `REF` = 1 ;
|
||||
- `rien à reprendre` : lot suivant ;
|
||||
- passage K = 1 à 3 : `BASE` = `git rev-parse HEAD` ; optimiseur (Écart : `ecart-REF.md` ; Modification annulée : celle du passage K − 1, s'il a été annulé) ; commit `agents/diagnostic/outils/ .claude/skills/lire-les-donnees/ <lot>/`, `Sharpen <STATION> lot NN: modification K` ; lecteur → `lecture-J.md`, J = K + 1, commit `<lot>/`, `Sharpen <STATION> lot NN: lecture J` ; correcteur, écart seul (Lecture `lecture-J.md`, Écart de référence `ecart-REF.md`) → `ecart-J.md`, commit `Sharpen <STATION> lot NN: écart J (<verdict>, <comparaison>)` ;
|
||||
- `mieux` : `REF` = J ; si `rien à reprendre`, lot suivant ;
|
||||
- `pareil` ou `moins bien` : `git restore --source=<BASE> --staged --worktree -- agents/diagnostic/outils/ .claude/skills/lire-les-donnees/`, commit de ces deux chemins, `Sharpen <STATION> lot NN: modification K annulée` ;
|
||||
- après le passage 3 : lot suivant.
|
||||
4. **Contrôle**, après le dernier lot : les cas validés, `grep '^| \[C-' agents/diagnostic/cas/INDEX.md | grep -v '| (appris)'` ; pour chacun, un dossier de liens `out/aiguiser/<SEANCE>/C-xxx/` avec `ln -s "$PWD/agents/diagnostic/cas/C-xxx/displacement"` et de même `images` ; lecteur puis correcteur (demandes de contrôle) ; puis toutes les commandes des fiches (bloc des Global Constraints, recopié dans le skill), les lignes `ÉCHEC` notées pour le bilan ; commit `<séance>/controle/`, `Sharpen <STATION>: contrôle (<n> retrouvés sur <m>)`.
|
||||
5. **Imprévus** : un rendu absent ou sans verdict lisible : le noter ; si les outils ou le skill ont changé depuis `BASE`, les remettre comme pour une annulation ; lot suivant. Un agent n'est relancé qu'une fois.
|
||||
6. **Bilan**, `<séance>/bilan.md` :
|
||||
|
||||
```markdown
|
||||
# Séance <SEANCE> : <STATION>, <début> → <fin> (UTC)
|
||||
|
||||
Branche : aiguiser/<SEANCE>_<STATION>
|
||||
|
||||
| Lot | Dates (UTC) | Premier écart | Passages | Dernier écart gardé |
|
||||
|---|---|---|---|---|
|
||||
| 01 | … → … | rien à reprendre / à reprendre | aucun / n gardés, m annulés / erreur | rien à reprendre / à reprendre |
|
||||
|
||||
## Contrôle
|
||||
| Cas | Verdict | Critères manqués |
|
||||
Commandes des fiches : <n> en échec sur <m> <et lesquelles>
|
||||
|
||||
## Défauts non traités
|
||||
<défauts du dernier écart gardé des lots restés « à reprendre »>
|
||||
|
||||
## Manques imputés au lecteur
|
||||
|
||||
## Nouveautés (pour /boucle ou /nouveau-cas)
|
||||
|
||||
## Erreurs
|
||||
aucune | <lot, agent, ce qui manquait>
|
||||
```
|
||||
|
||||
commit `<séance>/bilan.md`, `Sharpen <STATION>: bilan`.
|
||||
7. **Réponse finale** en 5 lignes au plus : la branche, le bilan, les passages gardés et annulés, le contrôle ; rester sur la branche.
|
||||
|
||||
- [x] **Step 2 : Vérifier les mécanismes**
|
||||
|
||||
Run : `python3 vues-deplacements/journal/categories.py vues-deplacements/cas/2026-10_NORDEND/NORDEND/ --tranche 4 | grep '^=='` ; Expected : trois lots, comme pour `/boucle`.
|
||||
Run : `grep '^| \[C-' agents/diagnostic/cas/INDEX.md | grep -vc '| (appris)'` ; Expected : `5`.
|
||||
Run : les commandes des fiches (Global Constraints) ; Expected : aucune ligne `ÉCHEC`.
|
||||
Dans un dépôt git jetable du dossier de travail temporaire : un fichier ajouté après `BASE` disparaît avec la commande d'annulation de l'étape 1.3.
|
||||
|
||||
- [x] **Step 3 : Commit**
|
||||
|
||||
```bash
|
||||
git add .claude/skills/aiguiser/SKILL.md
|
||||
git commit -m "Add the /aiguiser orchestrator skill" -- .claude/skills/aiguiser/SKILL.md
|
||||
```
|
||||
|
||||
### Task 5 : Décision et cartes du dépôt
|
||||
|
||||
**Files :**
|
||||
- Modify : `docs/decisions.md` (ajout en fin : D-059)
|
||||
- Modify : `CLAUDE.md` (199 lignes : pas de ligne nouvelle ; puces « Agent de diagnostic » et `.claude/`)
|
||||
- Modify : `vues-deplacements/CLAUDE.md` (un paragraphe)
|
||||
- Modify : `vues-deplacements/contexte/boucle-automatique.md` (§3, puce des outils de lecture)
|
||||
- Modify : `docs/agents/agent-diagnostic.md` (arbre des fichiers : le skill de lecture)
|
||||
- Modify : `vues-deplacements/contexte/aiguiser-la-lecture.md` (statut : construite)
|
||||
- Modify : `docs/superpowers/plans/2026-10-23-journal-du-matin.md` (point 42 : étapes, index, journal)
|
||||
|
||||
- [x] **Step 1 : Écrire D-059** au format de D-057 (`## D-059 — 2026-10-24 — Déplacements : aiguiser la lecture de Claude`, Statut, Décision, Pourquoi, Options écartées, Conséquence) : le skill `lire-les-donnees`, seule source du mode d'emploi des outils, suivi par l'analyste et l'agent de diagnostic ; `/aiguiser` (lecteur, correcteur à lecture lente, optimiseur ; changement sans gain annulé ; contrôle sur les cas validés en fin de séance) ; aucun cas ajouté. Options écartées : n'entraîner que sur les cinq cas (outils taillés pour eux) ; donner les détecteurs à l'analyste pour lire (biais) ; le contrôle sur les cas après chaque modification (trop cher). Conséquence : les instructions de l'agent de diagnostic renvoient au skill (complète D-058, dont « ses outils propres » passent en partie par `/aiguiser`) ; les outils ne sont plus « utilisés tels quels » par `/boucle`.
|
||||
- [x] **Step 2 : `CLAUDE.md`** : dans la puce de l'agent de diagnostic, « outils et mode d'emploi de lecture dans le skill `lire-les-donnees`, aiguisés par `/aiguiser` (D-059, spec `vues-deplacements/contexte/aiguiser-la-lecture.md`) » ; dans la puce `.claude/`, les skills `lire-les-donnees`, `aiguiser` et les agents `lecteur`, `correcteur`, `optimiseur`. Run : `wc -l CLAUDE.md` ; Expected : moins de 200 (D-012).
|
||||
- [x] **Step 3 : les autres cartes** : `vues-deplacements/CLAUDE.md`, un paragraphe (la commande, le dossier `aiguiser/` des séances hors de tout dossier de station, la spec) ; `boucle-automatique.md` §3 : les outils de lecture évoluent par `/aiguiser`, leur mode d'emploi est dans `lire-les-donnees` ; `agent-diagnostic.md` : une ligne dans l'arbre des fichiers ; la spec : « construite le <date> ».
|
||||
- [x] **Step 4 : Point 42 du plan vivant** : étapes cochées (plan, construction, essai) ; index « construit, séance par l'utilisateur » ; une ligne au journal du plan.
|
||||
- [x] **Step 5 : Commit**
|
||||
|
||||
```bash
|
||||
git add docs/decisions.md CLAUDE.md vues-deplacements/CLAUDE.md vues-deplacements/contexte/boucle-automatique.md docs/agents/agent-diagnostic.md vues-deplacements/contexte/aiguiser-la-lecture.md vues-deplacements/contexte/journal-du-matin.md docs/superpowers/plans/2026-10-23-journal-du-matin.md docs/superpowers/plans/2026-10-24-aiguiser-la-lecture.md
|
||||
git commit -m "Record the reading sharpening decision (D-059)" -- docs/decisions.md CLAUDE.md vues-deplacements/CLAUDE.md vues-deplacements/contexte/boucle-automatique.md docs/agents/agent-diagnostic.md vues-deplacements/contexte/aiguiser-la-lecture.md vues-deplacements/contexte/journal-du-matin.md docs/superpowers/plans/2026-10-23-journal-du-matin.md docs/superpowers/plans/2026-10-24-aiguiser-la-lecture.md
|
||||
```
|
||||
|
||||
### Task 6 : Première séance
|
||||
|
||||
C'est l'utilisateur qui lance : `/aiguiser` ne s'appelle que par lui. Ne pas la lancer.
|
||||
|
||||
- [ ] **Step 1 : Session neuve** : l'utilisateur ouvre une nouvelle session Claude Code dans `~/Support-Agent`, en mode auto, et tape `/aiguiser <dossier> [--du … --au …]` sur les lots qu'il choisit.
|
||||
- [ ] **Step 2 : Contrôles** (Claude, à la fin, sur la branche `aiguiser/…`) :
|
||||
- `git log --stat master..HEAD` : chaque commit ne touche que les chemins de la tâche 4 ;
|
||||
- `git diff master..HEAD -- agents/diagnostic/cas/ vues-deplacements/journal/` : vide ;
|
||||
- `git diff master..HEAD -- agents/diagnostic/outils/ .claude/skills/lire-les-donnees/ | grep -nE '<STATION>|PR[0-9]{2}|20[0-9]{2}-[0-9]{2}-[0-9]{2}'` : rien dans une règle ;
|
||||
- `grep -rlE 'agents/diagnostic/outils|donnees' vues-deplacements/aiguiser/*/lot-*/corrige/` : rien ;
|
||||
- « Sources lues » des lectures : ni corrigé, ni écart, ni fiche de cas ;
|
||||
- le bilan : aucune commande des fiches en échec.
|
||||
- [ ] **Step 3 : Bilan à l'utilisateur** : les contrôles, puis le bilan de séance ; il fusionne, garde une partie ou revient en arrière. Le résultat va au point 42 du plan vivant.
|
||||
Reference in new issue
Block a user