Turn CLAUDE.md into a full map of the repository

D-028: CLAUDE.md names every folder and document with its size in
lines, says how to read without filling the context (outline of a long
file then one section, index of the decision log, CSV by script,
folders not to read), and gives the current state instead of a dated
history. It and D-026 now name final.py for the delivered script.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-13 08:58:43 +02:00
1 parent 7f911e41a3
commit ef8ad70285
2 files changed
+92 -75

No files matched your search

+12 -2
View File
@@ -260,7 +260,7 @@ Règles du journal :
- **Décision** :
- **Chaque domaine a son sous-dossier dans chaque couche** : `src/energy/` et `docs/energy/` (analyses, domaine, guide, matrice). Le code commun est dans `src/common/` (`stations.py` : chargement des CSV ; `page.py` : bascule `.venv`, ouverture, `AUTOSCALE_Y_JS`). `maquettes/` reste découpé par public (D-022). Les notes communes restent dans `docs/domaine/`.
- **Les analyses ne sont plus numérotées** : chacune est désignée par sa règle et sa fiche porte son nom (`docs/energy/analyses/daily_battery_state.md`). Correspondance : 01 = `MOVING_AVERAGE_7_DAYS_DROP`, 02 = `MOVING_AVERAGE_7_DAYS_MIDNIGHT_UTC_DROP`, 03 = `DAILY_BATTERY_STATE`, 04 = `DAILY_BATTERY_TREND`. Les entrées du journal antérieures à celle-ci gardent les numéros.
- **Deux scripts d'analyse pour Energy** : `src/energy/daily.py`, les analyses livrées (état et tendance, D-020 et D-021), qui écrit `out/<STATION>_daily.html` et `.json` ; `src/energy/all_analyses.py`, les quatre analyses ensemble pour comparer (D-016), qui écrit `out/<STATION>_energy.html`. `src/energy/focus_jour.py` reste l'outil de focus (D-024). Le résumé texte d'`energy_check.py` (`out/<STATION>_energy.json`) est supprimé.
- **Deux scripts d'analyse pour Energy** : `src/energy/final.py` (`daily.py` jusqu'au 2026-10-13), les analyses livrées (état et tendance, D-020 et D-021), qui écrit `out/<STATION>_daily.html` et `.json` ; `src/energy/all_analyses.py`, les quatre analyses ensemble pour comparer (D-016), qui écrit `out/<STATION>_energy.html`. `src/energy/focus_jour.py` reste l'outil de focus (D-024). Le résumé texte d'`energy_check.py` (`out/<STATION>_energy.json`) est supprimé.
- **La documentation AIMsight d'origine passe de `doc/` à `docs/aimsight/`**, avec la copie du collecteur (`collecteur_system_info.py`, ex-`src/__main__ (3).py`). La roadmap perd le suffixe « (2) ». `cas-d-usage-03-04.drawio` devient `docs/energy/matrice-etat-tendance.drawio`. Les contenus ne changent pas.
- Le modèle de fiche passe dans le skill `nouvelle-analyse` (`modele-fiche.md`).
- **Pourquoi** : demande de l'utilisateur. Encapsuler Energy pour que le domaine suivant (D-002) se range à côté. Ranger les fichiers dispersés (racine, `doc/` à côté de `docs/`, code commun mêlé aux analyses). Energy a convergé vers les analyses livrées : un numéro d'ordre de création n'aide plus, le nom de la règle suffit.
@@ -271,7 +271,7 @@ Règles du journal :
- une numérotation par domaine : elle ne dit pas plus que le nom de la règle.
- **Conséquence** :
- les anciens chemins restent dans `docs/superpowers/` et dans le texte des entrées antérieures du journal (historique non réécrit) ;
- le code de calcul s'embarque en copiant `src/energy/` sans `daily.py`, `all_analyses.py` ni `focus_jour.py`, qui demandent plotly.
- le code de calcul s'embarque en copiant `src/energy/` sans `final.py`, `all_analyses.py` ni `focus_jour.py`, qui demandent plotly.
## D-027 — 2026-10-12 — Couche d'agents de diagnostic côté serveur (exploratoire)
- **Statut** : active, exploratoire (rapport `docs/agents/rapport-exploratoire.md`, rien n'est construit). Remplace en partie D-003 : le refus du LLM ne vaut plus que pour la couche déterministe.
@@ -294,3 +294,13 @@ Règles du journal :
- les règles non négociables (traçabilité, vocabulaire, lecture seule, pas de seuil inventé) s'appliquent aux agents ;
- les règles détaillées proposées (journal, contrôles de `notify`, politique de destinataire, affichage) sont des **pistes à revoir étape par étape**, pas des décisions (annexe A du rapport) ;
- prérequis de l'étape 1 : un compte et une clé API Anthropic.
## D-028 — 2026-10-12 — CLAUDE.md : carte complète du dépôt, état courant, lecture ciblée
- **Statut** : active. Précise D-012.
- **Décision** :
- `CLAUDE.md` nomme chaque dossier et chaque document du dépôt, avec sa taille en lignes, pour que l'agent sache ce qui existe sans l'ouvrir ;
- il dit comment lire sans saturer le contexte : plan d'un fichier long puis la seule section utile, index de ce journal, CSV par script, dossiers à ne pas lire ;
- « État et prochaine étape » donne l'état courant, pas un historique daté ;
- ce qui est déjà dans `.claude/rules/analyses.md` (contrat `run(series)`, disposition des graphiques) n'y est plus répété.
- **Pourquoi** : demande de l'utilisateur. Le CLAUDE.md doit révéler tout le projet sans forcer l'agent à le lire. L'historique daté grossissait à chaque étape alors qu'il est déjà dans `git log` et ce journal ; la doc AIMsight (~3 300 lignes) était à « lire avant de concevoir » sans dire comment la lire par section.
- **Options écartées** : un index des sections de chaque gros document dans `CLAUDE.md` : `grep -n '^#'` le donne à la demande, sans coût permanent.