Le plugin Compound Engineering étend Claude Code avec des agents spécialisés, des commandes slash, des compétences et des flux de travail structurés pour les cycles Plan → Travail → Révision → Compound.
| Étape | Commande |
|---|
| Installer Claude Code | Suivre la configuration sur claude.ai/code |
| Cloner le plugin | git clone https://github.com/anthropics/claude-code-plugins |
| Ajouter à Claude Code | Ajouter le chemin du plugin dans les paramètres de Claude Code |
| Vérifier | Exécuter /help dans Claude Code pour voir les commandes disponibles |
| Phase | Commande slash | Description |
|---|
| Plan | /plan | Transformer les descriptions de fonctionnalités en plans d’implémentation structurés |
| Travail | /lfg | Ingénierie autonome complète — exécuter les plans avec coordination multi-agents |
| Révision | /review-pr | Révision complète des PR utilisant des agents spécialisés en parallèle |
| Compound | /compound | Documenter les problèmes résolus pour construire la connaissance institutionnelle |
| Commande | Description |
|---|
/plan | Créer des plans d’implémentation structurés avec un détail au niveau des fichiers |
/brainstorm | Explorer les exigences et les approches avant la planification |
/deepen-plan | Enrichir un plan avec des agents de recherche en parallèle pour la profondeur et les bonnes pratiques |
/plan_review | Faire réviser un plan par plusieurs agents spécialisés en parallèle |
| Commande | Description |
|---|
/lfg | Flux de travail d’ingénierie autonome complet — planifier, implémenter, tester, réviser |
/resolve_parallel | Résoudre tous les commentaires TODO en traitement parallèle |
/resolve_pr_parallel | Résoudre tous les commentaires de PR en traitement parallèle |
/resolve_todo_parallel | Résoudre tous les todos CLI en attente en traitement parallèle |
| Commande | Description |
|---|
/review-pr | Révision complète des PR avec agents spécialisés (code, sécurité, performance) |
/code-review | Réviser un changement de code spécifique par rapport au plan et aux standards |
/test-browser | Exécuter les tests navigateur sur les pages affectées par la PR ou branche actuelle |
/reproduce-bug | Reproduire et investiguer les bugs en utilisant les journaux, la console et les captures d’écran |
| Commande | Description |
|---|
/compound | Documenter un problème résolu pour la connaissance institutionnelle |
/changelog | Créer des changelogs attrayants pour les fusions récentes vers main |
/deploy-docs | Valider et préparer la documentation pour GitHub Pages |
/release-docs | Construire et mettre à jour le site de documentation avec les composants actuels |
| Commande | Description |
|---|
/generate_command | Créer une nouvelle commande slash personnalisée |
/triage | Trier et catégoriser les résultats pour le système de todo CLI |
/feature-video | Enregistrer une vidéo de démonstration de fonctionnalité et l’ajouter à la description de la PR |
/agent-native-audit | Exécuter une revue complète de l’architecture agent-native |
| Agent | Fonction |
|---|
code-reviewer | Révise les bugs, erreurs logiques, la sécurité et la qualité du code |
code-simplifier | Simplifie le code pour plus de clarté tout en préservant la fonctionnalité |
silent-failure-hunter | Identifie les échecs silencieux et la gestion d’erreurs inadéquate |
comment-analyzer | Analyse les commentaires pour leur exactitude et maintenabilité |
pr-test-analyzer | Révise la qualité et la complétude de la couverture de tests |
type-design-analyzer | Analyse experte de la conception des types et des invariants |
code-simplicity-reviewer | Passe finale pour la conformité YAGNI et la complexité minimale |
| Agent | Fonction |
|---|
architecture-strategist | Évalue les décisions de conception système et les limites des composants |
security-sentinel | Audits de sécurité, évaluation des vulnérabilités, conformité OWASP |
performance-oracle | Analyse les performances, algorithmes, goulots d’étranglement, évolutivité |
agent-native-reviewer | Assure que les fonctionnalités sont accessibles aux agents, pas seulement aux humains |
pattern-recognition-specialist | Détecte les patrons de conception, anti-patrons et la duplication de code |
| Agent | Fonction |
|---|
kieran-rails-reviewer | Revue stricte des conventions et de la qualité Rails |
kieran-python-reviewer | Revue stricte des conventions et de la qualité Python |
kieran-typescript-reviewer | Revue stricte des conventions et de la qualité TypeScript |
dhh-rails-reviewer | Revue Rails du point de vue de DHH — détection d’anti-patrons |
julik-frontend-races-reviewer | Détection des conditions de course frontend en JS/Stimulus |
| Agent | Fonction |
|---|
data-integrity-guardian | Migrations de base de données, contraintes de données, intégrité référentielle |
data-migration-expert | Valide les mappages d’ID, la sécurité de rollback, les transformations de données |
deployment-verification-agent | Listes de vérification pré/post-déploiement, vérification SQL, plans de rollback |
| Agent | Fonction |
|---|
framework-docs-researcher | Récupère la documentation complète des frameworks et les bonnes pratiques |
learnings-researcher | Recherche les apprentissages institutionnels dans docs/solutions/ |
best-practices-researcher | Collecte les bonnes pratiques externes de la documentation et de l’OSS |
git-history-analyzer | Analyse archéologique de l’historique git et de l’évolution du code |
repo-research-analyst | Analyse complète de la structure du dépôt et des patrons |
| Agent | Fonction |
|---|
figma-design-sync | Synchronise l’implémentation avec les designs Figma |
design-implementation-reviewer | Vérifie que l’interface correspond aux spécifications Figma |
design-iterator | Raffinement itératif du design par N cycles capture-analyse-correction |
| Compétence | Déclencheur |
|---|
frontend-design | Construire des composants web avec une haute qualité de design |
agent-native-architecture | Concevoir des applications où les agents sont des citoyens de premier rang |
dspy-ruby | Framework Ruby pour des applications LLM type-safe et composables |
andrew-kane-gem-writer | Écrire des gems Ruby suivant les patrons d’Andrew Kane |
dhh-rails-style | Écrire du code Ruby/Rails dans le style DHH de 37signals |
| Compétence | Déclencheur |
|---|
brainstorming | Explorer l’intention et les approches avant l’implémentation |
git-worktree | Gérer les worktrees Git pour le développement parallèle isolé |
file-todos | Gérer le système de suivi des todos basé sur les fichiers |
every-style-editor | Réviser et éditer le texte selon le guide de style Every |
compound-docs | Capturer les problèmes résolus en documentation catégorisée |
| Compétence | Déclencheur |
|---|
agent-browser | Automatisation du navigateur avec le CLI agent-browser de Vercel |
rclone | Télécharger et synchroniser des fichiers entre fournisseurs de stockage cloud |
gemini-imagegen | Générer et éditer des images avec l’API Gemini |
xcode-test | Compiler et tester des applications iOS sur le simulateur |
skill-creator | Guide pour créer de nouvelles compétences efficaces |
| Hook | Événement | Fonction |
|---|
SessionStart | Initialisation de session | Configurer le contexte, charger les mémoires |
PreToolUse | Avant l’exécution d’un outil | Valider, bloquer les commandes dangereuses |
PostToolUse | Après l’exécution d’un outil | Traiter les résultats, déclencher les suivis |
Stop | Fin de l’agent | Vérifications finales, nettoyage |
UserPromptSubmit | L’utilisateur envoie un message | Pré-traiter l’entrée utilisateur |
La commande /review-pr lance plusieurs agents spécialisés en parallèle :
┌─────────────────────────────────────────────────┐
│ /review-pr │
├─────────────────────────────────────────────────┤
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ Code │ │ Security │ │ Perf │ │
│ │ Reviewer │ │ Sentinel │ │ Oracle │ │
│ └────┬─────┘ └────┬─────┘ └────┬─────┘ │
│ │ │ │ │
│ ┌────┴─────┐ ┌────┴─────┐ ┌────┴─────┐ │
│ │ Silent │ │ Type │ │ Pattern │ │
│ │ Failure │ │ Design │ │ Recog. │ │
│ └────┬─────┘ └────┬─────┘ └────┴─────┘ │
│ └──────────┬───┘──────────────┘ │
│ Rapport consolidé │
└─────────────────────────────────────────────────┘
# 1. Réflexion sur l'approche
/brainstorm
# 2. Créer un plan structuré
/plan
# 3. Approfondir avec des agents de recherche
/deepen-plan
# 4. Exécuter de manière autonome
/lfg
# 5. Réviser la PR
/review-pr
# 6. Documenter ce que vous avez appris
/compound
# Résoudre tous les commentaires de PR en parallèle
/resolve_pr_parallel
# Ou résoudre les TODOs dans tout le code
/resolve_parallel
# Générer une nouvelle commande slash
/generate_command
# Créer une nouvelle compétence
Utilisez la compétence skill-creator pour obtenir des conseils
compound-engineering/
├── plugin.json # Manifeste du plugin
├── commands/ # Définitions des commandes slash
│ ├── lfg.md
│ ├── plan.md
│ ├── review-pr.md
│ └── ...
├── agents/ # Définitions des agents
│ ├── code-reviewer.md
│ ├── security-sentinel.md
│ └── ...
├── skills/ # Définitions des compétences
│ ├── frontend-design/
│ ├── agent-native-architecture/
│ └── ...
└── hooks/ # Hooks d'événements
├── session-start.md
└── ...
Les agents sont définis dans des fichiers Markdown avec un frontmatter YAML :
---
name: "code-reviewer"
description: "Reviews code for bugs, logic errors, and quality"
tools:
- Glob
- Grep
- Read
- Task
model: sonnet # or opus, haiku
---
- Commencez par
/brainstorm avant de vous lancer dans l’implémentation — cela met en lumière les cas limites en amont
- Utilisez
/plan pour tout ce qui n’est pas trivial — même les fonctionnalités “simples” bénéficient d’une réflexion structurée
- Exécutez
/review-pr avant de fusionner — la révision multi-agents détecte des problèmes que les révisions en une passe manquent
- Documentez avec
/compound — la connaissance institutionnelle évite de répéter les mêmes erreurs
- Utilisez
/deepen-plan pour les fonctionnalités complexes — les agents de recherche ajoutent de la profondeur depuis la documentation et les bonnes pratiques
- Exploitez la résolution parallèle —
/resolve_parallel gère les TODOs plus rapidement que les corrections séquentielles
- Créez des compétences personnalisées pour les patrons récurrents — encapsulez la connaissance du domaine pour la réutilisation
- Utilisez le modèle
haiku pour les agents rapides — minimisez le coût et la latence pour les tâches simples
| Problème | Solution |
|---|
| Agent introuvable | Vérifiez le chemin du plugin dans les paramètres de Claude Code et redémarrez |
| Commande non reconnue | Exécutez /help pour lister les commandes disponibles, vérifiez plugin.json |
| L’agent retourne un résultat vide | Vérifiez la disponibilité du modèle, une clé API peut être nécessaire pour opus/sonnet |
| Révision multi-agents lente | Utilisez le modèle haiku pour les agents rapides, sonnet pour les critiques |
| Compétence non déclenchée | Vérifiez que la description de la compétence correspond à la formulation de votre prompt |
| Hook non déclenché | Vérifiez que le type d’événement du hook correspond (PreToolUse vs PostToolUse) |
| Plan trop vague | Utilisez /deepen-plan avec des agents de recherche pour plus de détails |
| Révision manquant de contexte | Fournissez explicitement l’URL de la PR ou le nom de la branche à /review-pr |
