Document the project: decisions log, analysis sheet, domain notes
- CLAUDE.md becomes a short map: status and next step, analyses index, documentation map, working rules. - docs/decisions.md: ADR-style project decision log (D-001..D-014). - docs/analyses/: living sheet per analysis (analyse_01) and template. - docs/domaine/: domain knowledge, one note per question. - .claude/rules/analyses.md: path-scoped rule loaded on src/ and docs/analyses/; .claude/skills/nouvelle-analyse: new-analysis workflow. - README.md: human entry point. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
0b950199b8
commit
8992bda17e
12 files changed
+588
-49
No files matched your search
@@ -0,0 +1,29 @@
|
||||
---
|
||||
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 ;
|
||||
- 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) ;
|
||||
- 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`.
|
||||
Reference in new issue
Block a user