diff --git a/docs/ameliorations-processus.md b/docs/ameliorations-processus.md index 8569231..daaa8ee 100644 --- a/docs/ameliorations-processus.md +++ b/docs/ameliorations-processus.md @@ -13,3 +13,41 @@ Une même cause revue ajoute une occurrence, pas une entrée. Quand le processus ## /boucle - **Nom de la branche de séance** (2026-10-24, *contradiction*) : le skill nomme la branche avec l'heure (`boucle/_`, `SEANCE` = `date -u +%Y-%m-%dT%H%MZ`), la spec avec le jour seul (`boucle/_`), alors qu'elle donne l'heure au dossier de la séance ; l'orchestrateur a suivi le skill. *En cause* : `.claude/skills/boucle/SKILL.md:16-17` et `:57` contre `vues-deplacements/contexte/boucle-automatique.md:44` et `:115` (le plan `docs/superpowers/plans/2026-10-24-boucle-automatique.md:195` et `vues-deplacements/CLAUDE.md:23` suivent le skill). *Occurrences* : essai du releveur, sans séance, orchestrateur. *Piste* : aligner la spec sur le skill (avec le jour seul, deux séances le même jour sur la même station tomberaient sur la même branche). + +## /aiguiser + +Séance de référence des entrées ci-dessous : 2026-10-26T1149Z, NORDEND, lot 01 et contrôle (S1 dans les occurrences). Les faits vérifiés dans le dépôt sont donnés comme tels ; ce qui ne vient que du dire d'un agent est marqué « selon l'agent ». + +- **Commandes Bash hors de la liste du skill** (2026-10-26, *contradiction*) : le skill de lecture ne permet que les outils, `ls`, `grep` et `date`, un tube vers `grep` seulement. Les lecteurs ont pourtant eu besoin de `head`, `tail`, `sed`, `cut`, `wc`, de `grep` sur un fichier de résultats et de `mkdir -p` : sortie trop longue à lire, chemin du PNG à isoler. Ils l'ont fait sans savoir si c'était permis (une commande `grep | cut | sed` n'a rendu aucune sortie). Le `mkdir -p` paraît inutile : `ensemble.py`, `graphique.py` et `vignettes.py` créent leur dossier de sortie (`ensemble.py:87`, `graphique.py:83`, `vignettes.py:60`) ; C-002 dit pourtant en avoir eu besoin, non vérifié. *En cause* : `.claude/skills/lire-les-donnees/SKILL.md:33` (liste de commandes), `.claude/agents/lecteur.md:25`. *Occurrences* : S1 lot 01 lecture-1 (`grep -v` sur fichier), lecture-2 (`tail`, `head`), lecture-3 (`wc -l`, `head`, `tail`), lecture-4 (`sed`, `grep` sur fichier) ; S1 contrôle C-002 (`sed`, `mkdir -p`), C-004 (`mkdir -p`, `head`), C-005 (`cut`, `sed`). *Piste* : voir l'entrée suivante, qui en est la cause première. + +- **Sortie d'`inventaire.py` trop longue pour s'afficher** (2026-10-26, *commande*) : sur ce dépôt, l'inventaire rend 72 à 73 Ko (selon les agents : 841 lignes « autres fichiers », 29 exports, 696 images, 923 lignes avec `--debut`/`--fin`) ; Bash la range dans un fichier de résultats que le lecteur doit relire par `grep`, `sed` ou `head`, d'où l'entrée précédente. Le skill n'annonce pas cette longueur. Non revérifié (taille donnée par les agents). *En cause* : `.claude/skills/lire-les-donnees/SKILL.md:21` (ligne de l'outil), `:38` (méthode : « Inventaire »). *Occurrences* : S1 lot 01 lecture-1, lecture-2, lecture-3, lecture-4. *Piste* : que l'outil n'imprime pas la liste des fichiers hors déplacements. + +- **`inventaire.py` refusait `--debut` et `--fin` au départ de la séance** (2026-10-26, *contradiction*) : la demande du lecteur dit d'appeler « les outils avec `--debut` et `--fin` du lot », mais la ligne du skill pour `inventaire.py` n'en citait pas (vérifié : `git show 4424ea1^`) et l'outil ne les acceptait pas ; il imprimait son usage. La modification 2 de la séance les a ajoutés (`agents/diagnostic/outils/inventaire.py:119-120`, commit 53eaf45) : le défaut est donc corrigé dans la branche de séance, à garder ou non par l'utilisateur. *En cause* : `.claude/agents/lecteur.md:25` contre `.claude/skills/lire-les-donnees/SKILL.md:21` (avant la séance). *Occurrences* : S1 lot 01 lecture-1. + +- **« Toute la période » au contrôle : quelle fenêtre ?** (2026-10-26, *consigne floue*) : le skill dit de passer `--debut`/`--fin` du lot, et que la section sur la fenêtre de `inventaire.py` n'existe qu'avec elles ; au contrôle, la demande est « Toute la période » sans bornes. Les lecteurs ont lancé sans bornes (pas de section de fenêtre), puis ont choisi eux-mêmes des bornes pour zoomer. *En cause* : `.claude/skills/aiguiser/SKILL.md:51`, `.claude/agents/lecteur.md:25` (« sans eux pour toute la période »), `.claude/skills/lire-les-donnees/SKILL.md:32` et `:38`. *Occurrences* : S1 contrôle C-001 lecture, C-002 lecture. + +- **Fin d'un lot : incluse ou non ?** (2026-10-26, *consigne floue*) : le lot est écrit ` → ` (ici 09-01T00:00Z → 09-04T00:00Z) et le skill de lecture dit que `--fin` inclut la minute indiquée, donc le point du 04/09 00:00 est dans la lecture ; le correcteur, lui, écrit des fins de moment « 09-04 00:00 » alors que « le lot s'arrête avant ». Chacun a tranché de son côté. *En cause* : `.claude/skills/aiguiser/SKILL.md:22` et `:28` contre `.claude/skills/lire-les-donnees/SKILL.md:32`. *Occurrences* : S1 lot 01 lecture-2, ecart-4. + +- **Méthode du skill : rien n'indique ce qui est facultatif** (2026-10-26, *consigne floue*) : la méthode enchaîne inventaire, ensemble, `graphique.py` sur tous les capteurs (`error_value`, `corr_x`, `corr_y`), `resume.py` à 6h/1d, zoom, vignettes « une toutes les 2 à 3 h » ; les lecteurs ont sauté des étapes sans savoir si c'était attendu (C-001 : pas de `graphique.py` sur tous les capteurs ni de `resume.py` 6h/1d) ou fait peu de planches (lecture-1 : 4 planches de 4 capteurs, jugeant la cadence incompatible avec les permissions par commande). *En cause* : `.claude/skills/lire-les-donnees/SKILL.md:39` et `:42`. *Occurrences* : S1 lot 01 lecture-1 ; S1 contrôle C-001 lecture. + +- **Unité de l'ampleur : MAD ou bruits** (2026-10-26, *consigne floue*) : le skill demande l'ampleur « en MAD ou en fois la médiane », alors que `ensemble.py` rend ses écarts en « bruits » (médiane des écarts entre deux mesures, `lire-les-donnees/SKILL.md:24`) ; le lecteur a reporté les deux sans convertir. *En cause* : `.claude/skills/lire-les-donnees/SKILL.md:52` contre `:24`. *Occurrences* : S1 contrôle C-001 lecture. + +- **`corr` ou `relative` : lequel privilégier** (2026-10-26, *consigne floue*) : la méthode dit `corr_x`, `corr_y` « ou `relative_x`, `relative_y` » sans critère de choix ; le lecteur a pris `corr` seul. Sans gêne pour le lot. *En cause* : `.claude/skills/lire-les-donnees/SKILL.md:39`. *Occurrences* : S1 lot 01 lecture-1. + +- **Tables d'`ensemble.py` : étiquettes décalées d'une heure** (2026-10-26, *commande*) : les pas partent de la première mesure de la fenêtre (`t0`), pas d'une heure pleine ; une mesure horodatée hh:00:00,x tombe dans le pas précédent. Sur la période entière du cas C-005 (première mesure 22:00:13), la table saute 00:00, 12:00 et 11:00 alors que les absents sont 01:00, 13:00 et 12:00 (selon l'agent ; le calcul `t0 + ((t - t0) // pas) * pas` est vérifié en `agents/diagnostic/outils/ensemble.py:144`, `:164`, `:200`). Le lecteur a relancé sur des fenêtres commençant à l'heure pleine et gardé « à ±1 h ». La même cause est possible pour les lignes qui manquent dans la table à 15 min du lecteur du lot 01 (selon l'agent, non vérifié). *En cause* : `agents/diagnostic/outils/ensemble.py:144`. *Occurrences* : S1 contrôle C-005 lecture ; S1 lot 01 lecture-3 (possible). + +- **Scripts du correcteur : bibliothèque standard imposée, mais les images exigent Pillow et numpy** (2026-10-26, *contradiction*) : la consigne demande des scripts en bibliothèque standard, `.venv/bin/python` seulement avec matplotlib pour les figures ; les recadrages et pics par capteur sur les images demandent Pillow et numpy, que le correcteur a utilisés via `.venv/bin/python`, sans savoir si c'était permis. *En cause* : `.claude/agents/correcteur.md:27`. *Occurrences* : S1 lot 01 ecart-1. + +- **Fichiers du correcteur écrits hors de `/corrige/`** (2026-10-26, *consigne floue*) : `f_images.png` et `img1.json` sont restés à la racine du dépôt, non suivis (vérifié : `git status`, créés le 2026-10-26 à 12:56 UTC), et les scripts `fig1.py`, `fig2.py`, `fig3.py` y ont d'abord été écrits avant d'être déplacés dans `corrige/`. La consigne dit où mettre les scripts et les figures, pas où vont les sorties des scripts quand ils sont lancés depuis la racine. *En cause* : `.claude/agents/correcteur.md:27` (« scripts et figures dans `/corrige/` … lance-les depuis la racine du dépôt »). *Occurrences* : S1 lot 01 ecart-1 (scripts), ecart-2, ecart-3, ecart-4 (les deux fichiers) ; orchestrateur. + +- **`vues-deplacements/CLAUDE.md` et l'état git injectés malgré `omitClaudeMd: true`** (2026-10-26, *autre*) : presque tous les agents disent avoir reçu, en cours de travail, le contenu de `vues-deplacements/CLAUDE.md` (parfois aussi le `gitStatus` avec les titres des derniers commits « lecture 2 », « écart 2 »), alors que leurs consignes cherchent à l'écarter pour ne pas fausser la mesure. Les consignes prévoient de le signaler dans « Sources lues » ; ils l'ont en plus mis en « Difficultés ». Cause supposée (non vérifiée) : le contexte d'un sous-dossier se charge dès qu'un fichier de ce dossier est lu, ce que `omitClaudeMd` ne couvre pas. *En cause* : `.claude/agents/lecteur.md:6` et `:21`, `.claude/agents/correcteur.md:6` et `:23`. *Occurrences* : S1 lot 01 lecture-1, lecture-2, lecture-3, lecture-4, ecart-1, ecart-2, ecart-3, ecart-4 ; S1 contrôle C-002 lecture et ecart, C-003 lecture et ecart, C-005 lecture et ecart. + +- **Au contrôle, la faute « outil » ou « mode d'emploi » se juge sans lire le skill** (2026-10-26, *contradiction*) : le correcteur doit classer chaque manque en faute d'outil, de mode d'emploi ou de lecteur, mais il lui est interdit de lire le skill et d'utiliser les outils ; il infère donc la faute du texte de la lecture et de son « Ce qui m'a manqué ». *En cause* : `.claude/agents/correcteur.md:23` contre `:47-49`. *Occurrences* : S1 contrôle C-002 ecart (D1, D2), C-003 ecart (critère 2), C-004 ecart. + +- **Contrôle : un critère à moitié retrouvé n'a pas de verdict, et le décompte ment** (2026-10-26, *consigne floue*) : le verdict d'un cas est « manqué » dès qu'un critère manque, donc le bilan compte « 0 retrouvé sur 5 » même quand C-001 a 4 critères sur 5 retrouvés, et la formule `( retrouvés sur )` du message de commit ne dit pas si elle compte les cas ou les critères ; le correcteur de C-005, lui, n'avait pas de mot pour un critère à moitié retrouvé et a écrit « retrouvé en partie ». *En cause* : `.claude/skills/aiguiser/SKILL.md:60` (message de commit), `.claude/agents/correcteur.md:84` (« manqué » dès qu'un critère est manqué), `:57`. *Occurrences* : S1 contrôle C-005 ecart ; orchestrateur (commit `contrôle (0 retrouvés sur 5)`, bilan). + +- **Au contrôle, la demande du correcteur ne donne pas le dossier des données** (2026-10-26, *consigne floue*) : la demande cite la fiche et la lecture, dont le dossier est `out/aiguiser//C-xxx/` (liens) ; le correcteur a trouvé les données dans `agents/diagnostic/cas/C-005/displacement/` et lu cette copie, la consigne ne disant pas laquelle. *En cause* : `.claude/skills/aiguiser/SKILL.md:50-52`, `.claude/agents/correcteur.md:15` et `:21`. *Occurrences* : S1 contrôle C-005 ecart. + +- **Arguments mal formés : que faire sans pouvoir poser de question ?** (2026-10-26, *consigne absente*) : la commande est arrivée avec `` tel quel et des dates `2026-09.01` / `2026-09.04` ; le skill interdit toute question à l'utilisateur et n'indique la conduite à tenir (« dis-le et arrête-toi ») que pour l'absence d'export « advanced ». L'orchestrateur a deviné NORDEND (seul dossier de `out/pompage/`, vérifié) et 2026-09-01 → 2026-09-04, et l'a écrit dans le bilan. *En cause* : `.claude/skills/aiguiser/SKILL.md:10` (« aucune question »), `:14` (arguments), `:15`, `:5` (`argument-hint`). *Occurrences* : S1, orchestrateur. + +- **Contrôle : parallélisme non précisé** (2026-10-26, *consigne floue*) : le skill décrit le contrôle cas par cas (lecteur puis correcteur, pour chaque `C-xxx`) sans dire si les cinq cas peuvent tourner en parallèle ; l'orchestrateur l'a fait. *En cause* : `.claude/skills/aiguiser/SKILL.md:46-52`. *Occurrences* : S1, orchestrateur.