Parallelizing Claude Code

📝 Notes de Cours : Productivité avec Claude et Git Worktrees

**I. Principe de base : Le parallélisme avec Claude**

• Processus léger : Claude est un processus léger → il est facile de lancer plusieurs instances simultanément.
• Objectif : Permettre à un développeur de commander une "équipe virtuelle" d'ingénieurs logiciels.
• Problème de conflit : Deux instances de Claude peuvent modifier le même fichier en même temps, entraînant des codes conflictuels ou invalides.
• Solution : Isoler chaque instance dans son propre espace de travail (workspace) pour éviter les conflits.

**II. Méthode d'isolation : Les Git Worktrees**

• Définition : Un Worktree est une extension de la fonctionnalité de branchement de Git.
• Fonction : Il permet de créer une copie totale du projet dans un nouveau répertoire sur la machine de développement.
• Principe : Chaque Worktree correspond à une branche séparée.
• Avantage : Les instances de Claude travaillent dans un environnement totalement isolé.

**III. Flux de travail (Workflow) standard**

• Création : Utiliser un Worktree pour créer un environnement isolé.
• Exécution : Lancer une instance de Claude dans ce Worktree.
• Travail : Claude effectue la tâche (ajout de fonctionnalité, tests, etc. ).
• Finalisation : Committer le travail dans le Worktree.
• Intégration : Fusionner (merge) les changements du Worktree vers la branche principale.

**IV. Automatisation du processus**

• Défi : Le workflow manuel est long et répétitif.
• Automatisation par Claude : On peut demander à Claude de gérer l'intégralité du workflow (création du Worktree, création des liens de dépendances, ouverture de l'éditeur).
• Automatisation par commandes personnalisées :
• Créer un répertoire spécial (. clod/commands).
• Définir des prompts personnalisés dans des fichiers Markdown (ex: create worktree. md).
• Utiliser des arguments spéciaux (ex: $1) pour rendre les commandes dynamiques (ex: /project:create worktree [nom_feature]).

**V. Application avancée**

• Parallélisation : Lancer plusieurs Worktrees (ex: quatre) pour que différentes instances de Claude travaillent sur des tâches distinctes en même temps.
• Gestion des merges : Utiliser des commandes personnalisées pour demander à Claude de fusionner les changements de chaque Worktree dans la branche principale.
• Résolution : Claude peut automatiquement résoudre les conflits de fusion.

Takeaways

• Claude est un processus léger qui permet le parallélisme, mais nécessite une isolation pour éviter les conflits de modification.
• Les Git Worktrees servent à isoler chaque instance de Claude en créant une copie complète du projet pour une branche spécifique.
• Le flux de travail standard consiste à utiliser un Worktree isolé pour le développement, puis à fusionner les changements dans la branche principale.
• L'automatisation via des commandes personnalisées permet de gérer l'intégralité du workflow et de lancer plusieurs Worktrees simultanément.