Files
aimsight-optimizer/CLAUDE.md
T

3.1 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), improve/ (la séance de wf-improve sur les stations corrigées : bilan summary.md, scripts de ses agents tools/), figures/, scan.jsonl et improve.jsonl (les flux) hors de git.
  • Les agents : .claude/agents/scanner.md, sur Sonnet (claude -p --agent scanner) ; puis /detectors:wf-improve (claude -p --plugin-dir detectors, ses agents detectors:upgrader et detectors:validator), une séance sur les stations que le scanner a corrigées. Lancés par batch.py sans les réglages du poste (--setting-sources project,local --strict-mcp-config).
  • 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.
  • Les essais : docs/essais/<jour>.md, un journal par essai de bout en bout ; outils/, les scripts de lecture qui en sont restés.
  • Vérifier un changement : .venv/bin/python outils/etape1.py <dossier de travail>/<jour> <jour> sur un jour réel (ou python3 batch.py --jour <jour> --sans-scan sur un jour sans batch), puis regarder les figures ; à vérité intacte, regression.py --labels <dossier>/detecteurs --data data --from <jour> --to <lendemain> doit être à 100 %.

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.