Events-learner: the analyst writes its own tools, a tool-builder brings them into agent-tools; /aiguiser retired (D-097)
- inventaire.py: what each source contains on the window (filled or empty columns, metric names, images), names and counts only - analyser-lot: step 0 on the data, own scripts in <lot>/outils/, section 3 "Outils" - tool-builder (the optimiser, rewritten): after the analyst, optimises or adds reading tools, never removes; no control yet - /aiguiser skill, reader, corrector and voir.py removed; its sessions and spec stay as history - docs: D-097, specs, CLAUDE.md, run.md, README, plan point 56; the shared files also carry another session's pending edits (D-096 entry, plan points 57 to 67) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
52de2becbf
commit
7fb176cf0a
24 files changed
+555
-513
No files matched your search
@@ -12,13 +12,13 @@ Cadrage du product owner : sous-projet G, santé des sites et notifications au c
|
||||
|
||||
- **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). 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`.
|
||||
- **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), 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, D-097) : l'analyste analyse, avec ses propres scripts au besoin, le `tool-builder` optimise ou ajoute les outils de lecture d'après ceux qui lui ont servi (`/aiguiser` retiré), 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 ;
|
||||
- la première séance de `/events-learner` avec les rôles revus, lancée par l'utilisateur (points 52 à 56 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.
|
||||
|
||||
@@ -62,7 +62,7 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .
|
||||
|
||||
- `[données]` : CSV ou dossiers ; défauts : `data/VERMONT/` (Energy), `data/WEISSHORN/` (Storage), `data/WEISSHORN/` et `data/NORDEND/` (Cellular, Temperature). Dates des maquettes en `AAAA-MM-JJ`, défaut 2026-09-18 à 2026-09-28 ; lancer les deux maquettes avec les mêmes dates (`2026-08-12 2026-08-22` montre des notifications Cellular).
|
||||
- Chaque script bascule seul sur `.venv` si plotly manque, puis ouvre sa page (navigateur Windows via `explorer.exe` sous WSL ; dans le dev container, la page reste dans `out/`).
|
||||
- Pompage, `/aiguiser`, `/events-learner`, `/review-event` : `run.md`.
|
||||
- Pompage, `/events-learner`, `/review-event` : `run.md`.
|
||||
- **Vérifier un changement** : pas de tests automatisés (D-008). Lancer `all_analyses.py`, et `final.py` pour le livré, sur le jeu de travail du domaine ; pour les détecteurs, le benchmark et la page des détecteurs.
|
||||
|
||||
## Carte du dépôt
|
||||
@@ -70,13 +70,13 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .
|
||||
### Lire sans saturer le contexte
|
||||
|
||||
- Fichier long (tailles en lignes ci-dessous) : lire son plan (`grep -n '^#' <fichier>`), puis la seule section utile (Read avec `offset` et `limit`).
|
||||
- `docs/decisions.md` (953 l, D-001 à D-095) : index par `grep -n '^## D-' docs/decisions.md`, puis l'entrée citée seulement ; son **Statut** dit si elle est remplacée.
|
||||
- `docs/decisions.md` (970 l, D-001 à D-097) : index par `grep -n '^## D-' docs/decisions.md`, puis l'entrée citée seulement ; son **Statut** dit si elle est remplacée.
|
||||
- `data/` : explorer par script (`common.stations.load_stations`, outils de `agent-tools/`), jamais en affichant les CSV.
|
||||
- Ne pas lire : `docs/superpowers/` (historique, sauf le plan vivant et la spec du support), `out/`, `.venv/`, `graphify-out/`.
|
||||
|
||||
### Racine
|
||||
|
||||
- `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.
|
||||
- `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`, `/events-learner`, `/review-event`). `push.sh "<message>"` : pull, commit de tout, push.
|
||||
|
||||
### `docs/`
|
||||
|
||||
@@ -97,15 +97,15 @@ python3 -m venv .venv && .venv/bin/pip install plotly matplotlib # recréer .
|
||||
|
||||
### 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, `events-learner`, 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, retiré), `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.
|
||||
- `detectors-view/` : le développement de la page des détecteurs (D-093), `detecteurs.py` : images, courbes, Status, catégories, Error rate ; `run-detectors.sh` : la page sur chaque station de `data/` ; `status.py` : la page Status, version pseudo finale de la page Explore du site : corr_x, corr_y, mouvement de la caméra, événements des détecteurs en plages colorées et en étiquettes cliquables au-dessus (sélection : ses capteurs, ses détails et son timelapse sous la figure, sans zoom) (D-094), occultés selon `hierarchie-des-status.md` (D-095, regroupement thermique suspendu) ; en haut, le data loader `data-loader/chargeur.py` (station, dates, « Analyse » ; son serveur, port 8766) ; la page des détecteurs est reprise par la page de fin de séance de `/events-learner` (`comparaison.py`) et par `/review-event`.
|
||||
- `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-learner/`, `aiguiser/` : les séances de `/events-learner` et de `/aiguiser`, retiré (D-084, D-097), une par dossier `<séance>_<STATION>/` (`lot-NN/`, `bilan.md`) ; historique, à ne lire que sur demande.
|
||||
- `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-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` ; optimisés ou complétés par le `tool-builder` de `/events-learner` (D-097).
|
||||
- `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.
|
||||
- `extraction/` : pompage `pomper.py` des données de la plateforme (D-056), en lecture seule, lancé par l'utilisateur dans le dev container de l'application de référence `~/monitoring-dashboard` ; mode d'emploi `extraction/README.md`.
|
||||
- `extraction/` : pompage `pomper.py` des données de la plateforme (D-056), en lecture seule, lancé par l'utilisateur dans le dev container de l'application de référence `~/monitoring-dashboard` ; sans argument, il met à jour jusqu'à maintenant les stations de `stations.txt` (D-096) ; mode d'emploi `extraction/README.md`.
|
||||
|
||||
### Code, données, configuration
|
||||
|
||||
@@ -115,7 +115,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`, `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).
|
||||
- `.claude/` : `rules/analyses.md` ; `agents/` : `diagnostic`, ceux de `/events-learner` (`analyste`, `tool-builder`, `detectors-critic`, `detectors-upgrader`, `detectors-control`, `event-builder`), `revue` (`/review-event`), `releveur` et `ameliorateur` (D-060, D-071) ; `skills/` : `support`, `events-learner`, `analyser-lot`, `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`.
|
||||
|
||||
@@ -124,7 +124,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 (`/events-learner`, `/aiguiser`) fait remonter ses difficultés : chaque sous-agent finit son rendu par `## Difficultés`, l'orchestrateur appelle le `releveur` en fin de processus, qui les note dans `docs/ameliorations-processus.md` (D-060). Pas dans une conversation ordinaire.
|
||||
- Un processus automatique à plusieurs agents (`/events-learner`) fait remonter ses difficultés : chaque sous-agent finit son rendu par `## Difficultés`, l'orchestrateur appelle le `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 (D-023).
|
||||
|
||||
|
||||
Reference in new issue
Block a user