Temps de lecture estimé : 10 minutes
🤖 Qu'est-ce que les Sub-agents ?
Les sub-agents Claude Code sont des agents IA spécialisés, chacun optimisé pour des tâches spécifiques du développement logiciel. Contrairement à un agent généraliste, chaque sub-agent possède une expertise approfondie dans son domaine.
🎯
Spécialisation
Expertise ciblée sur des domaines précis
⚡
Performance
Traitement optimisé et rapide
🔗
Collaboration
Travail coordonné entre agents
🛠️ Types de Sub-agents Disponibles
🔍Code Analyzer Agent
Spécialisé dans l'analyse statique de code, détection de patterns, et identification d'optimisations.
Capacités :
- • Analyse de complexité cyclomatique
- • Détection de code dupliqué
- • Identification de debt technique
- • Suggestions d'architecture
🚀Refactoring Agent
Expert en transformation de code, modernisation et application de design patterns.
Capacités :
- • Extract method/class automated
- • Design pattern implementation
- • Legacy code modernization
- • Performance optimizations
🧪Test Generator Agent
Génération automatique de tests unitaires, d'intégration et de validation.
Capacités :
- • Tests unitaires automatiques
- • Mock objects generation
- • Edge cases identification
- • Coverage analysis
📚Documentation Agent
Création et maintenance automatique de documentation technique et utilisateur.
Capacités :
- • API documentation automatic
- • README generation
- • Code comments intelligent
- • Architecture diagrams
🛡️Security Agent
Audit de sécurité, détection de vulnérabilités et suggestions de corrections.
Capacités :
- • OWASP compliance check
- • Dependency vulnerabilities
- • Input validation audit
- • Secure coding patterns
⚙️DevOps Agent
Automatisation CI/CD, configuration infrastructure et monitoring.
Capacités :
- • Pipeline CI/CD generation
- • Docker configuration
- • Infrastructure as Code
- • Monitoring setup
⚙️ Configuration et Utilisation
Activation des sub-agents
# Lister les sub-agents disponibles
claude-code agents list
# Activer des agents spécifiques
claude-code agents enable code-analyzer refactoring-agent test-generator
# Configuration globale
claude-code config set agents.auto-activate true
claude-code config set agents.parallel-execution trueConfiguration par projet
# .claude-agents.json
{
"activeAgents": [
"code-analyzer",
"test-generator",
"documentation"
],
"agentSettings": {
"code-analyzer": {
"complexityThreshold": 10,
"includePatterns": ["src/**/*.js"]
},
"test-generator": {
"framework": "jest",
"coverageTarget": 80
}
}
}Utilisation en ligne de commande
# Utilisation directe d'un agent
claude-code analyze \
--agent code-analyzer \
--target src/components/
# Orchestration multi-agents
claude-code workflow run \
--agents "analyzer,refactor,test" \
--sequenceWorkflows orchestrés
Exemple : Workflow de refactoring complet
# Définition du workflow
claude-code workflow create refactor-complete \
--steps "analyze,refactor,test,document,security-audit"
# Exécution avec validation entre étapes
claude-code workflow run refactor-complete \
--target src/legacy/ \
--confirm-each-step \
--generate-report🔍
Analyze
🚀
Refactor
🧪
Test
📚
Document
🛡️
Security
🚀 Cas d'Usage Avancés
1. Migration automatisée de framework
Orchestration de plusieurs agents pour migrer automatiquement un projet d'un framework à un autre (ex: Vue 2 → Vue 3, React Class → Hooks).
# Configuration de migration Vue 2 → Vue 3
claude-code migration setup \
--from vue2 \
--to vue3 \
--agents "analyzer,refactor,test,document"
# Analyse préalable
Analysis Agent: Scan codebase for Vue 2 patterns
├── Composition API candidates: 15 components
├── Breaking changes detected: 8 files
└── Dependencies to update: 12 packages
# Refactoring orchestré
Refactor Agent: Transform Vue 2 → Vue 3
├── Convert Options API → Composition API
├── Update event handlers syntax
├── Migrate deprecated filters
└── Update lifecycle hooks
# Validation automatique
Test Agent: Generate Vue 3 compatible tests
Documentation Agent: Update component docs2. Microservices decomposition
Analyse architecturale
- • Identification des bounded contexts
- • Analyse des dépendances
- • Détection des couplages faibles
- • Proposition de découpage
Implémentation automatisée
- • Extraction de services
- • Génération d'APIs REST/GraphQL
- • Configuration Docker/Kubernetes
- • Tests d'intégration
3. Performance optimization pipeline
Pipeline automatisé d'optimisation
# Workflow de performance
claude-code performance optimize \
--target production \
--metrics "page-load,api-response,bundle-size" \
--agents "analyzer,refactor,test"
Performance Analysis:
├── Bundle analysis: 2.3MB → 850KB possible
├── Database queries: 47 N+1 detected
├── Image optimization: 12MB savings
└── Code splitting: 8 lazy load opportunities
Auto-optimizations applied:
✓ Bundle splitting implemented
✓ Image compression (WebP)
✓ Database query optimization
✓ Component lazy loading🛠️ Création d'Agents Personnalisés
Agent personnalisé - Exemple pratique
Créons un agent personnalisé pour enforcer les conventions de nommage spécifiques à votre équipe.
1. Configuration de l'agent
# custom-agents/naming-enforcer.json
{
"name": "naming-enforcer",
"description": "Enforce team naming conventions",
"type": "linter",
"triggers": ["pre-commit", "file-save"],
"rules": {
"functions": {
"pattern": "^[a-z][a-zA-Z0-9]*$",
"prefix": {
"handlers": "handle",
"validators": "validate",
"utils": "get|set|is|has"
}
},
"components": {
"pattern": "^[A-Z][a-zA-Z0-9]*$",
"suffix": {
"pages": "Page",
"modals": "Modal",
"forms": "Form"
}
},
"constants": {
"pattern": "^[A-Z][A-Z0-9_]*$"
}
},
"actions": {
"onViolation": "suggest",
"autoFix": true,
"reportLevel": "warning"
}
}2. Logique de l'agent
# custom-agents/naming-enforcer.js
class NamingEnforcerAgent {
async analyze(files) {
const violations = [];
for (const file of files) {
const ast = this.parseFile(file);
violations.push(...this.checkFunctions(ast));
violations.push(...this.checkComponents(ast));
violations.push(...this.checkConstants(ast));
}
return {
violations,
suggestions: this.generateSuggestions(violations),
autoFixable: violations.filter(v => v.fixable)
};
}
async fix(violations) {
for (const violation of violations) {
if (violation.fixable) {
await this.applyFix(violation);
}
}
}
}3. Activation et utilisation
# Installation de l'agent personnalisé
claude-code agents install ./custom-agents/naming-enforcer
# Activation
claude-code agents enable naming-enforcer
# Test de l'agent
claude-code lint --agent naming-enforcer src/
# Intégration au workflow
claude-code workflow add-agent naming-enforcer \
--before refactoring-agent \
--auto-fixBest practices pour agents personnalisés
✅ À faire
- • Définir des règles claires et mesurables
- • Implémenter la capacité d'auto-correction
- • Fournir des suggestions contextuelles
- • Tester sur différents types de projets
- • Documenter les règles et exceptions
❌ À éviter
- • Règles trop strictes qui bloquent
- • Modifications sans validation
- • Ignorance du contexte existant
- • Performance dégradée
- • Manque de feedback utilisateur
🎯 L'avenir des Sub-agents
Les sub-agents représentent l'évolution vers une IA de développement plus spécialisée et efficace. Ils permettent une automatisation fine et contextuelle, tout en conservant le contrôle humain sur les décisions importantes.
🤖
IA Collaborative
Agents qui apprennent et s'adaptent
⚡
Automatisation Intelligente
Workflows adaptatifs
🎯
Spécialisation Poussée
Expertise de domaine