Diagnostic-App, le poste de pilotage : l'analyste et le tool-builder du dépôt agents, l'optimisation par Optimizer, la lecture par tools
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
dd6f1bfb38
commit
23e1eea0b8
24 files changed
+183
-3110
No files matched your search
@@ -1,19 +1,20 @@
|
||||
# CLAUDE.md
|
||||
|
||||
Diagnostic-app : la web app de diagnostic AIMsight et les agents qu'elle lance par `claude -p` (`README.md`). Une caméra suit des cibles sur un ouvrage ; les détecteurs (`detectors/`, un lien vers le dépôt `~/detectors`, partagé avec Optimizer) lisent les séries de déplacement des stations (`data/<STATION>/`, un lien vers `~/aimsight-data/data`, rempli par le pompage de ce dépôt) et signalent les moments où il ne faut pas se fier aux courbes (pluie, buée, toile d'araignée, turbulence…) ou un vrai mouvement.
|
||||
Diagnostic-app : le poste de pilotage du diagnostic AIMsight (`README.md`) : la web app, et le lancement de processus dont le code vit ailleurs. Une caméra suit des cibles sur un ouvrage ; les détecteurs lisent les séries de déplacement des stations et signalent les moments où il ne faut pas se fier aux courbes (pluie, buée, toile d'araignée, turbulence…) ou un vrai mouvement. L'architecture des dépôts : `docs/architecture.drawio`.
|
||||
|
||||
- **Les processus** : l'onglet Analysis lance l'`analyste` sur une plage (étiquettes et rapport dans `labeling/auto/analyses/<STATION>_<début>_<fin>/`, versées dans `labeling/auto/<STATION>.jsonl`) ; « Optimiser les détecteurs » lance `/detectors:wf-improve` sur la plage de l'analyse (le plugin du dépôt detectors, `claude --plugin-dir detectors` ; la requête dans `app/serveur/analyse.py`, son bilan dans `<analyse>/detectors/<heure>/summary.md`), qui commite dans `detectors/`, puis le `tool-builder`, qui commite les outils ici.
|
||||
- **La vérité** : les étiquettes de `labeling/auto/` ; le savoir du labeling est dans `labeling/` (règles, familles, carte, connaissances). `labeling/` est un lien vers le dépôt `~/labeling`, partagé avec Optimizer : on y commite les étiquettes, pas ici.
|
||||
- **Les détecteurs** : le contrat entre l'app et eux est dans `detectors/CLAUDE.md` (`categories.events`, la requête de `/detectors:wf-improve`, les CLI `--from/--to`) ; un renommage là-bas demande le changement ici. `agent-tools/donnees.py` et `detectors/scripts/data.py` lisent les mêmes mesures : une correction de lecture dans l'un se reporte dans l'autre. Un commit dans `detectors/` est un commit du dépôt `~/detectors` : rien à commiter ici, et Optimizer a aussitôt la même version.
|
||||
- **Le benchmark** : `python3 detectors/skills/wf-improve/scripts/regression.py --labels labeling/auto --data data` (~3 min) ; le score d'une plage : `python3 detectors/skills/wf-improve/scripts/score.py data/<STATION> --labels labeling/auto/<STATION>.jsonl --from AAAA-MM-JJ --to AAAA-MM-JJ` (`--to` exclu).
|
||||
- **Les processus** : l'onglet Analysis lance `agents:analyste` (plugin `agents/`) sur une plage, avec `consignes/analyste.md` et `DETECTEURS : non` (étiquettes et rapport dans `labeling/auto/analyses/<STATION>_<début>_<fin>/`, versées dans `labeling/auto/<STATION>.jsonl`) ; « Optimiser les détecteurs » lance `/improve` dans `optimizer/` (sa requête dans `app/serveur/analyse.py`, son bilan dans `optimizer/seances/<analyse>_<heure>/summary.md`), qui commite dans `detectors/`, puis `agents:tool-builder`, qui commite dans `tools/`.
|
||||
- **Les liens** (ignorés par git, un exemplaire de chaque dépôt sur le poste) : `data/`, `labeling/`, `detectors/`, `tools/`, `agents/`, `optimizer/` ; on commite chaque chose dans son dépôt, jamais ici. Ce dépôt ne porte ni agent, ni outil de lecture, ni workflow.
|
||||
- **La vérité** : les étiquettes de `labeling/auto/` ; le savoir du labeling est dans `labeling/`.
|
||||
- **Les contrats** : avec les détecteurs, `detectors/CLAUDE.md` (`categories.events`, `bench/score.py`) ; avec les agents, `agents/README.md` (les requêtes de l'analyste et du tool-builder) ; avec Optimizer, `optimizer/README.md` (la requête de `/improve`). Un renommage là-bas demande le changement ici.
|
||||
- **Le benchmark** : `python3 detectors/bench/regression.py --labels labeling/auto --data data` (~3 min) ; le score d'une plage : `python3 detectors/bench/score.py data/<STATION> --labels labeling/auto/<STATION>.jsonl --from AAAA-MM-JJ --to AAAA-MM-JJ` (`--to` exclu).
|
||||
- **Le pompage** : dans `~/aimsight-data` (`extraction/pomper.sh`, tâches VS Code **pomper**, **pomper une plage**), en lecture seule sur la plateforme ; mode d'emploi `~/aimsight-data/extraction/README.md`. Claude peut le lancer sur de petites plages ; une longue plage ou un historique, hors des heures chargées.
|
||||
- **Vérifier un changement de l'app** : `.venv/bin/python app/serveur/check.py`, puis `cd app/web && npm run build` et lancer le serveur. Les étiquettes : `python3 labeling/controle.py` (les 18 étiquettes versées par l'app n'ont pas encore `revue`, qu'elle exige : 18 erreurs attendues).
|
||||
- **Vérifier un changement de l'app** : `.venv/bin/python app/serveur/check.py`, puis `cd app/web && npm run build` et lancer le serveur. Les étiquettes : `python3 labeling/controle.py`.
|
||||
|
||||
Règles :
|
||||
- Toute heure est en UTC.
|
||||
- Bibliothèque standard pour les détecteurs et les outils de lecture ; matplotlib par `.venv/bin/python`, pour les figures seulement.
|
||||
- Pas de règle propre à une station, une cible ou une date dans les détecteurs.
|
||||
- Pas de règle propre à une station, une cible ou une date.
|
||||
- Lecture seule sur `data/`, sauf le pompage ; ne jamais recopier les identifiants des métriques (`SIM_CCID`, `ip*`).
|
||||
- Ne jamais lire `.env` (les identifiants de la plateforme).
|
||||
- Les agents tournent sur l'abonnement Claude, jamais sur une clé d'API.
|
||||
- Commits par chemin, jamais `git add -A` : une autre session peut travailler dans ce dépôt.
|
||||
- Langue : documents et échanges en français ; ce qui va au client en anglais.
|
||||
Reference in new issue
Block a user