Symlink ton monorepo, dompte Claude Code : l'art de fédérer tes projets sans casser tes workflows

Parce que tu as déjà hésité quinze fois à fusionner tous tes projets dans un monorepo façon “on gère tout depuis la racine”, mais que tu t’es ravisé en repensant à ton dernier npm install qui a fait frire la cafetière, parlons organisation. Plus précisément : comment réunir plusieurs projets physiques dans un seul dossier “virtuel” et rendre Claude Code (ou OpenCode) heureux, et toi aussi.

Pourquoi un dossier “unifié” ?

Tu bosses sur un écosystème de micro-services, une app Next.js qui cause à du Python, qui cause à un script crado… et tu veux que ton assistant IA voie tout d’un coup, pour qu’il puisse raisonner sur l’ensemble ? Sauf que tout déplacer, c’est l’assurance de se fâcher avec Git, tes pipelines CI, et le karma de ton repo. C’est là que les liens symboliques entrent dans la danse.

Le symlink : c’est magique, et (presque) sans danger

Un lien symbolique (ou “symlink” pour les snobs) est un raccourci façon magicien : tu pointes un dossier A vers un dossier B, mais pour tous tes outils (et Claude Code), le B semble exister dans la structure de A. Résultat : tu peux avoir un dossier "workspace-fusion" qui “contient” tous tes projets, mais sans dupliquer les fichiers ni bazarder l’histoire Git de chacun.

# Exemple sous Unix/Mac :
ln -s /chemin/vers/projet-web /chemin/vers/workspace-fusion/projet-web
ln -s /chemin/vers/bot-python /chemin/vers/workspace-fusion/bot-python
# Windows (yc !):
mklink /D C:\workspace-fusion\projet-web C:\chemin\vers\projet-web

Pourquoi ça change tout avec Claude Code (ou Opencode) ?

Les assistants IA pour dev sont des gros gloutons : plus ils “voient” de fichiers d’un coup, plus ils peuvent raisonner, faire de la refacto cross-projet, documenter, générer les mappings d’API, etc.

Claude Code, grâce à ses capacités de “contexte étendu”, va pouvoir :

• Sauter entre tes projets comme un kangourou en forfait illimité,
• Croiser les modèles/domaines, créer ou réparer des ponts d’API,
• T’aider à factoriser le code commun, voir suggérer une migration de lib partagée sans jamais bouger les originaux,
• Faire son “plan d’action global” et documenter comment passer du mono au multi-repo sans sacrifier ta santé mentale.

Un cas d’usage : faire un audit global sur plusieurs bases de code

Plutôt que de déverser 8 tar.gz et 12 repos git dans un seul dossier, tu prépares un “workspace” spécial symlink, tu crées les liens vers chaque racine, et tu lances Claude Code sur ce dossier. Bingo : il accède à tous tes codes, discerne les patterns archi, propose des refactors “cross-service”… tout en gardant tes projets bien rangés à leur place.

Ne pas Sonnet avant d'entrer

Ca peut être totalement intéressant d'aller jeter un oeil à mon article précédent sur les cas d'usage entre Sonnet et Opus avant de lire la suite, car dans ce contexte précis où on réunit plusieurs projets avec potentiellement des milliers de lignes de code, c'est clairement Opus 4.1 qui va faire des miracles et fournir une analyse pertinente, un document d'implémentation aux petits oignons (demandez lui de préparer des tâches indépendantes) avant de passer sur Sonnet pour gérer l'implémentation en elle même en plusieurs étapes facile qui élargirons ton cercle.

Kiro, l'IDE d'Amazon, propose un fonctionnement à peu près similaire en décomposant les étapes avant de produire une liste de tâches qui font référence au document de design. Ce serait dommage de ne pas s'en inspirer.

Conseils de magicien du symlink

• Lisibilité : Structure bien ton workspace de liens (un dossier par projet, des noms explicites).
• Git-friendly : A moins que ce soit une nécessité absolue, ne commite JAMAIS les symlinks si tu n’es pas sûr (risque de confusion dans certains outils).
• Clean up : N'oublie pas de nettoyer ton workspace de liens quand tu as fini, t'es pas obligé de finir avec une cathédrale de raccourcis fantômes, et puis si tu sais pas le faire le ménage dans tes symlinks, je préfère même pas voir l'état de ta chambre
• Tests : Teste l’accès réel (listing, linting, navigation) avant de lancer Claude, pour éviter les “No such file or directory” qui te feront croire que tout internet s’est effondré.

Références utiles :

• La doc officielle Claude Code
• Astuce symlink Unix
• Pourquoi un monorepo, c’est pas toujours le mal ? - CursorIDE

Voilà, tu peux dompter le bestiau IA sans sacrifier la beauté (relative) de ton arborescence de projets. Parce qu’à la fin, coder c’est une question d’équilibre : un peu de rigueur, beaucoup de liens… symboliques ou humains.