Files
Support-Agent/docs/superpowers/plans/2026-10-24-aiguiser-la-lecture.md
T
maximeandClaude Opus 5.5 35b5ed4d74 Auto labels reviewed per station and cross-reviewed; all labeling knowledge in labeling/ (D-130)
- Every station's auto labels reviewed by an analyst (/review-auto-labels), then a
  cross-review per family across all stations (new skill /cross-review-labels),
  a finishing pass, and descriptions rewritten in words (no numeric values).
- The three never-labeled ranges (WILDSTRUBEL 07/09-01/10, NORDEND 16/08-01/10)
  labeled and reviewed: 991 auto labels on 11 stations, labeling/controle.py at 0 errors.
- Labeling knowledge gathered in labeling/: regles-d-etiquetage.md (new), familles.md
  (settled boundaries), connaissances/ (notes moved from docs/, links updated),
  the label map rebuilt from reviewed labels, events and cases; events tied to their
  stations (PS_DES_COUDRES is JUNGFRAU). The labeler and reviewers read only labeling/.
- labels-map reads auto labels and events; decision D-130; living plan points 73-75.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-05 08:21:57 +01:00

27 KiB
Raw Blame History

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) :
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 |.

  • 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 : labeling/connaissances/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.

  • 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.

  • 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.

  • 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.

  • Step 5 : Commit
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 :
# 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
  • 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.

  • 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.

  • Step 3 : Commit
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.

  • 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 labeling/connaissances/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.

  • 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.

  • 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.

  • 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).

  • Step 5 : Commit
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.

  • 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 :
# 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.

  • 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.

  • Step 3 : Commit
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)

  • 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.

  • 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).

  • 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 ».

  • 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.

  • Step 5 : Commit

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.