Refactor(iit,#20298): nommer les sous-series ICT par sujet, pas par numero de palier #22949

Part of #20298 (consolidation ICT par escaliers).

Origine — deux remarques du mainteneur

Le mainteneur (jsboigeEPF) a posé deux remarques. Elles valent pour toute la consolidation, au-delà des tranches où elles sont posées.

Sur #22780 (c.6427513871, 2026-10-26) :

« Vous n'avez pas pu leur trouver des noms à ces sous-séries ?? Un numéro, ça va pour l'index dans une série, avec un nom clair associé juste après, certainement pas pour le nom d'un répertoire nu. Une sous-série, elle se nomme, pourquoi pas avec un numéro dans ce cas-ci ou notre série principale est clairement un ledger progressif, mais certainement pas sans nommer ce qu'on redescend, et toujours avec un bel escalier dans la série principal comme c'est d'usage. »

Sur #22798 (c.6428867100, 2026-10-26) :

« Même remarque que pour la précédente descente en sous-série, les répertoires doivent être nommés. De façon générale, un lecteur qui tombe sur n'importe quel contenu de notre dépôt devrait avoir au moins un vague idée du sujet dont parlent les répertoires ou les documents qu'il contiennent par les noms qu'ils portent. C'est un effort à soutenir dans la durée, et malheureusement tous les agents n'y apportent pas le même soin. Donc renommer pour plus de clareté devrait faire partie du mandat permanant de consolidation et lutte contre l'entropie rampante […] »

Hermes a rejoint la remarque sur #22798.

État mesuré (2026-10-28 06:40Z)

Chaque palier de consolidation crée une sous-série sous MyIA.AI.Notebooks/IIT/ICT-Series/, nommée par le seul numéro du palier :

git ls-tree -d origin/main MyIA.AI.Notebooks/IIT/ICT-Series/ rend ICT-15 à côté de assets, corpus, ict, results, runs, scripts, tests et traces. La version précédente de ce body disait qu'aucune sous-série n'était sur main. Ce n'est plus vrai.

Décision du coordinateur (2026-10-28)

Convention : ICT-<NN>-<Sujet>/. Exemples : ICT-14-FreeEnergySurprise/, ICT-19-EnjeuBattery/. C'est la forme que la remarque du mainteneur autorise : un numéro pour l'index du ledger progressif, et un nom clair juste après. Un numéro nu est exclu.

• <NN> est le numéro que porte aujourd'hui le carnet de tête dans la série principale : celui que le lecteur voit sur la marche de l'escalier. Ce n'est pas le numéro d'arrivée de la carte (01 à 22). Si la tête est plus tard renumérotée vers son numéro d'arrivée, le dossier suit dans la même PR.
• <Sujet> reprend le sujet du carnet de tête, tel que son nom de fichier l'écrit, sans le suffixe -Python. La lane le propose dans sa PR et l'écrit dans le README.

Calendrier

• Les trois PRs ouvertes renomment leur sous-série dans la PR, avant leur merge. Elles réécrivent déjà tous les chemins et tous les liens de leurs carnets. Les merger avec un répertoire nu, puis les renommer, déplacerait deux fois les mêmes fichiers et doublerait les entrées du rename-ledger.tsv. Le rejeu de CI n'est pas un argument contraire : c'est le coût normal d'un correctif.
• ICT-15/, déjà sur main, est renommée par une PR dédiée de la même lane : un renommage pur, avec ses clés de baseline, ses entrées de ledger et ses liens.
• Toute sous-série future de [ICT] Consolidation par escaliers : numérotation principale rassemblée, sous-séries d'historique, capstones (fille #11690 / #5081) #20298 naît nommée.

L'escalier dans la série principale. Chaque sous-série apparaît dans MyIA.AI.Notebooks/IIT/ICT-Series/README.md comme une marche de l'escalier, à sa place dans l'ordre des paliers. La marche porte le nom de la sous-série, un lien vers son carnet de tête et une phrase qui dit ce qu'on y redescend. La navigation de la série principale descend vers le carnet de tête de la sous-série, et remonte depuis son dernier carnet.

Critères d'acceptation

• la convention est écrite dans MyIA.AI.Notebooks/IIT/ICT-Series/README.md, là où un lecteur cherche l'index de la série, et non seulement dans une note de conception par tranche ;
• aucun répertoire de sous-série au numéro nu sous ICT-Series/. Commande de contrôle : git ls-tree -d --name-only origin/main MyIA.AI.Notebooks/IIT/ICT-Series/ | grep -E '/ICT-[0-9]+[a-z]?$' ne rend rien ;
• ICT-15/ renommée sur main, et ICT-19/, ICT-14/, ICT-12/ mergées sous leur nom définitif ;
• chaque sous-série a sa marche dans le README de la série principale, et la chaîne de navigation descend vers elle et en remonte ;
• pedagogy_density.py --check-orphans reste à 0 ORPHAN_KEY et 0 LOST_KEY sur les chemins ICT-* ;
• check-navlinks, check-nav-chain et check_docs_index restent verts : aucun lien cassé par le déplacement ;
• chaque entrée de docs/reference/rename-ledger.tsv porte l'ancien et le nouveau chemin.

Périmètre

• Cette issue ne demande aucun renommage de carnet : les noms de fichiers comme ICT-14-FreeEnergySurprise-Python.ipynb éclairent déjà leur sujet. Le défaut porte sur les répertoires qui les regroupent.
• La seconde remarque dépasse ICT : un nom de répertoire ou de document doit dire son sujet partout dans le dépôt, et renommer pour la clarté fait partie du mandat permanent de consolidation. Cette issue en traite l'instance ICT. Le reste du dépôt relève des grains de consolidation, servis par le tapis.