Collaboration d'équipe avec Claude Code : Workflows multi-agents et partage de connaissances

1. La hiérarchie mémoire : CLAUDE.md comme mémoire organisationnelle

Les fichiers CLAUDE.md ne sont pas de simples configurations — ce sont le système de mémoire cumulative de votre équipe. Chaque erreur détectée et documentée devient un savoir permanent qui bénéficie à tous.

L'architecture mémoire à trois niveaux

Hiérarchie mémoire :

1. →Global - ~/.claude/CLAUDE.md (Tous les projets)
2. →Projet - /project/CLAUDE.md (Partagé en équipe)
3. →Local - /project/.claude/CLAUDE.md (Préférences personnelles)

Priorité : Local > Projet > Global

Le CLAUDE.md minimum viable

La plupart des projets n'ont besoin que de trois choses :

# Project Name

Brief one-sentence description of what this project does.

## Commands
- `pnpm dev` - Start development server
- `pnpm test` - Run tests
- `pnpm lint` - Check code style

C'est tout pour la plupart des projets. Claude détecte automatiquement :

• →La stack technique (depuis package.json, go.mod, Cargo.toml, etc.)
• →La structure des répertoires (via l'exploration)
• →Les conventions existantes (à partir du code lui-même)

N'ajoutez du contenu que lorsque c'est nécessaire — quand Claude fait une erreur deux fois à cause d'un manque de contexte, ajoutez ce contexte.

2. Mises à jour continues du contexte

Ne vous contentez pas de réagir aux erreurs — documentez proactivement les découvertes pendant les sessions de développement.

Que capturer par catégorie

3. La structure du dossier .claude/

Le dossier .claude/ est le répertoire Claude Code de votre projet pour la mémoire, les paramètres et les extensions.

.claude/
├── CLAUDE.md              # Instructions locales (gitignored)
├── settings.json          # Configuration des hooks (partagé en équipe)
├── settings.local.json    # Permissions personnelles (gitignored)
├── agents/                # Définitions d'agents personnalisés
├── commands/              # Commandes slash personnalisées
├── hooks/                 # Scripts événementiels
├── rules/                 # Conventions chargées automatiquement
├── skills/                # Modules de connaissances
└── plans/                 # Fichiers de plans sauvegardés

4. Pattern de source unique de vérité

Quand vous utilisez plusieurs outils IA (Claude Code, CodeRabbit, SonarQube, Copilot...), ils peuvent entrer en conflit si chacun a des conventions différentes.

Solution : Une source unique de vérité pour tous les outils :

/docs/conventions/
├── coding-standards.md    # Style, nommage, patterns
├── architecture.md        # Décisions de design système
├── testing.md             # Conventions de test
└── anti-patterns.md       # Ce qu'il faut éviter

Puis référencez depuis partout :

# Dans CLAUDE.md
@docs/conventions/coding-standards.md
@docs/conventions/architecture.md

# Dans .coderabbit.yml
knowledge_base:
  code_guidelines:
    filePatterns:
      - "docs/conventions/*.md"

5. Agents personnalisés pour les workflows d'équipe

Les agents sont des sous-processus spécialisés auxquels Claude peut déléguer des tâches. Ils encapsulent l'expertise.

Quand créer un agent

Template d'agent

Créez des agents dans .claude/agents/ :

---
name: code-reviewer
description: Use for code quality reviews, security audits, and performance analysis
model: sonnet
tools: Read, Grep, Glob
skills:
  - security-guardian
---

# Code Reviewer

## Role Definition
You are a senior code reviewer with expertise in:
- Code quality and maintainability
- Security best practices (OWASP Top 10)
- Performance optimization
- Test coverage analysis

## Methodology
1. **Understand Context**: Read the code and understand its purpose
2. **Check Quality**: Evaluate readability, maintainability, DRY principles
3. **Security Scan**: Look for OWASP Top 10 vulnerabilities
4. **Performance Review**: Identify potential bottlenecks
5. **Provide Feedback**: Structured report with severity levels

Guide de sélection de modèle

6. Skills : Modules de connaissances réutilisables

Les skills sont des packages de connaissances dont les agents peuvent hériter — pensez-les comme des bibliothèques d'expertise.

Constructeur de skills interactif

Créez votre propre skill personnalisé avec cet assistant pas à pas. Choisissez un type de skill, configurez ses capacités et générez un fichier SKILL.md prêt à l'emploi :

Pourquoi les skills ?

Sans skills :

Agent A : A des connaissances en sécurité (dupliqué)
Agent B : A des connaissances en sécurité (dupliqué)
Agent C : A des connaissances en sécurité (dupliqué)

Avec skills :

Skill security-guardian : Source unique de connaissances en sécurité
Agent A : hérite de security-guardian
Agent B : hérite de security-guardian
Agent C : hérite de security-guardian

Créer un skill

Les skills vivent dans .claude/skills/{nom-skill}/ :

security-guardian/
├── SKILL.md          # Instructions principales
├── reference.md      # Documentation détaillée
├── checklists/
│   ├── owasp-top10.md
│   └── auth-security.md
└── examples/
    ├── secure-auth.ts
    └── insecure-auth.ts

SKILL.md :

---
name: security-guardian
description: Expert guidance for security problems
allowed-tools: Read, Grep, Bash
---

# Security Guardian

You are a security expert specializing in:
- OWASP Top 10 vulnerabilities
- Authentication and authorization
- Input validation and sanitization
- Secure coding practices

## When Invoked
- Review code for security issues
- Audit authentication flows
- Check for injection vulnerabilities

7. Patterns d'orchestration multi-agents

Pour les tâches complexes, orchestrez plusieurs agents travaillant ensemble.

Constructeur de workflows interactif

Utilisez cet outil de glisser-déposer pour concevoir des workflows multi-outils. Combinez des outils de recherche comme Perplexity, des assistants de codage comme Claude Code et des plateformes de déploiement en pipelines fluides :

Le pattern d'analyse à rôles séparés

Lancez des agents spécialisés avec des perspectives différentes :

Exemple de prompt :

Analyze this PR with the following perspectives:
1. Senior Engineer: Architecture and patterns
2. Security Expert: Vulnerabilities and risks
3. Performance Engineer: Bottlenecks and optimizations
4. Junior Dev: Readability and documentation
5. QA Engineer: Testability and edge cases

La méthode des 7 tâches parallèles

Pour des fonctionnalités complètes, lancez 7 sous-agents spécialisés en parallèle :

1. →Composants → Créer les composants React
2. →Styles → Générer les styles Tailwind
3. →Tests → Écrire les tests unitaires
4. →Types → Définir les types TypeScript
5. →Hooks → Créer les hooks personnalisés
6. →Intégration → Connecter avec l'API/le state
7. →Config → Mettre à jour les configurations

Tous s'exécutent en parallèle, puis consolidation finale

8. Workflows d'équipe optimisés en coût

Utilisez l'orchestration de modèles pour l'efficacité en coût :

Pattern d'orchestration :

• →Orchestrateur : Sonnet 4.5 (planifie et coordonne)
• →Workers : 3x Haiku (exécutent les tâches parallèles)
• →Validateur : Sonnet 4.5 (révise et consolide)

Coût : 2-2,5x moins cher que d'utiliser Opus partout

Exemple d'optimisation des coûts :

Scénario : Refactoring de 100 fichiers

❌ Approche naïve :
- Opus pour tout
- Coût : ~50-100$
- Temps : 2-3h

✅ Approche optimisée :
- Sonnet : Analyse et plan (1x)
- Haiku : Workers parallèles (100x)
- Sonnet : Validation finale (1x)
- Coût : ~5-15$
- Temps : 1h (parallélisé)

9. TeammateTool : Multi-agents expérimental

Pour une orchestration vraiment complexe, Claude Code inclut un TeammateTool expérimental pour la communication multi-agents persistante :

Patterns :

• →Spécialistes parallèles : Le leader crée 3 coéquipiers → Chacun révise un aspect différent → Les coéquipiers travaillent simultanément → Rapportent → Le leader synthétise
• →Pattern essaim : Le leader crée une file de tâches partagée → Les coéquipiers s'auto-organisent et revendiquent les tâches → Exécution indépendante → Mises à jour asynchrones

10. Bonnes pratiques d'intégration d'équipe

Croissance progressive du CLAUDE.md

Semaine 1 : 5 règles  →  5 erreurs évitées
Semaine 4 : 20 règles → 20 erreurs évitées
Mois 3 : 50 règles → 50 erreurs évitées + onboarding plus rapide

Synchronisation multi-machines

Option 1 : Git + liens symboliques

# Machine 1 (configuration)
cd ~/claude-config-backup
git add agents/ commands/ hooks/ skills/
git commit -m "Add latest configs"
git push

# Machine 2 (synchronisation)
cd ~/claude-config-backup
git pull
# Les liens symboliques synchronisent automatiquement les répertoires ~/.claude/

Option 2 : Liens symboliques vers le cloud

# Les deux machines — déplacer ~/.claude/ vers le stockage cloud
mv ~/.claude ~/Dropbox/claude-config
ln -s ~/Dropbox/claude-config ~/.claude
# Les modifications se synchronisent automatiquement via Dropbox

Résumé : Les clés de la collaboration d'équipe

1. →CLAUDE.md comme mémoire organisationnelle : Capturez les erreurs une fois, prévenez-les pour toujours
2. →Hiérarchie à trois niveaux : Global → Projet → Local avec une priorité claire
3. →Source unique de vérité : Alignez tous les outils IA sur les mêmes conventions
4. →Agents pour l'expertise : Encapsulez le savoir-faire métier dans des agents réutilisables
5. →Skills pour le partage : Créez des modules de connaissances dont plusieurs agents héritent
6. →Patterns multi-agents : Analyse à rôles séparés et workers parallèles pour les tâches complexes
7. →Optimisation des coûts : Utilisez l'orchestration de modèles (orchestrateur Sonnet + workers Haiku)
8. →Mises à jour continues : Capturez les découvertes à chaque session

Poursuivez votre apprentissage

Prêt à maîtriser la collaboration d'équipe ? Notre module de formation Workflows d'équipe propose des exercices pratiques pour construire des fichiers CLAUDE.md partagés, créer des agents d'équipe et orchestrer des workflows multi-agents.