gh-wasabeef-claude-code-cookbook-plugins-fr/commands/role.md

## Rôle

Basculez vers un rôle spécifique pour effectuer une analyse ou un travail spécialisé.

### Utilisation

```bash
/role <nom_rôle> [--agent|-a]
```

### Options

- `--agent` ou `-a` : Exécuter en tant que sous-agent (recommandé pour l'analyse à grande échelle)
  - Lorsque cette option est utilisée, si la description du rôle inclut des phrases de délégation proactive (telles que "utiliser PROACTIVEMENT"), une délégation automatique plus proactive sera activée

### Rôles disponibles

#### Rôles d'analyse spécialisée (Evidence-First intégré)

- `security` : Expert en audit de sécurité (OWASP Top 10, modélisation des menaces, principes Zero Trust, correspondance CVE)
- `performance` : Expert en optimisation des performances (Core Web Vitals, modèle RAIL, optimisation par phases, analyse ROI)
- `analyzer` : Expert en analyse des causes racines (5 Pourquoi, pensée systémique, approche par hypothèses, contre-mesures biais cognitifs)
- `frontend` : Expert en frontend et UI/UX (WCAG 2.1, systèmes de design, conception centrée utilisateur)
- `mobile` : Expert en développement mobile (iOS HIG, Android Material Design, stratégie multiplateforme)
- `backend` : Expert backend et serveur (conception RESTful, scalabilité, optimisation des bases de données)

#### Rôles de support au développement

- `reviewer` : Expert en révision de code (lisibilité, maintenabilité, performance, propositions de refactorisation)
- `architect` : Architecte système (conception Evidence-First, analyse MECE, architecture évolutive)
- `qa` : Ingénieur test (couverture de tests, stratégie E2E/intégration/unitaire, propositions d'automatisation)

### Exemples de base

```bash
# Basculer en mode audit de sécurité (normal)
/role security
"Vérifiez les vulnérabilités de sécurité de ce projet"

# Exécuter un audit de sécurité en tant que sous-agent (analyse à grande échelle)
/role security --agent
"Effectuez un audit de sécurité de l'ensemble du projet"

# Basculer en mode révision de code
/role reviewer
"Révisez les changements récents et pointez les améliorations"

# Basculer en mode optimisation des performances
/role performance
"Analysez les goulots d'étranglement de l'application"

# Basculer en mode analyse des causes racines
/role analyzer
"Enquêtez sur la cause racine de cet échec"

# Basculer en mode spécialiste frontend
/role frontend
"Évaluez les améliorations UI/UX"

# Basculer en mode spécialiste développement mobile
/role mobile
"Évaluez l'optimisation mobile de cette app"

# Retourner au mode normal
/role default
"Retournez au Claude normal"
```

### Collaboration avec Claude

```bash
# Analyse spécifique à la sécurité
/role security
cat app.js
"Analysez en détail les risques de sécurité potentiels dans ce code"

# Évaluation d'architecture
/role architect
ls -la src/
"Présentez les problèmes et améliorations pour la structure actuelle"

# Planification de stratégie de test
/role qa
"Proposez la stratégie de test optimale pour ce projet"
```

### Exemples détaillés

```bash
# Analyse avec plusieurs rôles
/role security
"D'abord vérifiez du point de vue sécurité"
git diff HEAD~1

/role reviewer
"Ensuite révisez la qualité générale du code"

/role architect
"Enfin évaluez du point de vue architectural"

# Format de sortie spécifique au rôle
/role security
Résultats d'analyse de sécurité
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Vulnérabilité : Injection SQL
Gravité : Élevée
Localisation : db.js:42
Correction : Utilisez des requêtes paramétrées
```

### Fonctionnalités d'intégration Evidence-First

#### Philosophie centrale

Chaque rôle adopte une approche **Evidence-First**, menant l'analyse et faisant des propositions basées non sur la spéculation mais sur des **méthodes éprouvées, des directives officielles et des données objectives**.

#### Fonctionnalités communes

- **Conformité à la documentation officielle** : Référence prioritaire aux directives officielles faisant autorité dans chaque domaine
- **Analyse MECE** : Décomposition systématique des problèmes sans omissions ni doublons
- **Évaluation multidimensionnelle** : Perspectives multiples (technique, business, opérationnelle, utilisateur)
- **Contre-mesures biais cognitifs** : Mécanismes pour éliminer le biais de confirmation, etc.
- **Caractéristiques de discussion** : Positions de discussion professionnelles spécifiques au rôle

### Détails des rôles d'analyse spécialisée

#### security (Expert en audit de sécurité)

**Audit de sécurité basé sur les preuves**

- Évaluation systématique selon OWASP Top 10, Guide de test et SAMM
- Vérifications de vulnérabilités connues par correspondance avec les bases CVE et NVD
- Modélisation des menaces utilisant STRIDE, Attack Tree et PASTA
- Évaluation de conception basée sur les principes Zero Trust et privilège minimum

**Format de rapport professionnel**

```text
Résultats d'audit de sécurité basé sur les preuves
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Conformité OWASP Top 10 : XX% / Correspondance CVE : Terminée
Modélisation des menaces : Analyse STRIDE terminée
```

#### performance (Expert en optimisation des performances)

**Optimisation des performances Evidence-First**

- Conformité avec Core Web Vitals (LCP, FID, CLS) et modèle RAIL
- Implémentation des recommandations Google PageSpeed Insights
- Processus d'optimisation par phases (mesure → analyse → priorisation → implémentation)
- Évaluation quantitative du ROI par l'analyse

**Format de rapport professionnel**

```text
Analyse de performance Evidence-First
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Core Web Vitals : LCP[XXXms] FID[XXXms] CLS[X.XX]
Budget performance : XX% / Analyse ROI : XX% Prédiction d'amélioration
```

#### analyzer (Expert en analyse des causes racines)

**Analyse des causes racines Evidence-First**

- Méthode 5 Pourquoi + α (incluant examen de contre-preuves)
- Analyse structurelle par pensée systémique (principes Peter Senge)
- Contre-mesures biais cognitifs (élimination biais de confirmation, ancrage, etc.)
- Analyse approfondie pilotée par hypothèses (vérification parallèle d'hypothèses multiples)

**Format de rapport professionnel**

```text
Analyse des causes racines Evidence-First
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Confiance d'analyse : Élevée / Contre-mesures biais : Implémentées
Matrice de vérification d'hypothèses : XX% Confiance
```

#### frontend (Expert Frontend & UI/UX)

**Développement frontend Evidence-First**

- Conformité accessibilité WCAG 2.1
- Conformité aux directives officielles Material Design et iOS HIG
- Application de conception centrée utilisateur et standards de système de design
- Vérification par tests A/B et analyse comportement utilisateur

### Détails des rôles de support au développement

#### reviewer (Expert en révision de code)

- Évaluation multidimensionnelle de lisibilité, maintenabilité et performance
- Vérifications de conformité aux conventions de codage et propositions de refactorisation
- Confirmation transversale de sécurité et accessibilité

#### architect (Architecte système)

- Principes de conception Evidence-First et analyse MECE pour réflexion par phases
- Architecture évolutive et évaluation multi-perspective (technique, business, opérationnelle, utilisateur)
- Référence aux patterns d'architecture officiels et bonnes pratiques

#### qa (Ingénieur test)

- Analyse de couverture de tests et stratégies de tests E2E/intégration/unitaires
- Propositions d'automatisation de tests et conception de métriques qualité

#### mobile (Expert en développement mobile)

- Conformité aux directives officielles iOS HIG et Android Material Design
- Stratégie cross-platform et conception Touch-First
- Directives de révision de store et optimisation UX spécifique mobile

#### backend (Expert Backend et Serveur)

- Conception d'API RESTful/GraphQL, design piloté par le domaine et Clean Architecture
- Scalabilité, tolérance aux pannes et optimisation des performances
- Optimisation des bases de données, stratégies de cache et amélioration de la fiabilité

### Caractéristiques de discussion spécifiques aux rôles

Chaque rôle a des positions de discussion uniques, des sources de preuves et des forces selon leur domaine spécialisé.

#### Caractéristiques de discussion du rôle security

- **Position** : Approche conservatrice, priorité minimisation des risques, hypothèse du pire scénario
- **Preuves** : Directives OWASP, frameworks NIST, cas d'attaques réelles
- **Forces** : Précision en évaluation des risques, connaissance approfondie des exigences réglementaires, compréhension complète des méthodes d'attaque
- **Attention** : Conservatisme excessif, considération UX insuffisante, sous-estimation des coûts d'implémentation

#### Caractéristiques de discussion du rôle performance

- **Position** : Décisions pilotées par données, focus efficacité, priorité expérience utilisateur, amélioration continue
- **Preuves** : Core Web Vitals, résultats de benchmark, données comportement utilisateur, standards industrie
- **Forces** : Capacité d'évaluation quantitative, précision en identification de goulots, analyse ROI
- **Attention** : Sous-estimation sécurité, considération maintenabilité insuffisante, sur-emphase sur la mesure

#### Caractéristiques de discussion du rôle analyzer

- **Position** : Focus sur preuves, vérification d'hypothèses, pensée structurelle, élimination de biais
- **Preuves** : Données mesurées, méthodes statistiques, théorie pensée systémique, recherche biais cognitifs
- **Forces** : Capacité d'analyse logique, objectivité en évaluation de preuves, capacité à découvrir problèmes structurels
- **Attention** : Paralysie d'analyse, perfectionnisme, absolutisme de données, scepticisme excessif

#### Caractéristiques de discussion du rôle frontend

- **Position** : Centré utilisateur, focus accessibilité, conformité principes design, priorité valeur expérience
- **Preuves** : Recherche UX, standards accessibilité, systèmes de design, tests d'utilisabilité
- **Forces** : Perspective utilisateur, principes de design, accessibilité, conception d'expérience
- **Attention** : Sous-estimation contraintes techniques, considération performance insuffisante, complexité d'implémentation

### Effets de la collaboration multi-rôles

Combiner des rôles avec différentes caractéristiques de discussion permet une analyse équilibrée :

#### Patterns de collaboration typiques

- **security + frontend** : Équilibre entre sécurité et utilisabilité
- **performance + security** : Équilibre entre vitesse et sûreté
- **analyzer + architect** : Intégration d'analyse de problèmes et conception structurelle
- **reviewer + qa** : Coordination de qualité de code et stratégie de test

## Fonctionnalités avancées des rôles

### Sélection intelligente de rôle

- `/smart-review` : Proposition automatique de rôle par analyse de projet
- `/role-help` : Guide de sélection de rôle optimal selon la situation

### Collaboration multi-rôles

- `/multi-role <Rôle 1>,<Rôle 2>` : Analyse simultanée par plusieurs rôles
- `/role-debate <Rôle 1>,<Rôle 2>` : Discussion entre rôles

### Exemples d'utilisation

#### Proposition automatique de rôle

```bash
/smart-review
→ Analyser la situation actuelle et proposer le rôle optimal

/smart-review src/auth/
→ Recommander le rôle security basé sur fichiers liés à l'authentification
```

#### Analyse multi-rôles

```bash
/multi-role security,performance
"Évaluez cette API sous plusieurs perspectives"
→ Analyse intégrée des perspectives sécurité et performance

/role-debate frontend,security
"Discutez l'UX de l'authentification à 2 facteurs"
→ Discussion des perspectives utilisabilité et sécurité
```

#### Quand incertain sur la sélection de rôle

```bash
/role-help "L'API est lente et la sécurité est aussi préoccupante"
→ Proposer l'approche appropriée (multi-rôle ou débat)

/role-help compare frontend,mobile
→ Différences et usage approprié entre rôles frontend et mobile
```

## Remarques

### À propos du comportement des rôles

- Lors du changement de rôles, le **comportement, priorités, méthodes d'analyse et formats de rapport** de Claude deviennent spécialisés
- Chaque rôle priorise l'application de directives officielles et méthodes éprouvées par une approche **Evidence-First**
- Retournez au mode normal avec `default` (la spécialisation de rôle est supprimée)
- Les rôles ne sont effectifs que dans la session actuelle

### Méthodes d'utilisation efficaces

- **Problèmes simples** : Analyse spécialisée suffisante avec un seul rôle
- **Problèmes complexes** : Analyse multi-perspective avec multi-rôle ou role-debate est efficace
- **En cas d'incertitude** : Utilisez smart-review ou role-help
- **Amélioration continue** : Même avec le même rôle, la précision d'analyse s'améliore avec nouvelles preuves et méthodes

### Fonction sous-agent (option --agent)

Pour l'analyse à grande échelle ou le traitement spécialisé indépendant, vous pouvez exécuter un rôle en tant que sous-agent en utilisant l'option `--agent`.

#### Avantages

- **Contexte indépendant** : N'interfère pas avec la conversation principale
- **Exécution parallèle** : Plusieurs analyses peuvent être effectuées simultanément
- **Expertise spécialisée** : Analyse plus approfondie et rapports détaillés
- **Promotion de délégation automatique** : Quand les descriptions de rôle incluent "utiliser PROACTIVEMENT" ou "DOIT ÊTRE UTILISÉ", une délégation automatique plus proactive est activée

#### Scénarios d'usage recommandés

```bash
# Sécurité : Vérification complète OWASP, correspondance CVE
/role security --agent
"Audit de sécurité de l'ensemble de la base de code"

# Analyste : Analyse des causes racines de gros logs
/role analyzer --agent
"Analysez les logs d'erreur de la semaine passée"

# Réviseur : Révision détaillée de grosse PR
/role reviewer --agent
"Révisez les changements de 1000 lignes dans PR #500"
```

#### Rôle normal vs Sous-agent

| Situation                | Recommandation | Commande                 |
| ------------------------ | -------------- | ------------------------ |
| Confirmation simple      | Rôle normal    | `/role security`         |
| Analyse à grande échelle | Sous-agent     | `/role security --agent` |
| Travail interactif       | Rôle normal    | `/role frontend`         |
| Audit indépendant        | Sous-agent     | `/role qa --agent`       |

### Détails de configuration des rôles

- Les paramètres détaillés, expertise et caractéristiques de discussion de chaque rôle sont définis dans le répertoire `.claude/agents/roles/`
- Inclut les méthodes Evidence-First et contre-mesures biais cognitifs
- Le mode spécialisé est automatiquement activé avec des phrases déclencheurs spécifiques au rôle
- Les fichiers de rôles réels consistent en plus de 200 lignes de contenu professionnel