Add the releveur agent for difficulties in automatic processes (D-060)

Each /boucle subagent now ends its output with a Difficultés section;
at the end of a session the orchestrator calls the releveur once, which
locates the instruction or file at fault and records it in
docs/ameliorations-processus.md, without fixing anything.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-24 16:22:30 +02:00
1 parent 3281f5c601
commit 260d7f70fc
10 files changed
+91 -10

No files matched your search

+5
View File
@@ -39,8 +39,13 @@ Le dossier de station, le lot (UTC), le dossier du lot (ses rendus : `critique.m
**Cas créés** : C-006, C-007 | aucun
- <nouveauté> : créée (C-006) | déjà connue (C-00x)
## Difficultés
aucune | - <ce qui a gêné ton travail : consigne floue, contradictoire ou absente qui t'a fait deviner, fichier ou chemin introuvable, format inattendu, commande qui échoue ; où, et ce que tu as fait à la place>
```
« Difficultés » ne parle que du processus (consignes, chemins, outils), pas des données : un releveur les note pour l'utilisateur (D-060).
## Ta réponse
En 2 lignes : les cas créés, le chemin du rendu.
+29
View File
@@ -0,0 +1,29 @@
---
name: releveur
description: Releveur des processus automatiques (/boucle et les pipelines à venir) — documente dans docs/ameliorations-processus.md les difficultés que les sous-agents et l'orchestrateur ont remontées (consigne floue ou contradictoire, chemin, format, commande). Appelé par l'orchestrateur en fin de processus. Ne corrige rien.
tools: Read, Bash, Edit
model: opus
---
Tu es le releveur. Les processus automatiques du projet tournent sans l'utilisateur : quand un agent bute sur une consigne, un chemin ou une commande, personne ne le voit. En fin de processus, l'orchestrateur te transmet les difficultés remontées ; tu les documentes dans `docs/ameliorations-processus.md`. L'utilisateur s'en servira plus tard, dans une autre conversation, pour améliorer les processus. **Tu ne corriges rien.**
## Ta demande
Le processus et son skill, le dossier de ses rendus et où y lire les difficultés (pour `/boucle` : la section `## Difficultés` de chaque rendu des lots, et `## Erreurs` du bilan), et celles de l'orchestrateur lui-même.
## Ce que tu fais
1. Lis `docs/ameliorations-processus.md`, puis les difficultés.
2. Pour chacune, retrouve ce qui est en cause : la consigne (`grep -n` dans le skill du processus, `.claude/agents/`, `.claude/skills/`, la spec que cite le skill), le fichier, le chemin ou la commande, et cite-le en `fichier:ligne`. Vérifie le fait quand c'est simple (le chemin existe-t-il ? la consigne dit-elle bien ça ?) ; sinon, rapporte ce qu'en dit l'agent, en le disant.
3. Même cause qu'une entrée déjà notée et pas **traitée** : ajoute l'occurrence à cette entrée. Sinon, une entrée nouvelle sous la rubrique du processus (crée la rubrique s'il le faut), au format du document.
4. Écarte ce qui n'est pas une difficulté du processus : un agent qui décrit seulement son travail, un défaut des détecteurs ou des données (c'est le travail de la boucle, pas un accroc).
## Règles
- Tu n'écris que dans `docs/ameliorations-processus.md` : aucune consigne, aucun code, aucun rendu touché ; tu ne relances rien et tu ne commites pas.
- Tu décris le problème et sa cause, pas la correction : une piste d'une phrase au plus, et seulement si elle est évidente.
- Aucun identifiant (`SIM_CCID`, `ip`) ; heures en UTC.
## Ta réponse
En 3 lignes : les entrées créées, les occurrences ajoutées, les difficultés écartées et pourquoi.
+5
View File
@@ -60,8 +60,13 @@ aucune | <ce qui reste, et pourquoi>
## Nouveautés
aucune | - <ce que tu as découvert de nouveau sur les données, s'il y a lieu>
## Difficultés
aucune | - <ce qui a gêné ton travail : consigne floue, contradictoire ou absente qui t'a fait deviner, fichier ou chemin introuvable, format inattendu, commande qui échoue ; où, et ce que tu as fait à la place>
```
« Difficultés » ne parle que du processus (consignes, chemins, outils), pas des données ni des détecteurs : un releveur les note pour l'utilisateur (D-060).
## Ta réponse
En 3 lignes : ce qui a changé, ce qui n'a pas été corrigé, le chemin du rendu.
+4 -1
View File
@@ -52,9 +52,12 @@ aucune | 1. … (au plus trois)
## Nouveautés
aucune | - <ce que tu as découvert de nouveau sur les données, s'il y a lieu>
## Difficultés
aucune | - <ce qui a gêné ton travail : consigne floue, contradictoire ou absente qui t'a fait deviner, fichier ou chemin introuvable, format inattendu, commande qui échoue ; où, et ce que tu as fait à la place>
```
La ligne Verdict porte un seul de ces mots ; l'orchestrateur la lit telle quelle. Au passage 3, tu n'as plus que deux réponses : « garder » si la modification va dans le bon sens, « annuler » sinon.
« Difficultés » ne parle que du processus (consignes, chemins, outils), pas des données ni des détecteurs : un releveur les note pour l'utilisateur (D-060). La ligne Verdict porte un seul de ces mots ; l'orchestrateur la lit telle quelle. Au passage 3, tu n'as plus que deux réponses : « garder » si la modification va dans le bon sens, « annuler » sinon.
## Ta réponse
+8 -3
View File
@@ -7,7 +7,7 @@ argument-hint: "<dossier de station> [--du AAAA-MM-JJ] [--au AAAA-MM-JJ] [--lot
# La boucle automatique
Tu es l'orchestrateur. Tu découpes la plage en lots, tu appelles les quatre agents dans l'ordre, tu transmets leurs rendus et tu commites. **Tu ne juges rien toi-même** : tu lis seulement les lignes de verdict. **Tu ne poses aucune question à l'utilisateur** : la séance tourne seule jusqu'au bout. Spec : `vues-deplacements/contexte/boucle-automatique.md`.
Tu es l'orchestrateur. Tu découpes la plage en lots, tu appelles les quatre agents dans l'ordre, tu transmets leurs rendus et tu commites ; en fin de séance, le releveur note leurs difficultés. **Tu ne juges rien toi-même** : tu lis seulement les lignes de verdict. **Tu ne poses aucune question à l'utilisateur** : la séance tourne seule jusqu'au bout. Spec : `vues-deplacements/contexte/boucle-automatique.md`.
## 1. Mise en place
@@ -72,6 +72,11 @@ aucune | <lot, agent, ce qui manquait>
Commit `<séance>/bilan.md`, message `Loop <STATION>: bilan`.
## 6. Réponse finale
## 6. Difficultés
En 5 lignes au plus : la branche, le chemin du bilan, le nombre de modifications gardées et de cas créés, les erreurs. Reste sur la branche : l'utilisateur la fusionne, en garde une partie ou revient en arrière.
**Releveur** (`releveur`), une fois, même si tout s'est bien passé : `Processus : /boucle (.claude/skills/boucle/SKILL.md). Séance : <séance>/ : la section « Difficultés » de chaque rendu des lots, et « Erreurs » du bilan. Difficultés de l'orchestrateur : aucune | <une consigne de ce skill qui t'a fait deviner, une commande qui a échoué…>.` (D-060)
Si `git status --short docs/ameliorations-processus.md` montre un changement : commit de ce chemin, message `Loop <STATION>: process difficulties`.
## 7. Réponse finale
En 5 lignes au plus : la branche, le chemin du bilan, le nombre de modifications gardées et de cas créés, les erreurs, les difficultés relevées. Reste sur la branche : l'utilisateur la fusionne, en garde une partie ou revient en arrière.
+4 -1
View File
@@ -65,10 +65,13 @@ Ceux de `lire-les-donnees`, avec `--debut` et `--fin` du lot et `--sortie <dossi
## Nouveautés
aucune | - <moment, capteurs, ce qui le montre, figure>
## Difficultés
aucune | - <ce qui a gêné ton travail : consigne floue, contradictoire ou absente qui t'a fait deviner, fichier ou chemin introuvable, format inattendu, commande qui échoue ; où, et ce que tu as fait à la place>
## Sources lues
```
La ligne Verdict porte un seul mot : `d'accord` ou `suggestions`. Sans suggestion, la partie 5 dit « aucune ». Les figures sont dans le dossier de sortie, citées par leur nom. Heures en UTC.
La ligne Verdict porte un seul mot : `d'accord` ou `suggestions`. Sans suggestion, la partie 5 dit « aucune ». « Difficultés » ne parle que du processus (consignes, chemins, outils), pas des données ni des détecteurs : un releveur les note pour l'utilisateur (D-060). Les figures sont dans le dossier de sortie, citées par leur nom. Heures en UTC.
## Ta réponse
+5 -5
View File
@@ -107,7 +107,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .
### Fichiers
- `README.md` (40 l) : point d'entrée pour un humain.
- `docs/decisions.md` (665 l, D-001 à D-058) : décisions **projet**, au format ADR allégé (statut, décision, pourquoi, options écartées, conséquence). À consulter avant de changer d'orientation ou de reproposer une option : elle a peut-être déjà été écartée.
- `docs/decisions.md` (665 l, D-001 à D-060) : décisions **projet**, au format ADR allégé (statut, décision, pourquoi, options écartées, conséquence). À consulter avant de changer d'orientation ou de reproposer une option : elle a peut-être déjà été écartée.
- `docs/domaine/` : savoir métier commun, une note courte (< 50 l) par question.
- `ce-que-mesure-la-station.md` : format CSV, métriques et unités, consommation mesurée mais pas l'apport.
- `pieges-des-donnees.md` : trou ≠ coupure, signatures d'une coupure, seuils absolus, cycle jour/nuit.
@@ -129,7 +129,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .
- Les deux docs prévoient un LLM/agent pour la synthèse : la couche déterministe reste 100 % analytique ; la couche d'agents côté serveur (D-027) reprend cette idée, en exploration.
- `AIMsight FAQ.pdf`, `AIMsight Test Manual.pdf` (en réalité le manuel de la station) : définitions des signaux et des colonnes CSV, alimentation, schedules. `Mur de soutènement GN-1.472.pdf`, `GN-5.054.pdf` : rapports d'analyse remis au client (mai 2026, en français).
- `collecteur_system_info.py` : copie de référence du collecteur `system_info` embarqué (INA219, table OCV LiFePO4, compensation IR 0,34 Ω). Source des unités. Ne pas modifier.
- `docs/ameliorations-faq.md` : carnet d'idées pour la prochaine révision de la FAQ, une entrée par idée sous la rubrique de la FAQ qu'elle concerne ; la réécriture viendra ensuite.
- `docs/ameliorations-faq.md` : carnet d'idées pour la prochaine révision de la FAQ, une entrée par idée sous la rubrique de la FAQ qu'elle concerne ; la réécriture viendra ensuite. `docs/ameliorations-processus.md` : carnet des difficultés des processus automatiques, tenu par le `releveur` (D-060).
- `docs/superpowers/` : specs et plans superpowers (170-850 l chacun). Historique non maintenu, pas une référence. La spec d'une nouvelle analyse s'écrit dans sa fiche ; le plan peut aller dans `docs/superpowers/plans/`.
- `data/` : un dossier par station (D-029).
- `VERMONT/` : **jeu de travail = VERMONT seule** (D-009), le plus long historique : 7 CSV, un par métrique système (~5 000 l chacun). Les analyses Energy tournent uniquement sur ce jeu (défaut des scripts).
@@ -144,7 +144,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), `settings.json` (lecture de `.env` interdite).
- `.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), `agents/releveur.md` (difficultés des processus automatiques, D-060), `settings.json` (lecture de `.env` interdite).
- `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/journal/` (D-056) ; `extraction/` : pompage des données de la plateforme (D-056), à lancer par l'utilisateur dans le dev container de l'application ; brouillon jamais lancé, 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/`, `.venv/` et `__pycache__/` (D-014).
@@ -154,6 +154,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .
- Une décision projet prise en conversation donne une entrée dans `docs/decisions.md`.
- Toute modification d'une analyse met à jour sa fiche dans le même changement.
- Un savoir métier nouveau va dans `docs/domaine/` (commun) ou `docs/<domaine>/domaine/`.
- Un processus automatique à plusieurs agents (aujourd'hui `/boucle`) fait remonter ses difficultés : chaque sous-agent finit son rendu par `## Difficultés`, l'orchestrateur appelle l'agent `releveur` en fin de processus, qui les note dans `docs/ameliorations-processus.md` (D-060). Pas dans une conversation ordinaire.
- Un changement de cap met à jour « État et prochaine étape » ci-dessus : l'état courant, pas un historique.
- Langue : échanges et documents projet en français ; documentation AIMsight en anglais (garder ses termes techniques) ; tout ce qui va au site en anglais, figure état × tendance comprise (D-023).
@@ -194,6 +195,5 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .
## Environnement
- `pandas` n'est pas installé ; la bibliothèque standard suffit pour explorer les CSV (`csv`, `datetime.fromisoformat`).
- `.venv/` (Python 3.14) ne contient que plotly et matplotlib (graphiques de l'agent de diagnostic), pour le poste de dev. Le code d'analyse reste en bibliothèque standard.
- `pandas` n'est pas installé ; la bibliothèque standard suffit pour explorer les CSV (`csv`, `datetime.fromisoformat`). `.venv/` (Python 3.14) ne contient que plotly et matplotlib (graphiques de l'agent de diagnostic), pour le poste de dev. Le code d'analyse reste en bibliothèque standard.
- Dev container (D-038) : Docker Engine dans WSL (réseau `mirrored`), VS Code « Reopen in Container » ; dans le conteneur, les pages restent dans `out/` sans s'ouvrir seules.
+15
View File
@@ -0,0 +1,15 @@
# Améliorer les processus automatiques
Carnet des difficultés rencontrées par les processus automatiques du projet (aujourd'hui `/boucle`), tenu par l'agent `releveur` (D-060). Chaque sous-agent finit son rendu par une section `## Difficultés` ; en fin de processus, l'orchestrateur les transmet au releveur, qui les note ici. Les corrections se font ensuite, dans une conversation à part, à partir de ce carnet.
## Comment noter une difficulté
Une entrée par cause, sous la rubrique du processus :
- **Titre court** (AAAA-MM-JJ, *consigne floue* | *contradiction* | *consigne absente* | *chemin* | *format* | *commande* | *autre*) : ce qui s'est passé, en une ou deux phrases. *En cause* : `fichier:ligne` (la consigne, le fichier ou la commande). *Occurrences* : séance, lot, agent ; une par ligne ou séparées par « ; ». *Piste* (facultative) : une phrase.
Une même cause revue ajoute une occurrence, pas une entrée. Quand le processus est corrigé, l'entrée prend la mention **traité**.
## /boucle
- **Nom de la branche de séance** (2026-10-24, *contradiction*) : le skill nomme la branche avec l'heure (`boucle/<SEANCE>_<STATION>`, `SEANCE` = `date -u +%Y-%m-%dT%H%MZ`), la spec avec le jour seul (`boucle/<AAAA-MM-JJ>_<STATION>`), 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).
+11
View File
@@ -663,3 +663,14 @@ Règles du journal :
- **Pourquoi** : demande de l'utilisateur, qui est l'expert : les détecteurs calculent sans finesse, l'agent sait raisonner avec une base de connaissances. Sur CLARIDEN, avant C-004 (rapport `2026-10-15T1346Z_CLARIDEN_19-09-matin`), l'agent avait relevé les faits mais conclu à un mouvement de caméra mal compensé, conséquence indéterminée ; l'expert y voit un mouvement réel : toutes les cibles corrigées vont dans le même sens au même moment, aucune anomalie documentée ne l'explique, et des références réparties ne bougent pas toutes ensemble.
- **Options écartées** : un nouvel agent à côté de `diagnostic` (le même outil, à faire évoluer) ; écrire pour lui le raisonnement de l'expert sur les références (refus de l'utilisateur : c'est à l'agent de comprendre) ; fusionner avec l'analyste (l'analyste critique la méthode et nourrit la base ; l'agent de diagnostic sert un cas).
- **Conséquence** : ses outils propres, pour plus de précision, restent à faire (autre conversation) ; vérification proposée, non lancée : CLARIDEN repassé sans C-004 ni `incident-de-barcelone.md`. Spec : `docs/agents/agent-diagnostic.md`.
## D-060 — 2026-10-24 — Processus automatiques : un releveur des difficultés
- **Statut** : active ; complète D-057.
- **Décision** :
- dans un processus automatique à plusieurs agents, où l'utilisateur n'est pas là pour voir ce qui coince (aujourd'hui `/boucle`), chaque sous-agent finit son rendu par une section `## Difficultés` : consigne floue, contradictoire ou absente qui l'a fait deviner, fichier ou chemin introuvable, format inattendu, commande qui échoue ; « aucune » sinon ; seulement le processus, pas les données ni les détecteurs ;
- en fin de processus, l'orchestrateur appelle une fois l'agent `releveur` (`.claude/agents/releveur.md`) avec ces rendus et ses propres difficultés ; le releveur retrouve la consigne ou le fichier en cause (`fichier:ligne`), regroupe les occurrences d'une même cause et note tout dans `docs/ameliorations-processus.md`, une rubrique par processus ; il ne corrige rien ;
- les corrections se font ensuite, à la main, dans une conversation à part qui part de ce carnet : pas d'agent pour elles ;
- les conversations ordinaires, où l'utilisateur suit l'agent en direct, n'ont pas ce mécanisme.
- **Pourquoi** : demande de l'utilisateur : les processus sont perfectionnables (prompts, chemins, formats, contradictions), mais personne ne lit tout ce que font les agents ; le seul moyen de les améliorer est qu'une difficulté soit relevée et centralisée au moment où elle arrive.
- **Options écartées** : relire après coup les transcriptions des séances (l'utilisateur veut un agent à l'écoute, à qui l'on transmet ; un agent qui fouille le projet de lui-même reste une piste) ; laisser chaque sous-agent appeler le releveur (un sous-agent ne peut pas lancer d'agent : tout passe par l'orchestrateur) ; un appel à chaque difficulté (plus cher, inutile puisque rien n'est corrigé sur le moment).
- **Conséquence** : un processus automatique nouveau reprend le même circuit (section `## Difficultés`, appel du releveur en fin de processus). Le nom de l'agent est un choix de Claude.
@@ -106,10 +106,15 @@ Il construit la base de connaissances (l'utilisateur). Outils : Read, Bash, Writ
- **Marqué « appris »** *(choix de Claude)*, pour la revalidation à la main, plus tard : en tête de fiche, « Appris par la boucle le <date>, séance <dossier>, non revalidé par l'expert » ; dans l'index, le Verdict commence par « (appris) ».
- Il ne touche jamais aux cas existants. Il ne passe pas par `/nouveau-cas` (ni passage à l'aveugle, ni validation) : les cas appris s'ajoutent sans attendre (l'utilisateur : « ça ne peut pas vraiment faire de mal »).
### Releveur : `.claude/agents/releveur.md` (D-060)
Ajouté le 2026-10-24, commun à tous les processus automatiques. Chaque rendu finit par `## Difficultés` (consigne floue, contradictoire ou absente, chemin, format, commande ; « aucune » sinon). En fin de séance, l'orchestrateur l'appelle une fois, avec ses propres difficultés ; il retrouve la consigne ou le fichier en cause, regroupe les occurrences d'une même cause et note tout dans `docs/ameliorations-processus.md`. Il ne corrige rien : l'utilisateur s'en sert ensuite, dans une autre conversation.
## 6. Ce que l'utilisateur trouve à la fin
- La branche `boucle/<AAAA-MM-JJ>_<STATION>` : un commit par étape, lisible avec `git log` ; il la fusionne, n'en garde qu'une partie, ou revient en arrière.
- `bilan.md` : une ligne par lot (verdict de l'analyste ; modification gardée, annulée ou aucune ; cas créés) ; les suggestions non traitées (nouvelle catégorie, au-delà de deux) ; les nouveautés déjà connues ; les erreurs.
- `docs/ameliorations-processus.md` : les difficultés du processus relevées pendant la séance.
## 7. Essai et première séance