Files
aimsight-app/CLAUDE.md
T

2.9 KiB

CLAUDE.md

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 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.

Règles :

  • Toute heure est en UTC.
  • 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.