Files
aimsight-optimizer/CLAUDE.md
T

2.4 KiB

CLAUDE.md

Optimizer fait converger les détecteurs AIMsight (le dépôt ~/detectors, par un lien detectors) en continu et à faible coût : un batch par jour UTC, toutes les stations ; les détecteurs posent leurs étiquettes, le scanner les regarde de loin face aux courbes et note les irrégularités. Il fait cela et rien d'autre. Conception : docs/superpowers/specs/2026-11-13-optimizer-design.md ; installer et lancer : README.md.

  • Le batch : python3 batch.py [--jour AAAA-MM-JJ] [--stations A,B] [--sans-scan] → batches/<jour>/ : detecteurs/<STATION>.jsonl (les étiquettes des détecteurs), verite/<STATION>.jsonl (les mêmes, corrigées par le scanner), detecteurs.md (le résumé pour le scanner), rapport.md (le sien), figures/ et scan.jsonl (son flux) hors de git.
  • L'agent : .claude/agents/scanner.md, sur Sonnet, lancé par batch.py (claude -p --agent scanner).
  • Les liens, hors de git, en lecture seule : data/ → ~/aimsight-data/data (rempli par le pompage du dépôt aimsight-data) ; labeling/ → ~/labeling (le dépôt des étiquettes, partagé avec Diagnostic-App) (familles.md ; auto/, la vérité de référence du benchmark).
  • Les détecteurs : leur contrat est dans detectors/CLAUDE.md ; Optimizer lit categories.events, categories.CATEGORIES et scripts/data.py. Diagnostic-App y pointe par le même lien (une seule copie : un commit de l'un se voit aussitôt chez l'autre) ; son mode ciblé (une analyse approfondie) et ce mode large seront deux appelants du même /detectors:wf-improve.
  • Pas encore branché : l'amélioration (/detectors:wf-improve sur la vérité du batch), à rediscuter.
  • Vérifier un changement : python3 batch.py --jour <jour> --sans-scan sur un jour réel, puis regarder les figures.

Règles :

  • Les agents tournent sur l'abonnement Claude, jamais sur une clé d'API : batch.py lance claude -p sans ANTHROPIC_API_KEY ni ANTHROPIC_AUTH_TOKEN, et l'arrête si son message d'ouverture dit une autre source que l'abonnement (apiKeySource ≠ none). Le montant en $ du flux n'est qu'un équivalent API, non facturé.
  • Toute heure est en UTC.
  • Lecture seule sur data/ et labeling/ ; ne jamais recopier les identifiants des métriques (SIM_CCID, ip*).
  • Pas de règle propre à une station, une cible ou une date.
  • Commits par chemin, jamais git add -A.
  • Langue : français ; le dépôt detectors reste en anglais.