diff --git a/.claude/agents/builder.md b/.claude/agents/builder.md index 13a34bd..9b991e8 100644 --- a/.claude/agents/builder.md +++ b/.claude/agents/builder.md @@ -27,7 +27,7 @@ Le dossier de station, le lot (UTC), le dossier du lot (ses rendus : `critique.m ## Règles - Ne modifie jamais un cas existant, ni `agents/diagnostic/instructions.md`, ni rien hors de tes nouveaux dossiers de cas, de l'index et de ton rendu (le registre `registre.csv` grandit tout seul par `anonymiser.py`). -- Ne passe pas par `/nouveau-cas` : pas de passage à l'aveugle, pas de validation par l'utilisateur ; les cas appris s'ajoutent sans attendre. +- Ne passe pas par `/nouveau-cas` : pas de passage à l'aveugle, pas de validation par l'utilisateur ; les cas appris s'ajoutent sans attendre : l'utilisateur les revoit ensuite avec `/revue-cas`, qui cherche la phrase exacte `non revalidé par l'expert` de l'en-tête (D-075). - Aucun nom réel de station ou de capteur ne reste dans un cas (l'étape 3 d'`anonymiser-cas` le vérifie) ; aucun identifiant (`SIM_CCID`, `ip`). - Ne commite pas : l'orchestrateur le fait. diff --git a/.claude/agents/revue.md b/.claude/agents/revue.md new file mode 100644 index 0000000..5e1516d --- /dev/null +++ b/.claude/agents/revue.md @@ -0,0 +1,69 @@ +--- +name: revue +description: Revue d'un cas appris par /boucle (agents/diagnostic/cas/C-xxx/), non encore validé par l'expert — le présente à l'utilisateur, puis applique ses corrections ou sa validation. Appelé par l'orchestrateur de /revue-cas, un cas à la fois. +tools: Read, Bash, Write, Edit +model: inherit +--- + +Tu es l'agent de revue. Le builder de `/boucle` a ajouté un cas à la base sans l'avis de l'expert (en-tête `non revalidé par l'expert`). L'expert, c'est l'utilisateur : tu lui présentes le cas pour qu'il le valide ou le corrige. Tu ne lui parles pas directement : ta présentation va dans une page web, avec la page des détecteurs, la fiche, la critique du lot et toutes les figures ; l'orchestrateur lui pose la question et te renvoie sa réponse. + +## Ta demande + +Un cas `C-xxx`, et l'une de ces trois consignes : + +### « présenter » + +1. Lis `agents/diagnostic/cas/C-xxx/cas.md`, sa ligne de `agents/diagnostic/cas/INDEX.md` et `etiquetage.md` à côté. +2. La station réelle : la ligne `,,C-xxx` de `.claude/skills/anonymiser-cas/registre.csv` ; les vrais noms des capteurs cités : les lignes `,,` du même registre. Ils sont pour l'utilisateur seulement : jamais dans un fichier du cas. +3. La séance : l'horodatage de l'en-tête de la fiche, dossier `vues-deplacements/boucle/_/` ; le lot dont le `builder.md` cite le cas. Lis ce `builder.md` et, dans la `critique.md` du lot, ce que l'analyste dit de l'événement (`grep -n` sur les capteurs ou le phénomène, puis la section seule). +4. Les détecteurs, sur la plage de l'événement (ligne **Événement** de la fiche ; `--au` exclu, donc le jour de fin plus un) : `python3 .claude/skills/boucle/detecteurs.py data/ --du --au ` (sans `data//`, hors de git, sur `agents/diagnostic/cas/C-xxx/`). Note ce que les détecteurs sortent sur l'événement (la liste au bas de la page, ou `score.py` si besoin) : le voient-ils, sous quelle catégorie ? +5. Regarde chaque PNG de la fiche : montre-t-il ce que dit sa légende ? +6. Écris la présentation (format ci-dessous) dans `out/revue-cas/C-xxx.md`, puis fais la page de revue, qui s'ouvre chez l'utilisateur : `python3 .claude/skills/revue-cas/page.py C-xxx --du --au ` (mêmes dates qu'en 4). +7. Rends seulement : le chemin de la page, les dates passées, et la liste « À trancher par l'expert », numérotée. + +### « corriger : » + +- Applique ses corrections à la fiche, à la ligne d'index et, si le diagnostic change (catégorie, plage d'un moment), à `etiquettes.json` ; contrôle : `python3 .claude/skills/critiquer-lot/etiquettes.py agents/diagnostic/cas/C-xxx agents/diagnostic/cas/C-xxx/etiquettes.json`, « bon ». Une figure à refaire : skill `anonymiser-cas`, étape 2. Son jugement entre dans le **Diagnostic** (le fait, et ce qu'en dit l'expert) ; les listes fermées du §11.3 de `docs/agents/agent-diagnostic.md` restent fermées. +- Une phrase de lui qui n'est pas nette : ne devine pas, rends la question. +- Relance l'étape 3 du skill `anonymiser-cas` (la commande d'`anonymiser.py` avec la fenêtre `--du` / `--au` d'`etiquetage.md`) : aucun nom réel ne reste. +- Mets à jour `out/revue-cas/C-xxx.md` (ce qui est tranché quitte « À trancher », une section « Corrections de l'expert » dit ce qui a changé) et refais la page de revue (même commande, mêmes dates). +- Rends : ce que tu as changé, fichier par fichier, en une ligne chacun, et ce qui reste à trancher. + +### « valider » + +- En-tête de la fiche : `non revalidé par l'expert` devient `validé par l'expert le `, suivi, s'il a corrigé, de `, corrigé : `. +- Ligne d'index : retire `(appris) ` du Verdict. +- Rends les deux lignes nouvelles. + +## La présentation + +Courte, pour un humain qui connaît le terrain, sans codes seuls : chaque capteur par son code **et** son vrai nom (`R1 = `). + +```markdown +# C-xxx : + +**Station** : · **Séance** : , lot NN · **Événement** : · **Données du cas** : + +## Ce que la boucle a vu + + +## Le diagnostic proposé +- Classification, cause et niveau de preuve, conséquence, action +- Les critères de la signature, un par ligne, avec leurs valeurs + +## Les détecteurs aujourd'hui + + +## Figures +- : + +## À trancher par l'expert +1. +``` + +## Règles + +- Ne touche qu'au dossier du cas, à sa ligne d'index et à `out/revue-cas/` ; jamais aux autres cas, aux détecteurs, à `agents/diagnostic/instructions.md`. Ne modifie pas le registre à la main. +- Aucun nom réel de station ou de capteur dans un fichier du cas ; le nom réel n'apparaît que dans ta présentation. +- Ne valide jamais de toi-même : seulement sur la consigne « valider ». +- Ne commite pas : l'orchestrateur le fait. diff --git a/.claude/skills/revue-cas/SKILL.md b/.claude/skills/revue-cas/SKILL.md new file mode 100644 index 0000000..692a137 --- /dev/null +++ b/.claude/skills/revue-cas/SKILL.md @@ -0,0 +1,40 @@ +--- +name: revue-cas +description: Revue par l'expert des cas que /boucle a ajoutés à la base (en-tête « non revalidé par l'expert ») — l'agent revue présente chaque cas, l'utilisateur le valide, le corrige ou le rejette. Lancé par l'utilisateur seulement, avec /revue-cas. +disable-model-invocation: true +argument-hint: "[C-xxx ...]" +--- + +# Revue des cas appris + +Le builder de `/boucle` ajoute des cas sans l'avis de l'expert (D-057). L'expert, c'est l'utilisateur : chaque cas qu'il n'a pas validé passe par cette revue. Tu es l'orchestrateur : l'agent `revue` présente et modifie, toi tu relaies, poses la question et commites. **Tu ne juges pas le cas toi-même.** + +## 1. Les cas à revoir + +`grep -l "non revalidé par l'expert" agents/diagnostic/cas/*/cas.md` ; avec des arguments `C-xxx`, ceux-là seulement (un cas déjà validé : dis-le et passe). Aucun : dis-le et arrête-toi. Annonce la liste, puis prends-les un par un, du plus petit numéro au plus grand. + +## 2. Pour chaque cas + +1. Lance l'outil Agent, `subagent_type: revue`, prompt : `C-xxx, présenter`. Attends sa notification. +2. La page de revue `out/revue-cas/C-xxx.html` s'est ouverte dans son navigateur : la présentation de l'agent, la page des détecteurs, la fiche, la critique du lot d'origine, toutes les figures. **Ne recopie pas la présentation dans la conversation** : dis en une ligne que la page est ouverte (avec son chemin, `python3 .claude/skills/revue-cas/page.py C-xxx --du … --au …` pour la rouvrir), puis la liste « À trancher » que l'agent rend. +3. Pose la question (AskUserQuestion), « C-xxx : ton avis ? » : + - **Valider** : le cas est juste tel quel ; + - **Corriger** : il écrit ses corrections (champ libre « Other », ou dans la conversation) ; + - **Rejeter** : le cas ne doit pas rester dans la base ; + - **Passer** : plus tard, rien ne change. +4. Selon sa réponse : + - **Corriger** : envoie à l'agent (SendMessage, son identifiant ; à défaut, un nouvel agent `revue` avec le même début de prompt) `C-xxx, corriger : `. Relaie son rendu, `git diff --stat agents/diagnostic/cas/` ; la page s'est rouverte, à jour ; puis repose la question 3 ; + - **Valider** : envoie `C-xxx, valider`, relaie les deux lignes, puis commite par chemin `agents/diagnostic/cas/C-xxx/` et `agents/diagnostic/cas/INDEX.md`, message `Validate case C-xxx` (ou `Validate case C-xxx with the expert's corrections`) ; + - **Rejeter** : demande en une phrase s'il faut une trace (une ligne dans la critique du lot d'origine suffit), puis `git rm -r agents/diagnostic/cas/C-xxx/`, retire sa ligne d'index, commite par chemin, message `Remove learned case C-xxx rejected by the expert`. Le registre garde ses lignes (il ne fait que grandir) ; le numéro n'est pas réutilisé ; + - **Passer** : rien. +5. Cas suivant. + +## 3. Fin + +Un tableau : cas, décision (validé, corrigé et validé, rejeté, passé). Un cas passé se reverra au prochain `/revue-cas`. + +## Règles + +- Les vrais noms (station, capteurs) restent dans la conversation et `out/revue-cas/` (hors de git) : jamais dans un fichier du cas ni un message de commit. +- Une correction qui touche une règle générale (les instructions de l'agent de diagnostic, un détecteur, le builder) n'est pas faite ici : note-la pour l'utilisateur dans le tableau de fin. +- Les autres fichiers modifiés de l'arbre ne se commitent pas avec le cas. diff --git a/.claude/skills/revue-cas/page.py b/.claude/skills/revue-cas/page.py new file mode 100644 index 0000000..e4ae945 --- /dev/null +++ b/.claude/skills/revue-cas/page.py @@ -0,0 +1,107 @@ +"""La page de revue d'un cas appris : tout ce qu'il faut à l'expert pour trancher, sur une seule page (D-075). + +En tête, la présentation de l'agent revue (out/revue-cas/C-xxx.md, si elle existe), puis la page des détecteurs sur la +plage (detecteurs.py, sur data//, sinon sur le dossier du cas) ; dessous, la fiche, l'étiquetage, le rendu du +builder et la critique du lot d'origine, puis toutes les figures : celles du cas et celles du lot de la séance. +Les vrais noms y figurent (registre) : la page reste dans out/, hors de git. +Usage : python3 .claude/skills/revue-cas/page.py C-xxx --du AAAA-MM-JJ --au AAAA-MM-JJ (--au exclu ; page ouverte) +""" +import argparse +import base64 +import csv +import glob +import html +import json +import os +import re +import sys + +ICI = os.path.dirname(os.path.abspath(__file__)) +sys.path.insert(0, os.path.join(ICI, "..", "boucle")) +import detecteurs # noqa: E402 +from comparaison import ROOT, open_html # noqa: E402 + +CAS = os.path.join(ROOT, "agents", "diagnostic", "cas") + + +def lire(chemin): + return open(chemin, encoding="utf-8").read() if os.path.exists(chemin) else None + + +def station_du_cas(cas): + with open(os.path.join(ICI, "..", "anonymiser-cas", "registre.csv"), encoding="utf-8") as f: + for ligne in csv.DictReader(f): + if ligne["code"] == cas: + return ligne["station"] + raise SystemExit(f"{cas} n'est pas dans le registre.") + + +def lot_d_origine(cas, fiche, station): + m = re.search(r"séance `?(?:vues-deplacements/boucle/)?(\d{4}-\d\d-\d\dT\d{4}Z)", fiche) + if not m: + return None + for builder in sorted(glob.glob(os.path.join(ROOT, "vues-deplacements", "boucle", f"{m[1]}_{station}", "lot-*", "builder.md"))): + if re.search(rf"\*\*Cas créés\*\*.*\b{cas}\b", lire(builder)): + return os.path.dirname(builder) + return None + + +def bloc(titre, texte, ouvert=True): + # les figures citées dans les .md sont dans la galerie, en bas : on retire les liens d'image, cassés depuis out/ + texte = re.sub(r"!\[[^\]]*\]\([^)]*\)", "", texte) + source = json.dumps(texte).replace("

{html.escape(titre)}

" + f"
") + + +def figure(chemin): + donnees = base64.b64encode(open(chemin, "rb").read()).decode() + nom = os.path.relpath(chemin, ROOT) + return f"
{html.escape(nom)}
{html.escape(nom)}
" + + +def page(cas, du, au): + dossier_cas = os.path.join(CAS, cas) + fiche = lire(os.path.join(dossier_cas, "cas.md")) + if fiche is None: + raise SystemExit(f"Pas de fiche {dossier_cas}/cas.md.") + station = station_du_cas(cas) + lot = lot_d_origine(cas, fiche, station) + donnees = os.path.join(ROOT, "data", station) + if not os.path.isdir(donnees): + donnees = dossier_cas + + presentation = lire(os.path.join(ROOT, "out", "revue-cas", f"{cas}.md")) + entete = (f"

Revue de {cas} : {html.escape(station)}

" + f"

Lot d'origine : {html.escape(os.path.relpath(lot, ROOT)) if lot else 'introuvable'} · " + f"détecteurs sur {html.escape(os.path.relpath(donnees, ROOT))}

") + entete += bloc("Présentation de l'agent revue", presentation) if presentation else "

Pas encore de présentation de l'agent revue.

" + + annexe = bloc("Fiche du cas (cas.md, noms codés)", fiche) + for titre, chemin in [("Étiquetage du cas", os.path.join(dossier_cas, "etiquetage.md")), + ("Rendu du builder", lot and os.path.join(lot, "builder.md")), + ("Critique de l'analyste, lot d'origine", lot and os.path.join(lot, "critique.md"))]: + texte = chemin and lire(chemin) + if texte: + annexe += bloc(titre, texte, ouvert=False) + pngs = sorted(glob.glob(os.path.join(dossier_cas, "*.png"))) + (sorted(glob.glob(os.path.join(lot, "*.png"))) if lot else []) + annexe += f"

Figures ({len(pngs)})

" + "".join(figure(p) for p in pngs) + annexe += """ + +""" + + chemin = os.path.join(ROOT, "out", "revue-cas", f"{cas}.html") + os.makedirs(os.path.dirname(chemin), exist_ok=True) + return detecteurs.page(donnees, du, au, entete=entete, annexe=annexe, chemin=chemin) + + +if __name__ == "__main__": + p = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter) + p.add_argument("cas") + p.add_argument("--du", required=True) + p.add_argument("--au", required=True) + o = p.parse_args() + chemin = page(o.cas, o.du, o.au) + print(chemin) + open_html(chemin) diff --git a/CLAUDE.md b/CLAUDE.md index 096c96c..f83c249 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -12,7 +12,7 @@ Agent de diagnostic proactif pour **AIMsight**, un système de surveillance opti - **Maquettes du site (D-022, D-039)** : client « System Summary », une page par station de `data/`, un bloc par domaine mesuré dans la section Diagnostic (Energy, Storage, Cellular, Temperature) ; support « Home » (section Status, une notification par station et par domaine Orange ou Red, lien vers la vue client de la station, D-025). - **Agents LLM côté serveur (D-027)** : rapport exploratoire seulement, rien n'est construit. - **Séries optiques (D-044)** : détecter les événements externes (occlusion, pluie, turbulence) dans les déplacements et produire une courbe corrigée, la brute gardée ; cadrage (`docs/displacement/cadrage.md`) ; données reçues (D-045) : PS des Coudres, export 15 min en UTC sur 5,5 jours, sans événement annoté (buée probable le matin), et 24 images horaires de la caméra, puis NORDEND, WILDSTRUBEL, CLARIDEN et NIEDERHORN, chacune devenue un cas de la base ; CLARIDEN est l'incident de Barcelone de la doc AIMsight, où l'expert voit un mouvement réel de l'ouvrage, la doc une instabilité des références (`docs/displacement/domaine/incident-de-barcelone.md`) ; deux rapports d'analyse AIMsight (murs GN-1.472 et GN-5.054), causes des déplacements apparents selon l'expert, sans leurs données ; exploration confiée d'abord à l'agent de diagnostic (D-046), chaîne analytique au second plan. -- **Agent de diagnostic (D-046, révisé par D-058)** : pilote de l'enquête à la demande (D-042) dans Claude Code, appelé pour un cas précis que les détecteurs n'expliquent pas ; plus à l'aveugle : il lit la connaissance du projet et part des événements des détecteurs du journal, sans les juger, et n'ajoute aucun cas ; sous-agent `diagnostic` (`.claude/agents/diagnostic.md`, dossier `agents/diagnostic/`, spec `docs/agents/agent-diagnostic.md`) ; un dossier de `data/` et une question facultative donnent un rapport court dans `agents/diagnostic/rapports/_/` : verdict, anomalies seules, chacune montrée par un graphique et des vignettes des images (D-047) ; déplacements et images seulement ; cas de référence du spécialiste : PS des Coudres est sain, seule anomalie les pics d'erreur de `REF_G` et `REF_D` ; base de cas validés (D-048, `agents/diagnostic/cas/`), lue après les faits : cinq cas, C-001 à C-005 (l'index `agents/diagnostic/cas/INDEX.md` en est le registre), chaque cas avec ses données, la station au numéro du cas et les capteurs codés (D-049, D-050, skill `anonymiser-cas`), une fiche courte sur ce seul cas, lisible d'abord par un humain (D-051) ; un cas n'y entre que par `/nouveau-cas`, lancé par l'utilisateur, ou par le builder de la boucle (D-057). Ses outils et leur mode d'emploi, partagés avec l'analyste de la boucle : skill `lire-les-donnees`, aiguisé par `/aiguiser` (D-059, lancé par l'utilisateur seul ; spec `vues-deplacements/contexte/aiguiser-la-lecture.md`). L'enquête par API (D-042) reste un document. +- **Agent de diagnostic (D-046, révisé par D-058)** : pilote de l'enquête à la demande (D-042) dans Claude Code, appelé pour un cas précis que les détecteurs n'expliquent pas ; plus à l'aveugle : il lit la connaissance du projet et part des événements des détecteurs du journal, sans les juger, et n'ajoute aucun cas ; sous-agent `diagnostic` (`.claude/agents/diagnostic.md`, dossier `agents/diagnostic/`, spec `docs/agents/agent-diagnostic.md`) ; un dossier de `data/` et une question facultative donnent un rapport court dans `agents/diagnostic/rapports/_/` : verdict, anomalies seules, chacune montrée par un graphique et des vignettes des images (D-047) ; déplacements et images seulement ; cas de référence du spécialiste : PS des Coudres est sain, seule anomalie les pics d'erreur de `REF_G` et `REF_D` ; base de cas validés (D-048, `agents/diagnostic/cas/`), lue après les faits : cinq cas, C-001 à C-005 (l'index `agents/diagnostic/cas/INDEX.md` en est le registre), chaque cas avec ses données, la station au numéro du cas et les capteurs codés (D-049, D-050, skill `anonymiser-cas`), une fiche courte sur ce seul cas, lisible d'abord par un humain (D-051) ; un cas n'y entre que par `/nouveau-cas`, lancé par l'utilisateur, ou par le builder de la boucle (D-057), puis revu par l'utilisateur avec `/revue-cas` (D-075, agent `revue`). Ses outils et leur mode d'emploi, partagés avec l'analyste de la boucle : skill `lire-les-donnees`, aiguisé par `/aiguiser` (D-059, lancé par l'utilisateur seul ; spec `vues-deplacements/contexte/aiguiser-la-lecture.md`). L'enquête par API (D-042) reste un document. - **Storage (D-030, D-034, D-035)** : jeu de travail WEISSHORN seul (NORDEND n'a pas les mesures de `/data`) ; `DAILY_STORAGE_STATE` et `DAYS_UNTIL_STORAGE_FULL` en prototype, sans cas de l'expert ; couleur du jour codée (`src/storage/day_color.py`, matrice état × horizon `docs/storage/matrice-etat-horizon.drawio`, la pire des deux) ; seuils arbitraires (20 % / 10 % libres, 60 / 14 jours) ; questions en suspens dans `docs/storage/domaine/questions-pour-l-expert.md` ; livré en prototype (D-039) : figure du site `src/storage/final.py`, bloc de la vue client, notification support, guide `docs/storage/guide/`. - **Cellular (D-030 à D-032, D-037), en pause en attendant le spécialiste** : WEISSHORN (mise en service le 19/08, puis quelques incidents isolés) et NORDEND (109 jours, 11 coupures de la liaison) explorés ; `DAILY_LINK_STATE` et `DAILY_SIGNAL_STATE` en prototype, sans cas de l'expert ; deux corrections de `DAILY_LINK_STATE` retenues sur le principe mais non codées ; couleur du jour codée (`src/cellular/day_color.py`, matrice lien × signal `docs/cellular/matrice-lien-signal.drawio` : Red si des envois manquent et que le signal n'est pas mesuré 20 h sur 24) ; livré en prototype avant les réponses du spécialiste (D-039) : figure du site `src/cellular/final.py`, bloc de la vue client, notification support, guide `docs/cellular/guide/`. Reprise : `docs/cellular/domaine/questions-pour-l-expert.md`. - **Temperature (D-040)** : jeux de travail WEISSHORN et NORDEND (VERMONT n'a pas le GPU) ; `DAILY_GPU_TEMPERATURE_LIMIT` en prototype, sans cas de l'expert : une moyenne horaire du GPU ≥ 97,5 °C (limite du Jetson Nano, carte supposée) dans les 24 dernières heures ; couleur du jour codée (`src/temperature/day_color.py` : Red si atteinte, sinon Green, pas d'orange) ; tous les jours Green (maximum 57,2 °C) ; livré en prototype (D-041) : figure du site `src/temperature/final.py`, bloc de la vue client, notification support, guide `docs/temperature/guide/`. Constats, pistes et questions dans `docs/temperature/domaine/point-de-depart.md`. @@ -145,7 +145,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer . - `storage/` : calcul embarquable `storage_state.py`, `days_until_full.py`, `day_color.py` (D-035) ; plotly : `final.py` (figure du site, D-039), `all_analyses.py` (D-034). - `temperature/` : calcul embarquable `gpu_temperature_limit.py`, `day_color.py` ; plotly : `final.py` (figure du site, D-041), `all_analyses.py` (D-040). - `maquettes/` : maquettes du site en HTML sur données réelles (D-022), Figma seulement sur demande. Un script remplit son gabarit HTML : `user/summary.py` + `summary_template.html` (client, une page par station, un bloc par domaine), `support/home.py` + `home_template.html` (support). Les deux parcourent une liste de domaines (`DOMAINS`, D-039). -- `.claude/` : `rules/analyses.md` (se charge seule, voir « Analyses »), `agents/diagnostic.md` (point d'entrée de l'agent de diagnostic, D-046), `skills/nouvelle-analyse/` (procédure et modèle de fiche), `skills/nouveau-domaine/` (procédure pour un nouveau domaine), `skills/nouveau-cas/` (ajouter un cas à la base de l'agent de diagnostic, lancé par l'utilisateur seul), `skills/anonymiser-cas/` (données d'un cas copiées dans son dossier, noms en codes, registre des codes, D-049, D-050), `skills/boucle/` et `skills/critiquer-lot/` avec les agents `analyste`, `upgrader`, `validateur`, `builder` (boucle automatique, D-057), `skills/lire-les-donnees/` (outils de lecture et leur mode d'emploi) et `skills/aiguiser/` avec les agents `lecteur`, `correcteur`, `optimiseur` (D-059), `agents/releveur.md` (difficultés des processus automatiques, D-060), `agents/ameliorateur.md` (les corrige en fin de `/boucle --ameliorer` ou `/aiguiser --ameliorer`, D-071, D-076), `settings.json` (lecture de `.env` interdite). Schémas de ces processus (agents, flux de données) : `docs/agents/pipelines-ia.drawio`, une page par processus. +- `.claude/` : `rules/analyses.md` (se charge seule, voir « Analyses »), `agents/diagnostic.md` (point d'entrée de l'agent de diagnostic, D-046), `skills/nouvelle-analyse/` (procédure et modèle de fiche), `skills/nouveau-domaine/` (procédure pour un nouveau domaine), `skills/nouveau-cas/` (ajouter un cas à la base de l'agent de diagnostic, lancé par l'utilisateur seul), `skills/revue-cas/` avec l'agent `revue` (l'utilisateur valide, corrige ou rejette les cas appris par la boucle, D-075), `skills/anonymiser-cas/` (données d'un cas copiées dans son dossier, noms en codes, registre des codes, D-049, D-050), `skills/boucle/` et `skills/critiquer-lot/` avec les agents `analyste`, `upgrader`, `validateur`, `builder` (boucle automatique, D-057), `skills/lire-les-donnees/` (outils de lecture et leur mode d'emploi) et `skills/aiguiser/` avec les agents `lecteur`, `correcteur`, `optimiseur` (D-059), `agents/releveur.md` (difficultés des processus automatiques, D-060), `agents/ameliorateur.md` (les corrige en fin de `/boucle --ameliorer` ou `/aiguiser --ameliorer`, D-071, D-076), `settings.json` (lecture de `.env` interdite). Schémas de ces processus (agents, flux de données) : `docs/agents/pipelines-ia.drawio`, une page par processus. - `vues-deplacements/` : chantier à part des vues des déplacements et de l'agent dans une maquette (D-052) : contexte, cas réels (données, pages de la plateforme, parcours de l'utilisateur), puis le code ; sa carte : `vues-deplacements/CLAUDE.md` ; maquette de la page Explore avec les onglets View et Diagnosis dans `vues-deplacements/maquette/` (D-053, D-054) ; détecteurs du journal du matin dans `vues-deplacements/detectors/` (D-056) ; `extraction/` : pompage des données de la plateforme (D-056), à lancer par l'utilisateur dans le dev container de l'application (qui monte `~` : sortie directe dans `data/`) ; lecture seule ; mode d'emploi dans `extraction/README.md`. - `.devcontainer/devcontainer.json` : environnement de dev en conteneur (D-038), réseau de l'hôte pour joindre la caméra. `architecture.drawio` : schéma d'architecture tenu par l'utilisateur, à ne pas modifier sans demande. - `out/` : pages et JSON générés. Tout le projet est versionné, sauf `out/`, `data/` (D-065), `.venv/` et `__pycache__/` (D-014). diff --git a/docs/decisions.md b/docs/decisions.md index 76fb7e9..d189dcb 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -791,6 +791,14 @@ Règles du journal : - **Options écartées** : l'arbre de décision sur les données (Mermaid, puis draw.io) : trop gros, l'utilisateur veut les éventualités du terrain sans le détail des données ; une catégorie « Dérive lente » à part, alarmante. - **Conséquence** : un véhicule qui fait vibrer l'ouvrage ou la caméra (caméra sur un pont) va en **Saut bref** (l'utilisateur, 2026-10-27, plutôt que Passage : il ne passe pas devant les cibles, il fait bouger l'ouvrage ou la caméra un instant) ; le vent et les à-coups de la caméra ne sont plus des turbulences mais des sauts brefs. Reste à reporter les définitions dans la carte (section 4), `categories.py`, le vocabulaire des étiquettes et les détecteurs (point 49 du plan). + +## D-075 — 2026-10-27 — Base de cas : `/revue-cas`, l'expert revoit les cas appris par la boucle +- **Statut** : active ; complète D-057 (le builder ajoute des cas sans l'avis de l'expert). +- **Décision** : tout cas dont l'en-tête dit `non revalidé par l'expert` passe par `/revue-cas [C-xxx ...]`, lancé par l'utilisateur seul (`.claude/skills/revue-cas/`). L'agent `revue` (`.claude/agents/revue.md`) présente chaque cas : station et capteurs sous leurs vrais noms (registre), séance et lot d'origine, ce qu'en dit l'analyste, le diagnostic proposé, la page des détecteurs sur la plage de l'événement (`.claude/skills/boucle/detecteurs.py`), les figures, les points à trancher, le tout dans une page web, `out/revue-cas/C-xxx.html` (`.claude/skills/revue-cas/page.py` : la page des détecteurs, avec en tête la présentation et, dessous, la fiche, l'étiquetage, le rendu du builder, la critique du lot et toutes les figures du cas et du lot ; vrais noms, hors de git). L'orchestrateur ne recopie rien dans la conversation, demande « valider, corriger, rejeter, passer », renvoie les corrections au même agent, puis commite par chemin. Validé : l'en-tête devient `validé par l'expert le `, `(appris)` quitte le Verdict de l'index ; rejeté : le dossier du cas et sa ligne d'index disparaissent, le registre garde ses lignes. +- **Pourquoi** : demande de l'utilisateur : l'expert valide chaque cas, comme `/nouveau-cas` le prévoit ; la boucle tourne sans lui, la revue vient après, dans une conversation. +- **Options écartées** : la présentation dans la conversation (premier essai sur C-011 : l'utilisateur n'arrive pas à trancher sans les courbes et les images, il veut tout dans la page) ; un Workflow (outil de fond) : il ne peut pas poser de question à l'utilisateur ; l'agent qui pose lui-même la question (un sous-agent ne parle pas à l'utilisateur : l'orchestrateur relaie). +- **Conséquence** : le builder garde la phrase exacte `non revalidé par l'expert`, que `/revue-cas` cherche. + ## D-076 — 2026-10-27 — Aiguiser : `--ameliorer`, comme pour la boucle - **Statut** : active ; étend D-071 à `/aiguiser` (D-059). - **Décision** : `/aiguiser … --ameliorer` appelle, après le commit du releveur, le même agent `ameliorateur`, avec `Processus : /aiguiser. Commit du releveur : .` (l'appel de `/boucle` nomme aussi son processus). Il corrige au plus simple le skill `/aiguiser`, les agents `lecteur`, `correcteur`, `optimiseur`, `releveur`, `ameliorateur`, `vues-deplacements/aiguiser/voir.py`, la spec `aiguiser-la-lecture.md` et `run.md` ; l'orchestrateur commite par chemin (`Sharpen : process fixes`), sur la branche de la séance. @@ -805,3 +813,10 @@ Règles du journal : - **Options écartées** : basculer seul sur `master` en début de séance (dérangerait une autre session dans le même dépôt, comme pour D-070). - **Conséquence** : annuler une modification d'une séance passe par `git revert` de ses commits, depuis la base notée dans le bilan. + +## D-078 — 2026-10-27 — Aiguiser : la plage est le lot, sans découpe +- **Statut** : active ; remplace la découpe en lots de 4 jours de D-059, comme D-072 pour `/boucle`. +- **Décision** : une séance `/aiguiser` traite un seul lot, `lot-01`, de `--du` 00:00Z à `--au` 00:00Z (`--au` exclu ; sans eux, toute la période) ; plus d'option `--lot` (ignorée si donnée, notée sous « Erreurs »). +- **Pourquoi** : demande de l'utilisateur : « tout comme pour /boucle, il n'y a pas de lots de 4 jours. Le lot est simplement la plage que je donne. » +- **Options écartées** : garder la découpe avec 4 jours par défaut (séance trop longue : jusqu'à 11 agents par lot). +- **Conséquence** : une plage longue donne un seul lot, lu d'un seul tenant ; pour en voir plusieurs, plusieurs séances. diff --git a/run.md b/run.md index 97ce8d8..35bb97b 100644 --- a/run.md +++ b/run.md @@ -23,7 +23,7 @@ Dans une session Claude Code neuve, **en mode auto** (sinon elle s'arrête à ch ``` - `--ameliorer` (facultatif) : en fin de séance, l'améliorateur corrige le processus d'après les difficultés relevées ; l'enlever pour une séance sans correction (D-076). -- ``, `` : jours UTC, `AAAA-MM-JJ` ; la plage s'arrête à `` 00:00. Découpée en lots de 4 jours (`--lot ` pour changer) ; 4 jours exactement = un seul lot, par exemple `--du 2026-09-01 --au 2026-09-05`. +- ``, `` : jours UTC, `AAAA-MM-JJ` ; `` exclu (la plage s'arrête à `` 00:00). La plage est le lot, sans découpe : sa longueur se choisit par les dates (4 jours : `--du 2026-09-01 --au 2026-09-05`), D-078. - Sans `--du` ni `--au` : toute la période du dossier. - Le modèle et l'effort choisis pour la session valent pour tous ses agents (D-063). - La séance tourne seule, à lancer sur `master`, où elle commite directement (D-077), puis lance les commandes des fiches ; bilan dans `vues-deplacements/aiguiser/_/bilan.md`. @@ -69,3 +69,15 @@ python3 .claude/skills/boucle/benchmark.py ``` Détails : `.claude/skills/boucle/SKILL.md`. + +# Revoir les cas appris par la boucle + +Dans une conversation Claude Code, sur `master` : + +``` +/revue-cas [C-xxx ...] +``` + +- Sans argument, tous les cas dont la fiche dit `non revalidé par l'expert`. L'agent `revue` présente chacun (station et capteurs sous leurs vrais noms, séance d'origine, diagnostic proposé, figures, points à trancher) dans une page web, `out/revue-cas/C-xxx.html`, ouverte seule : sa présentation, la page des détecteurs sur la plage, la fiche, la critique du lot d'origine et toutes les figures ; on répond dans la conversation : valider, corriger (en clair), rejeter ou passer. Chaque cas validé ou rejeté est commité à part (D-075). + +Détails : `.claude/skills/revue-cas/SKILL.md`. diff --git a/vues-deplacements/boucle/2026-10-26T1643Z_CLARIDEN/lot-02/CLARIDEN_commun_20260922T0000Z_20260924T0000Z.png b/vues-deplacements/boucle/2026-10-26T1643Z_CLARIDEN/lot-02/CLARIDEN_commun_20260922T0000Z_20260924T0000Z.png new file mode 100644 index 0000000..af86fc6 Binary files /dev/null and b/vues-deplacements/boucle/2026-10-26T1643Z_CLARIDEN/lot-02/CLARIDEN_commun_20260922T0000Z_20260924T0000Z.png differ diff --git a/vues-deplacements/boucle/2026-10-26T1643Z_CLARIDEN/lot-02/CLARIDEN_multiples-error_value_20260922T0000Z_20260924T0000Z.png b/vues-deplacements/boucle/2026-10-26T1643Z_CLARIDEN/lot-02/CLARIDEN_multiples-error_value_20260922T0000Z_20260924T0000Z.png new file mode 100644 index 0000000..ba776b8 Binary files /dev/null and b/vues-deplacements/boucle/2026-10-26T1643Z_CLARIDEN/lot-02/CLARIDEN_multiples-error_value_20260922T0000Z_20260924T0000Z.png differ diff --git a/vues-deplacements/boucle/2026-10-26T1643Z_CLARIDEN/lot-02/CLARIDEN_residus-corr_x_20260922T0000Z_20260924T0000Z.png b/vues-deplacements/boucle/2026-10-26T1643Z_CLARIDEN/lot-02/CLARIDEN_residus-corr_x_20260922T0000Z_20260924T0000Z.png new file mode 100644 index 0000000..aa38b0d Binary files /dev/null and b/vues-deplacements/boucle/2026-10-26T1643Z_CLARIDEN/lot-02/CLARIDEN_residus-corr_x_20260922T0000Z_20260924T0000Z.png differ diff --git a/vues-deplacements/boucle/2026-10-26T1643Z_CLARIDEN/lot-02/CLARIDEN_residus-corr_y_20260922T0000Z_20260924T0000Z.png b/vues-deplacements/boucle/2026-10-26T1643Z_CLARIDEN/lot-02/CLARIDEN_residus-corr_y_20260922T0000Z_20260924T0000Z.png new file mode 100644 index 0000000..0253386 Binary files /dev/null and b/vues-deplacements/boucle/2026-10-26T1643Z_CLARIDEN/lot-02/CLARIDEN_residus-corr_y_20260922T0000Z_20260924T0000Z.png differ diff --git a/vues-deplacements/boucle/2026-10-26T1643Z_CLARIDEN/lot-02/CLARIDEN_residus-error_value_20260922T0000Z_20260924T0000Z.png b/vues-deplacements/boucle/2026-10-26T1643Z_CLARIDEN/lot-02/CLARIDEN_residus-error_value_20260922T0000Z_20260924T0000Z.png new file mode 100644 index 0000000..694908e Binary files /dev/null and b/vues-deplacements/boucle/2026-10-26T1643Z_CLARIDEN/lot-02/CLARIDEN_residus-error_value_20260922T0000Z_20260924T0000Z.png differ diff --git a/vues-deplacements/boucle/2026-10-26T1643Z_CLARIDEN/lot-02/CLARIDEN_vignettes_D-300-A-D-302_A-D-303-A_220000-220220-220230-220500-230230.png b/vues-deplacements/boucle/2026-10-26T1643Z_CLARIDEN/lot-02/CLARIDEN_vignettes_D-300-A-D-302_A-D-303-A_220000-220220-220230-220500-230230.png new file mode 100644 index 0000000..6f22160 Binary files /dev/null and b/vues-deplacements/boucle/2026-10-26T1643Z_CLARIDEN/lot-02/CLARIDEN_vignettes_D-300-A-D-302_A-D-303-A_220000-220220-220230-220500-230230.png differ diff --git a/vues-deplacements/boucle/2026-10-26T1643Z_CLARIDEN/lot-02/CLARIDEN_vignettes_D-301-C-D-302_A-P-299-A-D-301-A-D-300-C-D-304-B_220640-220650-220710-220720-220900-230720.png b/vues-deplacements/boucle/2026-10-26T1643Z_CLARIDEN/lot-02/CLARIDEN_vignettes_D-301-C-D-302_A-P-299-A-D-301-A-D-300-C-D-304-B_220640-220650-220710-220720-220900-230720.png new file mode 100644 index 0000000..daa4829 Binary files /dev/null and b/vues-deplacements/boucle/2026-10-26T1643Z_CLARIDEN/lot-02/CLARIDEN_vignettes_D-301-C-D-302_A-P-299-A-D-301-A-D-300-C-D-304-B_220640-220650-220710-220720-220900-230720.png differ diff --git a/vues-deplacements/boucle/2026-10-26T1643Z_CLARIDEN/lot-02/CLARIDEN_vignettes_PR-291-PR-293-P-298-B-P-298-C-P-299-B-D-304-B_221320-221330-221340.png b/vues-deplacements/boucle/2026-10-26T1643Z_CLARIDEN/lot-02/CLARIDEN_vignettes_PR-291-PR-293-P-298-B-P-298-C-P-299-B-D-304-B_221320-221330-221340.png new file mode 100644 index 0000000..551dbf8 Binary files /dev/null and b/vues-deplacements/boucle/2026-10-26T1643Z_CLARIDEN/lot-02/CLARIDEN_vignettes_PR-291-PR-293-P-298-B-P-298-C-P-299-B-D-304-B_221320-221330-221340.png differ diff --git a/vues-deplacements/boucle/2026-10-26T1643Z_CLARIDEN/lot-02/CLARIDEN_x-y-error_value_D-300-A-D-300-C-D-301-A-D-301-C-D-302_A-P-299-A-D-302-C-D-303-C-D-304-C_20260922T0000Z_20260922T1400Z.png b/vues-deplacements/boucle/2026-10-26T1643Z_CLARIDEN/lot-02/CLARIDEN_x-y-error_value_D-300-A-D-300-C-D-301-A-D-301-C-D-302_A-P-299-A-D-302-C-D-303-C-D-304-C_20260922T0000Z_20260922T1400Z.png new file mode 100644 index 0000000..55df361 Binary files /dev/null and b/vues-deplacements/boucle/2026-10-26T1643Z_CLARIDEN/lot-02/CLARIDEN_x-y-error_value_D-300-A-D-300-C-D-301-A-D-301-C-D-302_A-P-299-A-D-302-C-D-303-C-D-304-C_20260922T0000Z_20260922T1400Z.png differ