Réorganiser un dossier de projets sans casser un seul chemin
J'ai rangé plus d'une centaine de projets en trois niveaux sans rien casser : une table ancien vers nouveau a déplacé les dossiers puis réécrit chaque chemin cité, sur chaque Mac.
- Avant
- Plus d'une centaine de projets en vrac, et déplacer un dossier casse tout ce qui cite son chemin.
- Maintenant
- 117 déplacements et 655 fichiers réécrits d'un coup, par une seule table.
Utile si vous devez déplacer beaucoup de dossiers dont des scripts et des réglages citent le chemin.
# stack
En 3 étapes
- Je relève tout ce qui cite un chemin de dossier : scripts, documentation, mémoire de l'IA Claude, tâches automatiques, réglages.
- Une table à deux colonnes, ancien chemin et nouveau chemin, sert à déplacer les dossiers puis à réécrire chaque chemin cité.
- Au démarrage de Claude Code (mon assistant IA), chaque Mac rejoue la table pour mettre à jour ce qui vit hors du dossier.
$ head -8 mapping.tsv | awk -F'\t' '{print $1 " -> " $2}'
Photographie/refonte-blog -> Photographie/site-blog/refonte-blog
Photographie/youtube-vers-blog -> Photographie/site-blog/youtube-vers-blog
Photographie/gestion-seo -> Photographie/site-blog/gestion-seo
Photographie/gestion-perf -> Photographie/site-blog/gestion-perf
Photographie/gestion-liens -> Photographie/site-blog/gestion-liens
Photographie/gestion-llms-txt -> Photographie/site-blog/gestion-llms-txt
Photographie/gestion-agent-ready -> Photographie/site-blog/gestion-agent-ready
Photographie/gestion-tags -> Photographie/site-blog/gestion-tags A · Le jour du rangement
01
Moi
je valide le plan
02
L'audit des chemins
relève tout ce qui cite un chemin
Claude Code
03fait maison
Le moteur
déplace, réécrit, journalise
lit : La table de chemins
avecPython
04
Un dossier en 3 niveaux
117 déplacements, 655 fichiers réécrits
B · Sur chaque Mac
05
Une session s'ouvre
sur chaque Mac
06fait maison
Le script de démarrage
rejoue la table sur ce Mac
relit : La table de chemins
avecNode.js
07
Les réglages à jour
routines, plugins, tâches planifiées
launchd
Les données
La table de chemins
ancien chemin, nouveau chemin
lu par 03, 06
À côté
Le test d'acceptation
chaque contrôle : commande, code de sortie
fait maison
Le retour arrière
la table inverse, prête avant de commencer
avecPython
fait maison
Le contrôle du rangement
relit tout, en lecture seule
avecPython
On déplace, on ne renomme pas : une table fait foi.
- fait maison
- outil du marché, source ou résultat
- une personne
- les données
Pourquoi je l'ai fait
Fin septembre 2026, je l’ai dit sans détour : mon dossier de développement était en bordel. Plus d’une centaine de projets côte à côte, un dossier « Divers » où tout finissait, et même des articles qui traînaient à la racine. J’ai visé une organisation limpide, avec exactement le même fonctionnement à la fin. Le problème : déplacer un dossier casse tout ce qui cite son chemin, des scripts à la mémoire de Claude, jusque sur mon second Mac.
Ce que ça fait, concrètement
Depuis septembre 2026, le dossier est rangé en trois niveaux : domaine, sujet, dossier de travail. Par exemple : photo, puis site du Blog, puis référencement. Une carte mentale (une mindmap) dit où vit quoi, et Claude Code la consulte au premier doute. J’ai gardé le nom des dossiers de travail, seuls les sujets sont nouveaux : mes réflexes et ceux de l’assistant n’ont rien eu à réapprendre.
Le jour du rangement, 117 dossiers et fichiers ont été déplacés et 655 fichiers réécrits. Depuis, un contrôle suit les 184 dossiers de travail et me signale un dossier mal placé, un ancien chemin qui réapparaît ou un lien mort.
Comment ça marche, en détail
Fabrication : 117 déplacements, 655 fichiers réécrits, 394 fichiers audités
Tout part d’une seule table à deux colonnes : l’ancien chemin, le nouveau. Un moteur en Python en tire tout le reste, et un contrôle reste en place une fois le chantier fini.
L’audit avant de bouger : 394 fichiers et 860 occurrences, dont 85 scripts qui comptaient les niveaux
Avant de bouger un seul dossier, j’ai fait relever tout ce qui pointe vers un chemin : 394 fichiers et 860 occurrences au compteur. Et dans le lot, un piège : environ 85 scripts trouvaient leur fichier de configuration en comptant les niveaux de dossiers au-dessus d’eux. Avec un niveau de plus, ils cassaient tous. Je les ai fait réécrire avant le déménagement, pour qu’ils remontent les dossiers jusqu’à trouver le fichier.
Ce que fait le moteur : déplacer, réécrire du préfixe le plus long au plus court, journaliser, préparer le retour
- Les déplacements, sur le même disque, donc instantanés : les dépôts git restent intacts ;
- La réécriture des références, en commençant par le préfixe le plus long (sinon un chemin court serait réécrit en premier, et le chemin long, plus précis, ne serait plus reconnu), archives et journaux datés exclus ;
- Un journal pour chaque fichier réécrit ;
- La table inverse, générée avant de commencer, pour revenir en arrière.
Hors du dossier : routines, réglages, plugins et second Mac, rejoués par un hook de démarrage
Certaines références vivent ailleurs : les routines de l’app Claude, les réglages de Claude Code, les plugins de la barre de menus, les tâches planifiées du système. Le cas le plus vicieux : une règle qui protégeait un dossier sensible aurait cessé de le protéger, sans un bruit. Sur le Mac du chantier, j’ai tout fait réécrire le jour même. Sur l’autre, un hook de démarrage de Claude Code (un petit programme que Claude Code lance en ouvrant une session) relit la table à chaque session et applique chaque ligne dont le déplacement est fait sur ce disque. Il tourne toujours : un déplacement ajouté à la table se propage tout seul. Ce hook fait partie des garde-fous de Claude Code. Et malgré tout ça, le lendemain du rangement, une routine a encore buté sur un chemin relatif écrit dans sa consigne.
Le test d’acceptation et la relecture indépendante qui a trouvé six défauts bloquants
Chaque contrôle est une commande qui répond par oui ou par non (son code de sortie). Au bilan, l’audit relancé ne trouvait plus aucun ancien chemin hors archives, chaque dossier déplacé gardait son nombre de fichiers, les 922 scripts Python compilaient comme avant, et les hooks, les plugins et la construction du site des apps passaient. J’ai quand même fait faire une relecture indépendante, menée exprès pour trouver la faille. Bien m’en a pris : six défauts bloquants, dont des chemins à profondeur fixe, d’anciens chemins écrits avec d’autres majuscules et des zones exclues à tort. Tous corrigés avant de clore.
La mémoire de Claude au passage : 597 fiches devenues 467
Au passage, l’état de chaque projet a quitté la mémoire de Claude pour le README de son dossier (le fichier qui présente le projet). Résultat : 597 fiches de mémoire sont devenues 467. Toute l’histoire est sur la fiche La mémoire de Claude Code.
Le contrôle qui reste : trois niveaux, carte, anciens chemins, liens, mémoire, copies en conflit et hooks
J’ai gardé un script en lecture seule, d’environ 40 secondes, qui vérifie les trois niveaux, la carte, les anciens chemins et les dossiers réapparus, les liens, la mémoire, les copies en conflit et les hooks. Il note chaque dossier de travail apparu ou disparu depuis le passage précédent. Une routine le lance régulièrement.
Le rôle de chaque pièce
Les 7 étapes du schéma, une par une
- Moi Je valide le plan de rangement et je tranche les cas à part.
- L'audit des cheminsClaude Code Avant de bouger, il relève chaque fichier qui pointe vers un chemin : 394 fichiers et 860 occurrences selon son décompte.
- Le moteurPythonfait maison Il déplace sur le même disque, réécrit les références du préfixe le plus long au plus court, tient un journal par fichier et prépare la table inverse.
- Un dossier en 3 niveaux Domaine, sujet, dossier de travail. Les dossiers de travail ont gardé leur nom, les dépôts git restent intacts.
- Une session s'ouvre À chaque démarrage de Claude Code, sur le Mac du chantier comme sur l'autre.
- Le script de démarrageNode.jsfait maison Il applique chaque ligne dont le déplacement est fait sur ce disque. Un déplacement ajouté à la table se propage seul.
- Les réglages à jourlaunchd Ce qui vit hors du dossier est réécrit : routines, réglages de Claude Code, plugins de la barre de menus, tâches planifiées du système.
# mémoires
- La table de chemins Une ligne par déplacement, deux colonnes. C'est la seule source du moteur comme du script de démarrage.
# à côté
- Le test d'acceptation Plus aucun ancien chemin, même nombre de fichiers par dossier, scripts compilés. Une relecture indépendante a trouvé six défauts bloquants, corrigés.
- Le retour arrièrePythonfait maison Le moteur génère la table inverse avant le premier déplacement pour pouvoir tout défaire.
- Le contrôle du rangementPythonfait maison En 40 secondes environ, il vérifie les trois niveaux, les anciens chemins réapparus, les liens, les scripts de démarrage et suit les 184 dossiers de travail.
Ce que vous pouvez reprendre chez vous
Déplacez vos dossiers sans les renommer, et tenez une seule table ancien vers nouveau comme source de vérité. Pour qu’un script trouve ses fichiers, faites-le remonter les dossiers plutôt que compter les niveaux. Préparez la table inverse avant de commencer. Écrivez chaque test d’acceptation comme une commande qui répond par son code de sortie. Et gardez un contrôle en place après le chantier.
Ce que j'en retiens
Un chemin cité se cache partout, surtout là où je ne regardais pas : sur l’autre Mac, dans une règle de sécurité, dans la consigne d’une routine. La table seule n’aurait pas suffi. Il a fallu le hook qui la rejoue sur chaque machine, et un regard neuf pour la relecture, pour trouver ce que mon audit avait raté. D’ailleurs, la même méthode m’a resservi en octobre 2026, avec mon retour à mon ancien stockage en ligne.