L'app ne résout plus les liens (les agents voient data/ et labeling/) et donne leur cible à claude -p par --add-dir. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
20 lines
3.2 KiB
Markdown
20 lines
3.2 KiB
Markdown
# 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 sous-module : le dépôt detectors) 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.
|
|
|
|
- **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 sous-module `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. Après un commit dans `detectors/` : `git -C detectors push`, puis `git commit -m "..." -- detectors`.
|
|
- **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).
|
|
- **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).
|
|
|
|
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.
|
|
- 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).
|
|
- 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.
|