Le défi des modifications multi-fichiers
Les refactorisations, nouvelles fonctionnalités et migrations impliquent souvent des changements coordonnés sur de nombreux fichiers. Claude Code excelle dans ce type de tâche grâce à sa compréhension globale du codebase.
Pattern 1 : Le plan d'exécution
Commencez par demander un plan avant l'exécution :
Je veux renommer le composant UserCard en ProfileCard partout dans le projet.
D'abord, liste tous les fichiers impactés sans modifier quoi que ce soit.Une fois le plan validé, lancez l'exécution :
Ok, applique ces changements.Pattern 2 : La migration incrémentale
Pour les grosses migrations, procédez par lots :
Migre les 5 premiers composants de styled-components vers Tailwind.
Garde le même comportement visuel. Montre-moi un diff résumé à la fin.Validez chaque lot avant de continuer.
Pattern 3 : Le scaffold complet
Pour créer une nouvelle fonctionnalité touchant plusieurs couches :
Crée un module "notifications" complet avec :
- Le schéma Prisma (model Notification)
- Le router tRPC avec les opérations CRUD
- Les composants React (NotificationList, NotificationItem)
- Les tests unitaires pour le router
Suis les conventions existantes du projet.Claude Code analysera les patterns existants et reproduira le style.
Pattern 4 : Le refactoring guidé par les tests
Refactorise le service d'authentification pour extraire la logique
de validation des tokens dans un module séparé.
Les tests existants doivent continuer à passer.Conseils pour des résultats optimaux
- Contexte explicite : Mentionnez les fichiers clés si vous les connaissez
- Contraintes claires : Précisez ce qui ne doit PAS changer
- Validation progressive : Demandez un résumé des changements avant/après
- Référence aux patterns : "Fais comme dans le module users" est très efficace
- CLAUDE.md à jour : Les conventions documentées sont appliquées automatiquement
Limites à connaître
- Pour les très gros refactorings (100+ fichiers), découpez en étapes
- Vérifiez toujours que les tests passent après chaque batch
- Commitez fréquemment pour pouvoir rollback si nécessaire