Utilisation de Claude dans ce projet
Claude Code est l’interface en ligne de commande (CLI) d’Anthropic, alimentée par l’IA. Elle est utilisée dans ce projet comme assistant de développement, pour les tâches décrites ci-dessous.
La répartition des responsabilités importe davantage que la liste des tâches. Claude propose des options, défend l’une d’entre elles et écrit le code. Chaque décision qui façonne le produit — quoi développer, quelle approche adopter, quoi livrer — est prise par le responsable du projet. Lorsqu’un choix de conception a des conséquences que le responsable doit évaluer, Claude est censé mettre en évidence les compromis plutôt que de faire un choix en silence.
Conception et développement de fonctionnalités
Claude travaille sur des fonctionnalités complètes, et non pas uniquement sur des modifications isolées. L’interface CLI de structuration et les outils de synchronisation des modèles, le chatbot avec sa prise en charge des fournisseurs modulaires, le système géré de réutilisation des URL et la couche de données partagée du tableau de bord ont tous été développés de cette manière : Claude étudie le code existant, propose une conception et la met en œuvre une fois l’approche validée.
Cela inclut le travail de conception. Les formats de données, les limites de compilation et d’exécution, ainsi que la structure des nouveaux sous-systèmes sont ébauchés par Claude et revus avant le début de la mise en œuvre. Les conceptions sont souvent renvoyées, et certaines sont carrément rejetées.
Automatisation des tâches manuelles
Claude prend en charge les tâches répétitives ou scriptées qui nécessiteraient autrement un effort manuel — par exemple, la mise à jour en masse des champs Frontmatter dans de nombreux fichiers, le reformatage du contenu pour l’adapter à une nouvelle structure ou la génération de code standard suivant un modèle connu. Il s’agit de tâches dont la nature est claire, mais dont l’exécution est fastidieuse.
Développement de composants React et de tableaux de bord
Claude est utilisé pour écrire et itérer sur des composants React et des tableaux de bord de données. Cela inclut la mise en œuvre de nouveaux composants d’interface utilisateur, l’ajustement de la mise en page et du style, ainsi que l’intégration des données provenant de l’API GraphQL de TinaCMS. Claude s’inscrit dans les modèles de composants existants du projet plutôt que d’introduire de nouvelles abstractions.
Définition des schémas CMS
Claude rédige les définitions de collections et de modèles TinaCMS qui pilotent les formulaires d’édition, y compris la validation des champs et les règles qui affichent ou masquent des champs en fonction d’autres valeurs.
Rédaction de tests
Claude rédige et assure la maintenance de la suite de tests du projet. Les tests doivent vérifier le comportement par rapport à une source faisant autorité — une norme externe, une spécification ou le résultat réel généré — plutôt que de simplement reformuler ce que le code indique déjà.
Recherche de bogues
Claude aide à cerner l’origine des bogues en lisant le code pertinent, en vérifiant les modifications récentes et en réfléchissant aux causes probables. Cela s’avère particulièrement utile pour les bogues qui touchent plusieurs fichiers ou qui nécessitent de recouper la configuration avec le comportement.
Rédaction des règles de style
Claude est utilisé pour rédiger des règles Vale pour l’ensemble de styles docStatic. Cela inclut la création de nouvelles règles, leur test sur des exemples de contenu et l’affinage des modèles afin de réduire les faux positifs. Les règles sont validées dans .vale/styles/docStatic/ parallèlement à la documentation.
Maintenir l’architecture de l’information
Claude aide à maintenir l’architecture de l’information de l’ensemble de documentation : il examine la taxonomie, les balises et la structure des pages afin de garantir une catégorisation cohérente et une navigation logique. Il s’agit d’une tâche continue, généralement effectuée parallèlement aux révisions de contenu.
Vérification de cohérence du contenu
Claude examine la documentation pour s’assurer de la cohérence des faits, de l’absence de lacunes structurelles et de la fluidité logique. Il s’agit d’une vérification sommaire : elle ne remplace pas une relecture éditoriale formelle, mais s’avère utile pour détecter les problèmes évidents avant que le contenu ne parvienne aux relecteurs.
Rédaction de la documentation
Il arrive parfois que Claude produise une première ébauche d’une page de documentation, qui est ensuite relue et éditée par un auteur humain. Les ébauches sont considérées comme des points de départ, et non comme du contenu finalisé.
Avant de considérer qu'un travail est terminé, Claude exécute la commande yarn lint (Biome) sur les modifications apportées au code et la commande vale sur celles apportées à la documentation, puis corrige tout ce que ces outils signalent.
Le concept, l'orientation produit et les priorités de docStatic relèvent de la responsabilité du responsable du projet. Claude contribue à la conception et à la mise en œuvre de fonctionnalités spécifiques dans le cadre de cette orientation, et son travail est révisé avant d'être intégré. À la date de rédaction de cet article, Claude est co-auteur d'environ 6 % des commits.