3.1 KiB
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 dewf-improvesur les stations corrigées : bilansummary.md, scripts de ses agentstools/),figures/,scan.jsonletimprove.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 agentsdetectors:upgraderetdetectors:validator), une séance sur les stations que le scanner a corrigées. Lancés parbatch.pysans 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 litcategories.events,categories.CATEGORIESetscripts/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 (oupython3 batch.py --jour <jour> --sans-scansur 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.pylanceclaude -psansANTHROPIC_API_KEYniANTHROPIC_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/etlabeling/; 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
detectorsreste en anglais.