Comment faire en sorte qu'un assistant IA respecte les conventions de codage de votre projet ?

Question

Accepted Answer

Une IA par défaut adopte une moyenne générique de ses données d'entraînement, donc pour obtenir **votre** style vous devez le **montrer et l'appliquer** — par des exemples, un fichier de règles explicite, et une boucle de linter qui détecte ce qui s'échappe. Ne comptez pas sur elle pour deviner vos standards (WordPress Coding Standards, PSR-12, etc.).

## Techniques (par ordre d'effet)

- **Fournir la configuration du linter et des exemples** — collez votre `.eslintrc`, `phpcs.xml`, ou `.editorconfig`. Ce sont les règles sous une forme vérifiable par machine, et l'IA peut les lire.
- **Conserver un fichier de règles/instructions** — un `CLAUDE.md` ou une instruction système qui énonce explicitement le standard : "Ce projet suit **PSR-12**. Utilisez une indentation de 4 espaces, accolades à la ligne suivante pour les fonctions, snake_case pour les hooks." Les instructions permanentes vous épargneront de vous répéter à chaque prompt.
- **Montrer du code existant représentatif** — un ou deux fichiers bien structurés enseignent la nommage, la structure, et les idiomes plus vite que n'importe quelle description. L'IA reconnaît les motifs qu'elle voit.
- **Exécuter le linter sur la sortie de l'IA et renvoyer les erreurs** — l'étape la plus fiable. Le linter est la source de vérité ; collez ses erreurs et demandez à l'IA de les corriger.

## La boucle du linter

```bash
# 1. AI generates the change, then you run the project linter on it:
phpcs --standard=phpcs.xml src/NewClass.php
# => src/NewClass.php  12 | ERROR | Expected 1 space after FUNCTION keyword; 0 found
#    src/NewClass.php  14 | ERROR | Line indented incorrectly; expected 4 spaces, found 2

# 2. Paste those exact errors back to the AI: "Fix these phpcs errors."
# 3. Re-run until clean. The linter — not the AI's claim — is the source of truth.
```

Cette boucle converge rapidement car le linter fournit des retours précis au niveau des lignes que l'IA peut appliquer directement, plutôt que vous décriviez le style en prose.

## Pourquoi c'est important

Le code qui ignore les conventions du projet crée une **friction d'examen et une incohérence** même quand il est fonctionnellement correct — les relecteurs perdent du temps sur le formatage, et la base de code s'en écarte. Une IA n'a aucune conscience de votre style maison à moins que vous le lui fournissiez, donc le travail consiste à rendre les règles **explicites et vérifiables** : un fichier de règles pour l'intention, du code représentatif pour les idiomes, et le linter comme applicateur dans la boucle. Cette même discipline (config + exemples + vérification automatisée) est comment vous intégrez un coéquipier humain à vos conventions aussi.