Files
aimsight-optimizer/CLAUDE.md
T

18 lines
3.1 KiB
Markdown
Raw Normal View History

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