Files
aimsight-tools/CLAUDE.md
T

1.5 KiB

CLAUDE.md

tools : le harnais de lecture des agents AIMsight (README.md), et rien d'autre. Le mode d'emploi est GUIDE.md ; un outil nouveau ou une option nouvelle y entre dans le même changement.

  • Vérifier un changement : relancer l'outil touché depuis un dépôt appelant (Diagnostic-App : python3 tools/scripts/<outil>.py data/<STATION> --debut … --fin …), et les commandes du guide qui l'emploient ; python3 scripts/qualite.py --essai.

Règles :

  • Un outil rend des valeurs : ni seuil, ni catégorie, ni « anomalie », ni « normal » ; l'analyste juge.
  • Rien de propre à une station, un capteur ou une date.
  • Aucun import des détecteurs (detectors/).
  • Bibliothèque standard ; matplotlib, par .venv/bin/python de l'appelant, pour les figures seulement.
  • Jamais une valeur de metrics/ qui soit un identifiant (SIM_CCID, ip*) ; lecture seule sur data/ ; ne jamais lire .env.
  • Ne rien casser : les options et les sorties existantes restent, les rapports des analyses citent des commandes qui doivent toujours marcher.
  • scripts/donnees.py est la lecture commune de l'app et des outils : on n'y touche que pour corriger une erreur de lecture. L'app passe ces mesures aux détecteurs (les événements de la page Data), qui lisent par ailleurs avec detectors/scripts/data.py (benchmark, Optimizer) : une correction de lecture ici se reporte là-bas, sinon la page et le benchmark divergent sans bruit.
  • Toute heure est en UTC. Commits par chemin, jamais git add -A. Langue : français.