Aller au contenu principal
Agents

Top agents par cas d'usage

Les meilleurs agents Claude Code classés par catégorie : développement, architecture, sécurité, tests et maintenance. Description, quand les utiliser et exemples d'invocation.

Les agents incontournables

Claude Code dispose d'un catalogue d'agents spécialisés, chacun optimisé pour un type de tâche précis. Voici les agents les plus utiles classés par domaine, avec des exemples concrets d'utilisation.

Comment invoquer un agent ?

Les agents s'invoquent de deux manières : soit Claude Code les utilise automatiquement quand il juge la situation pertinente (si votre CLAUDE.md le configure), soit vous les demandez explicitement dans votre prompt. Par exemple : "Utilise l'agent code-reviewer pour analyser mon diff".

Développement

TDD Guide

Le guide TDD (Test-Driven Development) impose un workflow rigoureux qui garantit que chaque fonctionnalité est couverte par des tests.

Quand l'utiliserPour toute nouvelle feature ou correction de bug
Ce qu'il faitÉcrit les tests d'abord (RED), implémente le minimum (GREEN), puis refactore (IMPROVE)
Avantage cléGarantit une couverture de tests de 80%+ dès le départ
# Invocation explicite
> Utilise l'agent tdd-guide pour implémenter une fonction
> de validation d'adresse email avec les cas limites
# Claude Code va :
# 1. Écrire les tests (cas nominal, limites, erreurs)
# 2. Vérifier que les tests échouent (RED)
# 3. Implémenter le minimum pour les faire passer (GREEN)
# 4. Refactorer pour améliorer la qualité (IMPROVE)
# 5. Vérifier la couverture finale

Code Reviewer

L'agent de review analyse le code modifié et produit un rapport structuré avec des suggestions de correction.

Quand l'utiliserAprès chaque modification de code, avant un commit
Ce qu'il faitAnalyse le diff, identifie bugs, problèmes de performance, failles de sécurité
Avantage cléReview systématique et reproductible, classement par sévérité
# Invocation explicite
> Utilise l'agent code-reviewer pour analyser mes derniers changements
# Claude Code produit un rapport :
# - CRITICAL: Injection SQL dans la requête utilisateur (auth.ts:42)
# - HIGH: Variable non validée en entrée (utils.ts:18)
# - MEDIUM: Boucle N+1 dans la récupération des produits (api.ts:95)
# - LOW: Nom de variable peu descriptif (helpers.ts:12)

Build Error Resolver

Cet agent diagnostique et corrige les erreurs de build de manière méthodique.

Quand l'utiliserQuand le build échoue et que l'erreur n'est pas évidente
Ce qu'il faitAnalyse le message d'erreur, identifie la cause racine, propose et applique la correction
Avantage cléRésolution incrémentale, corrige une erreur à la fois et revérifie
# Invocation explicite
> Le build échoue avec "Module not found". Utilise l'agent
> build-error-resolver pour diagnostiquer et corriger.
# Claude Code va :
# 1. Lire le message d'erreur complet
# 2. Identifier le module manquant
# 3. Vérifier si c'est un problème d'import, de dépendance ou de config
# 4. Appliquer la correction minimale
# 5. Relancer le build pour vérifier

Architecture

Planner

L'agent de planification crée un plan d'implémentation structuré avant de toucher au code.

Quand l'utiliserAvant tout refactoring majeur ou nouvelle feature complexe
Ce qu'il faitProduit un plan avec PRD, architecture, design système, liste de tâches priorisées
Avantage cléÉvite de coder trop vite sans réflexion, identifie les risques en amont
# Invocation explicite
> Utilise l'agent planner pour planifier le refactoring
> du module de paiement. On veut passer de Stripe v2 à v3
> et ajouter le support Apple Pay.
# Claude Code produit :
# - PRD : objectifs, critères de succès, hors périmètre
# - Architecture : diagramme des composants impactés
# - Risques : compatibilité descendante, migration des données
# - Plan de tâches : 12 tâches ordonnées avec estimations
# - Critères de validation : tests à écrire pour chaque étape

Architect

L'agent architecte intervient sur les décisions de design système et les choix techniques structurants.

Quand l'utiliserPour les décisions d'architecture qui impactent plusieurs modules
Ce qu'il faitAnalyse les options, compare les trade-offs, recommande une approche
Avantage cléPrend en compte les contraintes de scalabilité, maintenabilité et performance
# Invocation explicite
> Utilise l'agent architect pour décider si on devrait
> utiliser un monorepo ou un multi-repo pour notre nouveau
> projet avec 3 microservices et un frontend.
# Claude Code analyse :
# - Taille de l'équipe et organisation
# - Fréquence de déploiement
# - Partage de code entre services
# - Complexité du CI/CD
# → Recommandation argumentée avec ADR (Architecture Decision Record)

Sécurité

Security Reviewer

L'agent de sécurité effectue un audit systématique du code à la recherche de vulnérabilités.

Quand l'utiliserAvant chaque commit, et en profondeur avant chaque release
Ce qu'il faitVérifie injection SQL, XSS, CSRF, secrets en clair, dépendances vulnérables
Avantage cléChecklist exhaustive, rien n'est oublié
# Invocation explicite
> Utilise l'agent security-reviewer pour auditer
> le module d'authentification avant la release.
# Claude Code vérifie :
# Pas de secrets en dur dans le code source
# Toutes les entrées utilisateur sont validées
# Requêtes SQL paramétrées (pas de concaténation)
# CSRF token manquant sur le formulaire de login
# Rate limiting non configuré sur /api/auth/login
# Mots de passe hashés avec bcrypt (cost factor 12)
# Session cookie sans flag HttpOnly

Un agent ne remplace pas un audit professionnel

L'agent security-reviewer est un excellent filet de sécurité pour le développement quotidien, mais il ne remplace pas un audit de sécurité professionnel pour les applications critiques. Utilisez-le comme première ligne de défense, pas comme unique protection.

Tests

E2E Runner

L'agent E2E génère et exécute des tests end-to-end qui simulent de vrais parcours utilisateurs.

Quand l'utiliserPour tester les parcours critiques avant une release
Ce qu'il faitÉcrit des tests Playwright qui naviguent, remplissent des formulaires, vérifient les résultats
Avantage cléTeste le comportement réel de l'application, pas juste les unités de code
# Invocation explicite
> Utilise l'agent e2e-runner pour tester le parcours
> d'inscription : formulaire, email de confirmation,
> première connexion, page d'accueil personnalisée.
# Claude Code génère et exécute un test Playwright complet
# qui simule tout le parcours utilisateur de bout en bout

Maintenance

Refactor Cleaner

L'agent de refactoring identifie et supprime le code mort, les dépendances inutilisées et les patterns obsolètes.

Quand l'utiliserLors des sprints de maintenance, après une migration majeure
Ce qu'il faitDétecte le code non utilisé, les imports inutiles, les dépendances fantômes
Avantage cléRéduit la taille de la codebase et améliore la lisibilité
# Invocation explicite
> Utilise l'agent refactor-cleaner pour nettoyer
> le dossier src/utils/. Identifie le code mort et
> les fonctions jamais appelées.
# Claude Code analyse :
# - formatDate() - jamais importée (dead code)
# - legacyParser.ts - tout le fichier est inutilisé
# - import lodash - seul _.get est utilisé, remplacer par optional chaining
# - calculateTax() - utilisée uniquement dans un test, à vérifier

Doc Updater

L'agent de documentation maintient la documentation technique à jour en fonction des changements de code.

Quand l'utiliserAprès un refactoring ou l'ajout de nouvelles fonctionnalités
Ce qu'il faitCompare le code actuel avec la documentation, met à jour les sections obsolètes
Avantage cléLa documentation reste synchronisée avec le code, sans effort manuel
# Invocation explicite
> Utilise l'agent doc-updater pour mettre à jour
> la documentation après le refactoring du module API.
# Claude Code :
# 1. Compare la doc existante avec le code actuel
# 2. Met à jour les signatures de fonctions modifiées
# 3. Ajoute la documentation des nouvelles routes
# 4. Corrige les exemples de code obsolètes
# 5. Vérifie que tous les liens internes fonctionnent

Tableau récapitulatif

AgentDomaineUsage principalFréquence recommandée
tdd-guideDevNouvelles features avec testsChaque feature
code-reviewerDevReview automatique du codeChaque commit
build-error-resolverDevDiagnostic d'erreurs de buildQuand le build échoue
plannerArchitecturePlanification avant codageFeatures complexes
architectArchitectureDécisions techniques structurantesChoix d'architecture
security-reviewerSécuritéAudit de sécurité du codeAvant chaque release
e2e-runnerTestsTests de parcours utilisateurAvant chaque release
refactor-cleanerMaintenanceNettoyage du code mortSprints de maintenance
doc-updaterMaintenanceMise à jour de la documentationAprès chaque refactoring

Prochaines étapes

Maintenant que vous connaissez les agents disponibles, apprenez à les combiner efficacement.