Ce qu'il faut retenir
- Les 32 personas se répartissent en 7 catégories (engineering, specialized dev, documentation, research, business, creative, knowledge workers) activés automatiquement par détection contextuelle.
- Le smart router analyse chaque requête pour assigner le bon persona, mais vous pouvez forcer l'activation explicite via le préfixe octo suivi du domaine souhaité.
- Les personas custom permettent de créer des experts sur mesure adaptés aux conventions et au contexte métier spécifique de votre projet.
Résumé généré par IA
L’un des aspects les moins documentés de Claude Octopus est son système de personas. Pas parce qu’il est complexe, au contraire, il fonctionne de façon quasi transparente, mais parce que la plupart des introductions au plugin s’arrêtent aux commandes /octo:* sans expliquer ce qui tourne sous le capot.
Ce guide présente les 32 personas, leur logique d’activation automatique et comment les utiliser délibérément quand vous en avez besoin. Si vous découvrez Claude Octopus, commencez par notre guide complet, ce guide est complémentaire, pas introductif.
Comment les personas s’activent
Détection contextuelle automatique
Claude Octopus analyse chaque requête pour déterminer quel persona est le plus adapté. Cette détection est basée sur les mots-clés, le contexte du projet et l’historique de la session.
Quelques exemples de détection automatique :
| Ce que vous écrivez | Persona activé |
|---|---|
| “audit mon API pour des vulnérabilités” | security-auditor |
| “conçois un dashboard analytics” | ui-ux-designer |
| “refactore ce module en microservices” | backend-architect |
| “optimise les performances de cette requête SQL” | database-architect |
| “rédige la doc technique de cette API” | technical-writer |
| “analyse les risques de conformité RGPD” | compliance-specialist |
Le persona activé est toujours signalé dans la réponse (indicateur 🐙 + nom du persona). Vous pouvez donc vérifier a posteriori quel expert a pris la main.
Activation explicite via le smart router
Si la détection automatique ne choisit pas le bon persona, vous pouvez être explicite :
octo security-auditor : analyse ce handler d'authentification pour des failles OWASP Top 10Le préfixe octo active le smart router. Vous n’avez pas besoin de connaître le nom exact du persona, décrivez ce que vous cherchez et le router choisit.
Les 11 personas Software Engineering
C’est la catégorie la plus utilisée au quotidien. Ces personas couvrent l’ensemble du cycle de développement.
code-reviewer – Review de code généraliste. Cherche les problèmes de lisibilité, les anti-patterns, les violations de conventions. S’active sur les commandes /octo:review et /octo:staged-review. C’est souvent le premier persona engagé dans le pipeline de review adversariale, avant que les spécialistes (sécurité, architecture) prennent le relais.
security-auditor – Spécialisé OWASP. Analyse les injections SQL, XSS, CSRF, exposition de données sensibles, configuration des headers de sécurité. En mode adversarial, c’est le persona qui joue l’attaquant sur votre code. Pour une review de sécurité complète combinée avec la détection de CVE, il travaille avec Perplexity comme provider.
backend-architect – Conçoit les APIs, les services, les patterns d’intégration. S’active sur les questions d’architecture système, de découpage en services, de gestion des dépendances entre modules. Particulièrement utile en phase Define (Grasp) du pipeline Double Diamond.
frontend-developer – Composants, état, performance côté client. Couvre React, Vue, Angular et les frameworks modernes. S’active sur les questions de structure de composants, de gestion d’état et d’optimisation du rendu.
database-architect – Schémas, indexes, requêtes, migrations. Détecte les problèmes de N+1, suggère les index manquants, évalue les tradeoffs entre normalisation et performance. Très utile sur les PRs qui touchent les migrations Prisma, Alembic ou Liquibase.
test-automator – Stratégie de test, couverture, patterns de mocking. S’active quand vous écrivez “ajoute des tests”, “améliore la couverture” ou “teste ce composant”. Connaît pytest, Jest, RSpec, JUnit et les approches BDD/TDD.
devops-engineer – CI/CD, conteneurs, infrastructure. Couvre Docker, Kubernetes, GitHub Actions, les pipelines de déploiement. S’active sur les Dockerfiles, les workflows CI, les configs Helm.
performance-optimizer – Profiling, benchmarking, optimisations. Cherche les goulots d’étranglement, les allocations inutiles, les opérations bloquantes. Complémentaire au database-architect sur les stacks où la performance est critique.
api-designer – Design d’APIs REST et GraphQL. Naming des ressources, cohérence des réponses, versioning, documentation OpenAPI. S’active sur les questions de design d’interface avant l’implémentation.
code-refactorer – Dette technique, patterns, lisibilité. Spécialisé dans la transformation de code existant sans changer le comportement. Travaille avec le principe “refactorer en petites étapes vérifiables”.
debugging-specialist – Analyse de stack traces, reproduction de bugs, hypothèses de cause. S’active quand vous partagez une erreur ou décrivez un comportement inattendu.
Les 6 personas Specialized Development
Ces personas couvrent des domaines techniques spécifiques qui nécessitent une expertise profonde.
mobile-developer – iOS (Swift/SwiftUI) et Android (Kotlin/Jetpack Compose). Couvre les patterns natifs, les règles App Store / Play Store, les performances mobiles.
ai-ml-engineer – Pipelines ML, optimisation de modèles, déploiement. S’active sur les questions de feature engineering, d’évaluation de modèles, d’intégration d’APIs IA. Pertinent pour les développeurs qui intègrent des LLMs ou des modèles custom dans leurs applications, un sujet que nous couvrons régulièrement dans notre blog sur les agents IA.
blockchain-developer – Smart contracts, sécurité DeFi, audits Solidity. Connaît les patterns d’attaque courants (reentrancy, flash loans) et les bonnes pratiques de sécurité on-chain.
embedded-systems – Développement bas niveau, contraintes mémoire, temps réel. Pour le code C/C++ embarqué, les systèmes RTOS, les drivers.
game-developer – Unity, Unreal, game loops, optimisation GPU. S’active sur les questions de performance graphique, de physique, d’architecture de jeu.
data-engineer – Pipelines de données, ETL, data quality. Couvre Spark, dbt, Airflow, les architectures lakehouse.
Les 5 personas Documentation et Communication
Souvent sous-utilisés, ces personas produisent de la documentation technique de qualité, un investissement récurrent qui pèse lourd dans les équipes.
technical-writer – Documentation API, guides d’utilisation, READMEs. S’active sur “écris la doc de”, “génère un README”, “documente cette API”. Produit de la documentation en Markdown avec des exemples de code fonctionnels.
code-explainer – Explique le code existant en langage clair. Utile pour l’onboarding, pour comprendre du code hérité, ou pour préparer une review humaine complexe.
changelog-writer – Génère des changelogs à partir de diffs git. S’active sur “génère le changelog de cette release”.
architecture-documenter – Diagrammes d’architecture, ADR (Architecture Decision Records), documentation de design système. Produit du Mermaid et du PlantUML en plus du texte.
pr-description-writer – Rédige les descriptions de PR à partir du diff. Inclut le contexte, les changements principaux, les points de review suggérés.
Les 3 personas Research et Strategy
research-analyst – Comparatifs technologiques, évaluation de librairies, veille technique. S’active quand vous cherchez à choisir entre plusieurs options techniques. Travaille en parallèle avec Perplexity pour les données récentes.
project-planner – Décomposition de tâches, estimation, priorisation. S’active sur “découpe cette feature en tickets”, “estime le travail pour”.
requirements-analyst – Analyse et raffinage de specs. Identifie les ambiguïtés, les cas non couverts, les contraintes implicites. Particulièrement utile avant de lancer un Dark Factory Mode, voir notre guide du Dark Factory Mode.
Les 3 personas Business et Compliance
product-manager – PRDs, user stories, acceptance criteria. S’active sur les commandes /octo:prd et les requêtes de type “écris le PRD de”.
compliance-specialist – RGPD, SOC2, HIPAA, PCI-DSS. Analyse les implications de conformité des choix techniques. S’active sur “est-ce que ce code est conforme à”, “quels risques RGPD”.
cost-optimizer – Optimisation des coûts cloud, right-sizing, analyse d’architecture économique. S’active sur les questions d’infrastructure et de facturation cloud.
Les 4 personas Creative et Design
ui-ux-designer – Composants UI, accessibilité, UX patterns. S’active sur les questions de design d’interface, de hiérarchie visuelle, d’accessibilité WCAG.
graphic-designer – Assets visuels, systèmes de design, cohérence graphique. Plus orienté design system que code.
content-strategist – Copywriting technique, messaging, contenu marketing tech. S’active sur les demandes de rédaction de contenu autour d’un produit technique.
brand-specialist – Guidelines de marque, cohérence de communication. Utile pour les projets qui produisent des assets publics (doc, site, SDK).
Les Knowledge Workers (v6.0)
La version 6.0 de Claude Octopus a ajouté 6 personas pour les profils non-développeurs qui travaillent avec des équipes tech.
Ces personas sont conçus pour les chercheurs, consultants et product managers qui utilisent Claude Code pour des tâches de synthèse, d’analyse et de production de livrables – sans forcément écrire de code. Ils s’activent naturellement quand la requête est orientée “connaissance cristallisée” plutôt que “code fonctionnel”.
Créer un persona custom
Pour les contextes très spécifiques à votre organisation (stack propriétaire, conventions internes, domaine métier particulier), vous pouvez créer vos propres personas.
Un persona se définit dans un fichier Markdown dans .claude/agents/ de votre projet :
---
name: rails-senior
description: Expert Rails 7+ avec les conventions de notre codebase. Active sur les requêtes liées à nos modèles ActiveRecord, nos workers Sidekiq et nos patterns de service object.
tools: Read, Write, Edit, Bash, Glob, Grep
model: sonnet
---
Tu es un développeur Rails senior familier avec nos conventions :
- Service objects dans app/services/ avec méthode .call
- Pas de logique dans les controllers (max 5 lignes)
- Background jobs avec Sidekiq, pas de perform_now en production
- RSpec avec FactoryBot, pas de fixtures
[...]Les personas custom prennent la priorité sur les personas globaux pour le même projet. Si le nom conflict avec un persona global, la version projet l’emporte.
Ce que les personas changent concrètement
La différence entre Claude sans personas et Claude Octopus avec personas n’est pas spectaculaire sur une question simple. Elle devient significative sur trois types de situations :
Les questions spécialisées deep : “est-ce que cette requête Prisma génère un N+1 avec ce schéma ?” bénéficie d’un database-architect qui connaît les patterns Prisma en détail, pas juste un généraliste qui répond correctement mais superficiellement.
Les workflows longs : dans un pipeline Dark Factory ou un /octo:embrace complet, le bon persona s’active à la bonne phase. L’api-designer travaille en Define, le backend-architect en Develop, le security-auditor en Deliver. La cohérence du pipeline tient à cette spécialisation.
Le contexte de review adversariale : quand 4 agents reviewent votre PR depuis des angles différents, c’est la spécialisation des personas qui rend les findings distincts et complémentaires, pas juste des variantes du même commentaire.
En résumé
Les 32 personas de Claude Octopus fonctionnent bien sans intervention de votre part, la détection automatique couvre la majorité des cas. Comprendre qui fait quoi devient utile quand vous voulez activer explicitement un expert spécifique, créer des personas custom pour votre contexte, ou comprendre pourquoi le pipeline prend certaines décisions.
Pour l’installation et la configuration initiale, consultez notre guide d’installation. Pour les cas d’usage avancés comme le Dark Factory Mode et les pipelines autonomes, notre guide dédié couvre tout.
Les autres outils d’agents IA pour le développement sont recensés dans notre annuaire, Claude Octopus n’est pas le seul, mais son approche par personas et framework méthodologique le distingue clairement du reste.
FAQ Claude Octopus personas
Oui. L’intégralité des personas est disponible avec Claude seul, sans aucun provider externe. Les providers additionnels (Codex, Gemini, Perplexity) enrichissent les résultats de certains personas, notamment security-auditor avec Perplexity pour les CVE, mais ils ne débloquent pas de nouveaux personas.
Chaque activation est signalée visuellement dans la réponse par un indicateur 🐙 suivi du nom du persona. Si vous voulez systématiquement tracer les activations, les logs sont disponibles dans ~/.claude-octopus/logs/.
Oui. Utilisez le préfixe octo suivi du nom du persona : octo security-auditor : analyse ce handler pour des failles OWASP Top 10
Vous n’avez pas besoin de connaître le nom exact, décrivez ce que vous cherchez et le smart router sélectionne le persona le plus adapté.
Claude Octopus sélectionne le persona principal et peut en activer un second en support selon la complexité de la tâche. Par exemple, une question sur une requête Prisma mal optimisée peut activer database-architect en principal et performance-optimizer en soutien.
Créez un fichier Markdown dans .claude/agents/ à la racine de votre projet. Le fichier doit contenir un frontmatter YAML avec name, description, tools et model, suivi des instructions du persona en corps. Le persona devient immédiatement disponible dans les sessions Claude Code sur ce projet et prend la priorité sur les personas globaux en cas de conflit de nom.
security-auditor remplace-t-il un audit de sécurité professionnel ? Non. Le security-auditor est excellent pour détecter les problèmes OWASP courants, les configurations incorrectes et les patterns dangereux connus. Il ne remplace pas un pentest ou un audit de sécurité formel pour du code en production exposé à des risques élevés. Utilisez-le comme premier filtre, pas comme certification.