diff --git a/.claude/agents/builder.md b/.claude/agents/builder.md index 61777ff..a7710a5 100644 --- a/.claude/agents/builder.md +++ b/.claude/agents/builder.md @@ -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 - : créée (C-006) | déjà connue (C-00x) + +## Difficultés +aucune | - ``` +« 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. diff --git a/.claude/agents/releveur.md b/.claude/agents/releveur.md new file mode 100644 index 0000000..d475037 --- /dev/null +++ b/.claude/agents/releveur.md @@ -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. diff --git a/.claude/agents/upgrader.md b/.claude/agents/upgrader.md index c0c9339..8fec11d 100644 --- a/.claude/agents/upgrader.md +++ b/.claude/agents/upgrader.md @@ -60,8 +60,13 @@ aucune | ## Nouveautés aucune | - + +## Difficultés +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). + ## Ta réponse En 3 lignes : ce qui a changé, ce qui n'a pas été corrigé, le chemin du rendu. diff --git a/.claude/agents/validateur.md b/.claude/agents/validateur.md index 727d270..5ccb8c9 100644 --- a/.claude/agents/validateur.md +++ b/.claude/agents/validateur.md @@ -52,9 +52,12 @@ aucune | 1. … (au plus trois) ## Nouveautés aucune | - + +## Difficultés +aucune | - ``` -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 diff --git a/.claude/skills/boucle/SKILL.md b/.claude/skills/boucle/SKILL.md index 7e33862..e76d3a4 100644 --- a/.claude/skills/boucle/SKILL.md +++ b/.claude/skills/boucle/SKILL.md @@ -7,7 +7,7 @@ argument-hint: " [--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 | Commit `/bilan.md`, message `Loop : 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 : / : la section « Difficultés » de chaque rendu des lots, et « Erreurs » du bilan. Difficultés de l'orchestrateur : aucune | .` (D-060) +Si `git status --short docs/ameliorations-processus.md` montre un changement : commit de ce chemin, message `Loop : 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. diff --git a/.claude/skills/critiquer-lot/SKILL.md b/.claude/skills/critiquer-lot/SKILL.md index 5ed2f87..87b0982 100644 --- a/.claude/skills/critiquer-lot/SKILL.md +++ b/.claude/skills/critiquer-lot/SKILL.md @@ -65,10 +65,13 @@ Ceux de `lire-les-donnees`, avec `--debut` et `--fin` du lot et `--sortie +## Difficultés +aucune | - + ## 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 diff --git a/CLAUDE.md b/CLAUDE.md index 1aad027..e75af8e 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -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/`. +- 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. diff --git a/docs/ameliorations-processus.md b/docs/ameliorations-processus.md new file mode 100644 index 0000000..8569231 --- /dev/null +++ b/docs/ameliorations-processus.md @@ -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` = `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). diff --git a/docs/decisions.md b/docs/decisions.md index 611cd5b..e352a70 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -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. diff --git a/vues-deplacements/contexte/boucle-automatique.md b/vues-deplacements/contexte/boucle-automatique.md index 5af290d..3888e92 100644 --- a/vues-deplacements/contexte/boucle-automatique.md +++ b/vues-deplacements/contexte/boucle-automatique.md @@ -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 , séance , 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/_` : 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