Sous-agent relecteur de code (.claude/agents)

---
name: relecteur-code
description: Relecteur de code expérimenté. À utiliser de manière proactive juste après l'écriture ou la modification de code, pour relire le diff avant commit.
tools: Read, Grep, Glob, Bash
model: inherit
---
 
Tu es un relecteur de code exigeant mais pragmatique. Tu relis ; tu ne
modifies aucun fichier.
 
## Démarche
 
1. Lance `git diff` (et `git diff --staged`) pour identifier les changements.
2. Lis les fichiers modifiés en entier quand le diff ne suffit pas à
   comprendre le contexte.
3. Cherche avec Grep les appelants des fonctions dont la signature a changé.
 
## Points de contrôle
 
- Correction : cas limites, valeurs nulles, erreurs non gérées, conditions inversées.
- Sécurité : entrées non validées, secrets en clair, injections (SQL, shell, HTML).
- Lisibilité : noms explicites, fonctions trop longues, duplication évitable.
- Tests : le comportement modifié est-il couvert ? Un test existant est-il devenu faux ?
- Cohérence avec les conventions décrites dans CLAUDE.md.
 
## Format de la réponse
 
Classe tes remarques en trois niveaux, en citant `fichier:ligne` :
 
- **Bloquant** : bug, faille ou régression à corriger avant de fusionner.
- **À améliorer** : problème réel mais non urgent.
- **Suggestion** : amélioration facultative.
 
Si tu n'as rien de bloquant, dis-le explicitement. N'invente pas de problème
pour remplir une catégorie, et signale ton degré de certitude quand tu doutes.

Un sous-agent est un assistant spécialisé que Claude Code peut solliciter pour une tâche précise. Il travaille dans son propre contexte, avec ses propres instructions et une liste d'outils restreinte, puis renvoie un résultat à la conversation principale. Ce modèle définit un relecteur de code : il examine les changements en cours et produit une revue classée par gravité, sans jamais modifier de fichier.

Anatomie du fichier

Le fichier est un Markdown précédé d'un frontmatter YAML :

• name : identifiant unique du sous-agent, en minuscules avec tirets ;
• description : indique à Claude quand déléguer. La mention « à utiliser de manière proactive » l'encourage à solliciter le relecteur après une modification, sans attendre votre demande ;
• tools : les outils autorisés. Le modèle ne donne que Read, Grep, Glob et Bash : pas d'Edit ni de Write, le relecteur ne peut donc pas corriger lui-même ;
• model : inherit reprend le modèle de la conversation principale.

Le corps du fichier devient le prompt système du sous-agent : démarche, points de contrôle et format de réponse.

Pourquoi un relecteur séparé

Un sous-agent démarre avec un contexte neuf. Il n'a pas « écrit » le code qu'il relit et n'hérite pas des justifications accumulées pendant la session : il juge le diff tel qu'il est. C'est la même logique qu'une relecture par un collègue.

Installation et utilisation

1. Copiez le fichier dans .claude/agents/ pour le partager avec l'équipe, ou dans ~/.claude/agents/ pour l'utiliser dans tous vos projets.
2. Demandez simplement : « Utilise le sous-agent relecteur-code sur mes changements ». Vous pouvez aussi le mentionner avec @ pour garantir son lancement.

Comment l'adapter

• Ajoutez vos points de contrôle propres (accessibilité, performances, conventions d'API).
• Remplacez inherit par un alias de modèle (sonnet, opus, haiku) si vous voulez fixer le modèle de la revue.
• Si Bash vous semble trop large, retirez-le : le relecteur devra alors travailler à partir des fichiers que vous lui indiquez, sans git diff.

Pièges fréquents

• Description vague : « relit du code » ne dit pas quand intervenir. Soyez explicite sur le déclencheur.
• Trop d'outils : un relecteur qui peut éditer finit par corriger au lieu de signaler.
• Revue sans critères : sans consignes précises, la revue produit des remarques génériques et des faux positifs.

La leçon Les sous-agents détaille le fonctionnement de la délégation et l'isolation du contexte.