Retour d'utilisation de Claude Code

Chez Arneo, il nous arrive régulièrement de reprendre des projets développés par d'autres agences, souvent sans passation. C'est le scénario le moins confortable pour un développeur : un repo Git qu'on n'a jamais vu, une stack qu'on ne maîtrise pas forcément, et un client qui attend des réponses rapidement. 

Sur un projet récupéré dans ces conditions, nous avons utilisé Claude Code dès le premier contact avec le code. La commande /init a généré un fichier CLAUDE.md qui cartographie automatiquement la structure du projet : architecture du site, frameworks utilisés, plugins custom, système de build, dépendances. En quelques minutes, l'agent avait identifié l'architecture globale du projet, les couches de logique métier custom, et les zones de risque. 

Mais le vrai gain est venu de l'audit. Nous avions besoin d'un état des lieux complet du projet, compréhensible par nos chefs de projet non-techniques. En une seule instruction, Claude Code a déployé six sous-agents en parallèle, chacun spécialisé sur un aspect du projet (architecture, plugins, sécurité, compatibilité, dépendances, refonte en cours). Le résultat : un rapport structuré en français, avec des tableaux de synthèse par niveau de criticité, livré en quelques minutes. 

Ce rapport a notamment révélé des identifiants de production en clair dans le dépôt Git, un problème critique que l'équipe précédente n'avait visiblement pas traité. 

En chiffres : ce qui aurait représenté une journée d'analyse et de rédaction s'est transformé en une session d'environ une heure. Et surtout, le CLAUDE.md généré à cette occasion sert désormais de base de connaissance pour chaque développeur qui intervient sur le projet.

Sur ce même projet, la partie frontend embarquait une chaîne de build Node.js vieillissante (pas de mise à jour depuis 2020, ce qui est très vieux dans l'écosystème Node) : Gulp 4, des compilateurs CSS dépréciés, un préfixeur CSS en version 7, et 114 vulnérabilités remontées par npm audit . Le genre de dette technique qu'on repousse de sprint en sprint parce que "ça marche encore". 

Nous avons abordé la migration en mode conversationnel avec Claude Code. La première étape a été un audit des dépendances : l'agent a produit un tableau comparatif de chaque package (version actuelle, version cible, statut, action recommandée), puis a lu le fichier de configuration du build pour comprendre l'usage réel de chaque dépendance avant de proposer quoi que ce soit. C'est un point important : Claude Code ne se contente pas de mettre à jour des numéros de version, il analyse le code qui consomme ces dépendances pour anticiper les breaking changes.

La migration s'est déroulée en trois phases itératives. D'abord, la montée de version majeure du build system avec le remplacement des packages dépréciés. À chaque modification, Claude Code lance le build, observe les erreurs, et corrige. Certains packages récents se sont avérés incompatibles avec le format du projet existant : l'agent a testé plusieurs versions jusqu'à trouver la bonne combinaison. Ce cycle essai-erreur-correction, qui aurait été fastidieux manuellement, se déroule naturellement dans la conversation. 

Deuxième phase : le nettoyage sécurité. La suppression de deux packages responsables de la majorité des vulnérabilités fait passer l'audit de 114 à 4 vulnérabilités, sans impact fonctionnel. 

Claude Code vérifie l'usage réel de chaque package avant de le retirer. Troisième phase : la modernisation vers les standards actuels (ES Modules). Les dernières vulnérabilités disparaissent. Résultat final : 0 vulnérabilité, 382 packages en moins, et un build fonctionnel. 

À la fin de la session, nous avons demandé à Claude Code de documenter l'ensemble du processus directement dans le dossier du projet : les décisions techniques, les compromis, les commandes de référence. Tout est tracé, sans effort de rédaction supplémentaire. Idéal pour être transféré dans un outil de gestion de la connaissance.

Chez Arneo, nous développons en interne un ensemble de skills et plugins Claude Code partagés entre les développeurs de l'équipe. Le problème : ces ressources vivaient dans un dépôt Git sans aucune interface de consultation. Pour savoir ce qui existait, il fallait naviguer dans l'arborescence, ouvrir les fichiers un par un, lire les métadonnées, bref, un processus que personne ne faisait. 

Nous avons décidé de construire un annuaire interne, une landing page statique qui agrège automatiquement les métadonnées du repo et les présente de manière consultable. L'ensemble du projet, du concept au déploiement, a été réalisé avec Claude Code. 

La première session a commencé par une instruction simple : "I want to create a dead simple directory for the marketplace. Brainstorm and make a plan."

Claude Code a exploré le repo de skills, lu les fichiers de configuration, puis produit un plan structuré en 5 phases et 12 fichiers. Le choix technique, choisi en amont par le développeur (un site statique Nuxt avec Tailwind, qui lit les données du repo à la génération), a été mis en place et argumenté avec l'agent avant toute ligne de code. 

L'implémentation a suivi le plan phase par phase. Claude Code a scaffoldé le projet, créé la couche de données, les composants d'interface, et la logique de recherche. À chaque étape, l'agent lançait le serveur de développement et utilisait un navigateur automatisé via MCP pour prendre des screenshots et vérifier le rendu. 

Les sessions suivantes ont fait évoluer le produit de manière itérative. L'application de la charte graphique Arneo (couleur orange, typographies maison, fond sombre) a été traitée comme un plan à part entière. Claude Code a même généré un logo ASCII combinant le motif starburst de la marque et l'identité code/IA. 

La refonte du layout (passage d'une page verticale à une interface sidebar + grille avec filtres par mots-clés, auteurs et capabilities) a été réalisée en une session de 5 minutes. Quand le rendu produisait des cartes de hauteur inégale, une simple instruction ("I need the columns to behave as masonry") a suffi pour que l'agent adapte le layout, vérifie le résultat visuellement, et committe le changement. 

L'ajout du dark mode a illustré la capacité de l'agent à consommer de la documentation externe : en lui fournissant l'URL d'une librairie, Claude Code a implémenté un toggle trois états (clair, sombre, automatique) et géré les cas limites techniques. 

La dernière brique, le déploiement, a été configurée pour synchroniser automatiquement le site avec le repo des skills. La landing page est désormais à jour en permanence pour toute l'équipe. 

En chiffres : le projet est passé du concept au déploiement en une vingtaine de sessions réparties sur 2 jours, générant 46 commits et plus de 300 fichiers. Un site complet, brandé, responsive, avec filtres, dark mode et déploiement automatique.