Aller au contenu

Leçon 5 sur 9 · 8 min de lecture

Adapter les règles à votre code

Lisez et modifiez les règles du plugin du pipeline, exportez-les et importez-les, ou demandez à Claude de les réécrire à partir de vos dépôts — et relisez chaque modification avant son utilisation.

Ce que vous allez apprendre

  • Ce que sont les règles du plugin du pipeline et qui les modifie.
  • Comment modifier un fichier de règles et recharger le plugin.
  • Deux façons d’adapter les règles à votre code : Claude les réécrit, ou vous les exportez puis les importez.
  • Comment relire une proposition fichier par fichier.

Ce que sont les règles

Le plugin du pipeline contient les règles que Claude suit en Préparation, Vérification, Plan, Développement et Documentation : comment vos dépôts sont organisés en couches, comment fonctionnent les branches et les merge requests, comment le temps est enregistré. Paramètres › Plugin du pipeline les affiche. Tout le monde peut les lire ; les propriétaires et les administrateurs les modifient. Les changements ne concernent que les exécutions de votre organisation.

Les règles fournies décrivent les dépôts d’une seule entreprise. Les adapter aux vôtres est la plus grande amélioration possible de la qualité des plans.

Modifier un fichier

  1. Choisissez un fichier sous Règles et commandes.
  2. Cliquez sur Modifier, changez le texte, puis Enregistrer le brouillon. Un brouillon n’est pas encore utilisé ; Modifications montre l’écart avec le texte fourni.
  3. Cliquez sur Recharger le plugin. Les contrôles du plugin s’exécutent d’abord ; s’ils échouent, rien ne change et la page dit pourquoi.

Les nouvelles exécutions utilisent le plugin rechargé ; les étapes en cours gardent leur version. Pour revenir en arrière : Abandonner ma modification, Rétablir ce fichier par défaut, ou Rétablir par défaut pour tout.

Façon 1 · Demander à Claude de réécrire

Exemple : Acme Logistics a une passerelle, trois services et une bibliothèque partagée, et fusionne ses merge requests en squash dans develop.

  1. Sous Adapter les règles à votre code, cliquez sur Demander à Claude de réécrire.
  2. Sous Que faut-il changer ?, décrivez la différence — ou partez d’un modèle comme Notre architecture ou Nos règles git et de merge requests.
  3. Indiquez les Dépôts dont s’inspirer (facultatif quand Sourcebot est configuré) et cochez les Fichiers que Claude peut modifier (aucun coché : tous).
  4. Cliquez sur Demander à Claude et suivez en direct.

Claude lit votre code avec Sourcebot s’il est configuré ; sinon, les dépôts indiqués sont copiés en lecture seule dans un dossier temporaire, supprimé ensuite. Claude travaille sur une copie des règles et ne peut modifier que des fichiers de règles : pas de shell, pas de web, rien n’est poussé. Une seule réécriture à la fois par organisation, et vous pouvez l’annuler.

Astuce : soyez précis dans Que faut-il changer ? — nommez vos couches et vos branches. « Nos services s’appellent via la passerelle ; jamais d’appel direct à un service » vaut mieux que « utilisez notre architecture ».

Façon 2 · Exporter et importer

  1. Exporter télécharge les règles en .zip, avec un guide pour Claude (REWRITE-WITH-CLAUDE.md).
  2. Réécrivez-les où vous voulez — par exemple avec Claude Code à côté de votre code.
  3. Importer le .zip en retour, ou des fichiers de règles .md avec leur nom d’origine. Seuls les fichiers de règles existants sont lus ; le reste est signalé comme écarté.

Relire la proposition

Une réécriture ou un import devient une proposition, sous En attente de votre relecture. Rien ne change tant que vous ne l’ouvrez pas :

  1. Lisez l’écart pour chaque fichier, le résumé de Claude sur ce qui a changé et pourquoi, et si le plugin passerait ses contrôles.
  2. Cochez les fichiers à garder et cliquez sur Garder les fichiers cochés — cochez Recharger le plugin maintenant pour les utiliser aussitôt — ou Tout abandonner.

Astuce : ne gardez que ce que vous comprenez. Vous pouvez lancer une seconde réécriture pour le reste ; rien ne vous oblige à accepter toute une proposition.

Vérifiez vos acquis

1. Vous avez enregistré le brouillon d’un fichier de règles. Les nouvelles exécutions l’utilisent-elles ?

Pas avant d’avoir cliqué sur Recharger le plugin et que ses contrôles réussissent.

2. Pendant une réécriture, Claude peut-il pousser du code ou lancer des commandes ?

Non. Il travaille sur une copie des règles et ne peut modifier que des fichiers de règles — pas de shell, pas de web, rien n’est poussé.

3. Une proposition modifie six fichiers et vous êtes d’accord avec quatre. Que faites-vous ?

Cochez ces quatre fichiers et cliquez sur Garder les fichiers cochés ; les autres sont écartés.

Leçon terminée ?Marquez-la comme terminée pour suivre votre progression dans ce navigateur.