CLAUDE.md: state at 2026-10-29, events-learner roles, skill list and sizes

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-29 10:31:53 +01:00
1 parent 3b732adc52
commit 3d989b93ef
1 file changed
+8 -7
+8 -7
View File
@@ -8,16 +8,17 @@ Diagnostic proactif pour **AIMsight**, un système de surveillance optique de d
Cadrage du product owner : sous-projet G, santé des sites et notifications au client (`docs/aimsight/AIMsight_handoff_G_site_health.md`). Sa dernière section liste les écarts de ce dépôt, à arbitrer par l'utilisateur.
## État et prochaine étape (au 2026-10-28)
## État et prochaine étape (au 2026-10-29)
- **Domaines système, livrés en prototype** : Energy (D-020, D-043), Storage (D-034, D-035), Cellular (D-031, D-037), Temperature (D-040) ; chacun avec ses analyses, sa couleur du jour, sa figure du site, son bloc dans la vue client, sa notification support et son guide (D-039, D-041). Seul Energy repose sur des events de l'expert ; les autres ont des seuils provisoires et attendent le spécialiste.
- **Maquettes du site** (D-022, D-039) : client « System Summary », une page par station, un bloc par domaine ; support « Home », une notification par station et par domaine Orange ou Red, liée à la vue client (D-025).
- **Déplacements, le cap actuel : le journal du matin** (D-056). Une anomalie de déplacement est ce qui rend les courbes non plates : presque toujours un moment où il ne faut pas se fier aux données (pluie, buée, train, toile d'araignée, turbulence…), parfois un vrai mouvement (E-004, incident de Barcelone). Détecteurs élémentaires classés par catégorie (D-074), onglet `Journal` de la maquette Explore, amélioration par `/events-learner` (D-057) et `/aiguiser` (D-059), base d'events `events/` revue par `/review-event` (D-075). Tout le suivi est dans le plan vivant `docs/superpowers/plans/2026-10-23-journal-du-matin.md`.
- **Déplacements, le cap actuel : le journal du matin** (D-056). Une anomalie de déplacement est ce qui rend les courbes non plates : presque toujours un moment où il ne faut pas se fier aux données (pluie, buée, train, toile d'araignée, turbulence…), parfois un vrai mouvement (E-004, incident de Barcelone). Détecteurs élémentaires classés par catégorie (D-074), onglet `Journal` de la maquette Explore, amélioration par `/events-learner` (D-057) et `/aiguiser` (D-059), base d'events `events/` revue par `/review-event` (D-075). Rôles de `/events-learner` revus le 2026-10-29, un agent par responsabilité (D-088 à D-092) : l'analyste analyse, le `detectors-critic` juge les détecteurs, le `detectors-upgrader` les adapte, le `detectors-control` garde la base d'events, l'`event-builder` décide ce qui y entre ; la carte des événements apprend de chaque event validé (D-087). Tout le suivi est dans le plan vivant `docs/superpowers/plans/2026-10-23-journal-du-matin.md`.
- **Support** (D-079) : `/support <mail>` répond à la question d'un client, et à elle seule. Premier cas : LENZSPITZE, nuit du 26 au 27.10.
- **Agent de diagnostic** (D-046, D-058, D-082) : gardé dans le doute, pour un cas que les détecteurs n'expliquent pas.
- **En attente** : agents LLM côté serveur (D-027) et enquête par API (D-042), documents seulement ; communication avec la caméra (dev container, D-038), en attente de la doc de l'API REST ; détection des sauts et tendances (D-055, onglet `Displacements`), très expérimentale.
- **Prochaine étape** :
- journal du matin : les points ouverts du plan vivant, sur les consignes de l'utilisateur ; un point validé n'est plus repris ;
- la première séance de `/events-learner` avec les rôles revus, lancée par l'utilisateur (points 52 à 55 du plan) ; le releveur et l'améliorateur, communs aux processus automatiques, dans une autre conversation ;
- les écarts du handoff, dont « consistent with » face aux phrases catégoriques du journal, quand l'utilisateur les arbitre ;
- Cellular, Storage, Temperature : les réponses du spécialiste (`docs/<domaine>/domaine/questions-pour-l-expert.md`, pour Temperature la question 1 de `point-de-depart.md`), puis corrections et guides.
@@ -74,7 +75,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .
### Racine
- `README.md` : point d'entrée pour un humain. `run.md` (115 l) : les commandes que lance l'utilisateur (pompage, métriques de qualité par `~/optical_emulator`, `/aiguiser`, `/events-learner`, `/review-event`). `push.sh "<message>"` : pull, commit de tout, push.
- `README.md` : point d'entrée pour un humain. `run.md` (114 l) : les commandes que lance l'utilisateur (pompage, métriques de qualité par `~/optical_emulator`, `/aiguiser`, `/events-learner`, `/review-event`). `push.sh "<message>"` : pull, commit de tout, push.
### `docs/`
@@ -91,14 +92,14 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .
- `displacement/` : `cadrage.md` (158 l, séries optiques, D-044) ; `domaine/` : `ce-que-regarde-le-client.md` (sauts et tendances, D-055), `cas-annotes-par-l-expert.md` (les deux rapports d'analyse, sans données), `incident-de-barcelone.md` (E-004 : mouvement réel selon l'expert, instabilité des références selon la doc), `cycle-thermique.md`.
- `agents/` : `rapport-exploratoire.md` (292 l, agents LLM côté serveur, D-027), `enquete-a-la-demande.md` (233 l, D-042), `agent-diagnostic.md` (377 l, spec de l'agent), `pipelines-ia.drawio` (les processus automatiques, une page chacun).
- `ameliorations-faq.md` : idées pour la prochaine FAQ. `ameliorations-processus.md` : difficultés des processus automatiques, tenu par le `releveur` (D-060).
- `superpowers/` : specs et plans (110-1 300 l), historique non maintenu ; vivants : le plan `plans/2026-10-23-journal-du-matin.md` (1 290 l, index en tête) et `specs/2026-10-28-support-agent-design.md`. La spec d'une nouvelle analyse s'écrit dans sa fiche.
- `superpowers/` : specs et plans (110-1 450 l), historique non maintenu ; vivants : le plan `plans/2026-10-23-journal-du-matin.md` (1 440 l, index en tête) et `specs/2026-10-28-support-agent-design.md`. La spec d'une nouvelle analyse s'écrit dans sa fiche.
### Déplacements
- `vues-deplacements/` : le chantier des déplacements (D-052), avec sa propre carte, `vues-deplacements/CLAUDE.md` : `maquette/` (page Explore et `spec.md`, D-053 à D-056), `contexte/` (journal du matin, seuils, lissage, boucle, aiguisage), `cas/` (NORDEND, parcours de l'utilisateur), `benchmark/historique.csv` (D-069).
- `vues-deplacements/` : le chantier des déplacements (D-052), avec sa propre carte, `vues-deplacements/CLAUDE.md` : `maquette/` (page Explore et `spec.md`, D-053 à D-056), `contexte/` (journal du matin, seuils, lissage, `events-learner`, aiguisage), `cas/` (NORDEND, parcours de l'utilisateur), `benchmark/historique.csv` (D-069).
- `detectors/` : les détecteurs du journal (D-067, D-068, D-084), un détecteur élémentaire par fichier, contrat `detect(mesures)`, classés en événements par `categories.py` ; `archive/` : versions écartées.
- `events-learner/`, `aiguiser/` : les séances de `/events-learner` et `/aiguiser` (D-084), une par dossier `<séance>_<STATION>/` (`lot-NN/`, `bilan.md`) ; historique, à ne lire que sur demande. `aiguiser/voir.py` : ce que rendent les outils de lecture sur un lot.
- `events/` : **la base d'events, connaissance métier qui grandit** (D-048, D-080) : `INDEX.md` (le registre, seule porte d'entrée ; mode d'emploi : skill `read-event`, D-085), un dossier `E-xxx/` par event (`event.md` lisible d'abord par un humain, figures, données codées, `etiquettes.json`), validé par l'utilisateur ou « (appris) » par `/events-learner` en attendant `/review-event` ; `carte-des-evenements.md` (familles, catégories du journal) et `eventualites-et-categories.drawio`. Un event n'y entre que par `/new-event`, lancé par l'utilisateur, ou par l'event-builder de `/events-learner`.
- `events/` : **la base d'events, connaissance métier qui grandit** (D-048, D-080) : `INDEX.md` (le registre, seule porte d'entrée ; mode d'emploi : skill `read-event`, D-085), un dossier `E-xxx/` par event (`event.md` lisible d'abord par un humain, figures, données codées, `etiquettes.json`), validé par l'utilisateur ou « (appris) » par `/events-learner` en attendant `/review-event` ; `carte-des-evenements.md` (familles, catégories du journal, faux amis ; elle apprend de chaque event validé, D-087) et `eventualites-et-categories.drawio`. Un event n'y entre que par `/new-event`, lancé par l'utilisateur, ou par l'event-builder de `/events-learner`.
- `agent-tools/` : les outils de lecture des agents (D-081) : `donnees.py` (lecture commune, aussi des détecteurs), `inventaire`, `resume`, `plages`, `jours`, `ensemble`, `graphique`, `vignettes`, `gif` ; mode d'emploi : skill `lire-les-donnees`, aiguisé par `/aiguiser`.
- `agent-diagnostic/` : consignes (`instructions.md`, 146 l) et rapports de l'agent de diagnostic (D-082). Appel : `@agent-diagnostic data/<STATION>/ [question]`.
- `support/` : un dossier par demande d'un client (D-079), `<date>_<STATION>_<sujet>/` : `demande.md`, `analyse.md`, `reponse.md` (le mail prêt à envoyer), GIF des images. Contient des mails et images de clients.
@@ -112,7 +113,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .
- Jeux de travail : VERMONT pour Energy (D-009, le plus long historique) ; WEISSHORN pour Storage (D-034) ; WEISSHORN et NORDEND pour Cellular (D-030, D-032) et Temperature (D-040) ; à pomper s'ils manquent.
- WEISSHORN et NORDEND contiennent des identifiants (`SIM_CCID`, `ip`, `ip_*`) : ne pas les recopier.
- Les données des events restent, codées, dans `events/`.
- `.claude/` : `rules/analyses.md` ; `agents/` : `diagnostic`, ceux de `/events-learner` (`analyste`, `detectors-critic`, `detectors-upgrader`, `detectors-control`, `event-builder`), de `/aiguiser` (`lecteur`, `correcteur`, `optimiseur`), `revue` (`/review-event`), `releveur` et `ameliorateur` (D-060, D-071, D-076) ; `skills/` : `support`, `boucle`, `analyser-lot`, `aiguiser`, `lire-les-donnees`, `read-event`, `new-event`, `review-event`, `anonymize-event` (D-049, D-050), `nouvelle-analyse`, `nouveau-domaine` ; `settings.json` (lecture de `.env` interdite).
- `.claude/` : `rules/analyses.md` ; `agents/` : `diagnostic`, ceux de `/events-learner` (`analyste`, `detectors-critic`, `detectors-upgrader`, `detectors-control`, `event-builder`), de `/aiguiser` (`lecteur`, `correcteur`, `optimiseur`), `revue` (`/review-event`), `releveur` et `ameliorateur` (D-060, D-071, D-076) ; `skills/` : `support`, `events-learner`, `analyser-lot`, `aiguiser`, `lire-les-donnees`, `read-event`, `new-event`, `review-event`, `anonymize-event` (D-049, D-050), `nouvelle-analyse`, `nouveau-domaine` ; `settings.json` (lecture de `.env` interdite).
- `.devcontainer/` : environnement de dev en conteneur (D-038), réseau de l'hôte pour joindre la caméra. `out/` : pages et JSON générés.
- Tout est versionné (D-014), sauf `out/`, `data/`, `.venv/`, `__pycache__/`, `graphify-out/` et `.env`.