Files
Support-Agent/.claude/rules/analyses.md
T
maximeandClaude Opus 5.5 3082f75429 Add analysis 04 entry point and documentation
src/analyse_04.py launches the common page; sheet 04 moves to
"prototype en place" with VERMONT results; CLAUDE.md, the analyses
rule, README and sheet 01 list the fourth panel and extend the
"no verdict" contract exception to analysis 04.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-12 11:36:26 +02:00

30 lines
1.8 KiB
Markdown

---
paths:
- "src/**"
- "docs/analyses/**"
---
# Travailler sur une analyse
- **Avant de modifier** une analyse, lire sa fiche `docs/analyses/analyse_NN.md`. En particulier :
- le principe ;
- les constantes et leurs sources ;
- les limites connues ;
- les **options écartées** (ne pas les reproposer sans raison nouvelle).
- **Contrat commun** :
- `run(series) -> {analysis, rule, points: [{t, value, anomaly, facts}]}` ;
- calcul **causal** : le point t n'utilise que les données ≤ t ;
- `anomaly = None` signifie UNKNOWN (exception : analyses 03 en phase C et 04, où `None` = pas de verdict ; l'UNKNOWN est dans `facts.state` ou `facts.trend`) ;
- une analyse seule conclut au plus `consistent with`.
- **Code de calcul** : bibliothèque standard uniquement, car il doit tourner sur la station. Plotly ne sert qu'aux graphiques, sur le poste de dev (`.venv`).
- **Constantes** : chacune a sa source, en commentaire dans le code et dans le tableau de la fiche. Aucun seuil sans source.
- **Graphique** :
- en haut, l'analyse avec ses courbes superposées ; dessous, un graphique par série temporelle (D-011). Des analyses à comparer partagent une page, un panneau chacune (D-016) ;
- zoom horizontal seulement, avec l'ordonnée recalée sur la plage visible (`post_script=energy_plot.AUTOSCALE_Y_JS`, ordonnées en `fixedrange`, D-013).
- **Après modification** :
- mettre à jour la fiche dans le même changement (résultats, limites, historique) ;
- si c'est une décision projet, ajouter une entrée dans `docs/decisions.md` ;
- si c'est un savoir métier nouveau, l'ajouter dans `docs/domaine/`.
- **Vérifier à la main** avec `python3 src/analyse_NN.py` sur VERMONT (`data/`). Pas de tests automatisés en phase prototype (D-008).
- **Nouvelle analyse** : utiliser le skill `nouvelle-analyse`.