Votre agent de codage n'a qu'une seule personnalité par défaut : généraliste compétent. Demandez-lui de passer en revue un flux d'authentification et vous obtenez des conseils sensés mais oubliables. Demandez à un relecteur sécurité muni d'un modèle de menaces et d'une checklist, et vous obtenez de véritables constats. Cette différence ne coûte rien d'autre qu'un fichier markdown, et c'est pourquoi agency-agents a atteint 149 312 étoiles.
La bibliothèque est réellement utile. Elle reste cependant un dossier de fichiers sur une seule machine, une limite qui se fait sentir dès que plusieurs personnes ont besoin que ces rôles aient une signification concrète. Cet article présente ce que vous obtenez, comment n'installer que la partie qui vous intéresse, et la différence entre une définition de rôle et un Agent auquel une équipe peut confier du travail.
TL;DR
Il s'agit de l'une des cinq analyses approfondies issues de notre sélection d'outils open source qui étendent les agents de codage.
agency-agents est une collection de plus de 300 définitions de rôles d'agents réparties en une vingtaine de catégories, sous licence MIT, installable dans Claude Code, Cursor, Codex, Gemini CLI, OpenCode et une bonne douzaine d'autres outils en une seule commande. Chaque fichier décrit une identité, un processus de travail, des livrables et une définition du « terminé ». Un rôle change la façon dont un agent aborde une tâche ; il ne lui fournit pas les informations qui lui manquent et ne survit pas à la fin de la session. Installez une division, modifiez les fichiers pour qu'ils correspondent à votre stack, et faites passer ceux que vous utilisez chaque semaine au rang de configurations enregistrées qu'une équipe peut attribuer.
Ce que vous installez
D'après l'arborescence du dépôt au 1er septembre 2026, on compte 312 fichiers markdown répartis dans 20 dossiers de catégories de premier niveau. Le README du dépôt indique encore « 230+ », ce qui n'est plus à jour.
| Division | Fichiers | Division | Fichiers |
|---|---|---|---|
| engineering | 59 | testing | 9 |
| specialized | 58 | paid-media | 7 |
| marketing | 36 | project-management | 7 |
| game-development | 21 | academic | 6 |
| integrations | 18 | spatial-computing | 6 |
| strategy | 16 | support | 6 |
| gis | 13 | finance | 5 |
| security | 12 | product | 5 |
| design | 10 | healthcare | 3 |
| sales | 9 | examples | 6 |
La division engineering est celle par laquelle la plupart des équipes commencent, et la précision y est plus poussée que ce qu'atteint habituellement une collection de prompts. Aux côtés du Frontend Developer et du Backend Architect, on trouve un Network Engineer spécialisé dans Cisco IOS-XE et Juniper Junos, un Embedded Firmware Engineer pour les cibles ESP32 et STM32, un Incident Response Commander pour les post-mortems et la préparation d'astreinte, et un Codebase Onboarding Engineer conçu pour explorer un dépôt en lecture seule et énoncer des faits plutôt que proposer des modifications.
Ce dernier illustre bien le principe à l'œuvre. Un rôle en lecture seule avec un mandat explicite de non-modification est un outil différent de votre agent par défaut, et il ne coûte qu'un seul fichier.
N'installer que ce dont vous avez besoin
git clone https://github.com/msitarzewski/agency-agents.git
cd agency-agents
./scripts/install.sh # interactive
./scripts/install.sh --tool claude-code --division engineering,security
./scripts/install.sh --tool cursor --agent frontend-developer
./scripts/install.sh --list teams
./scripts/install.sh --tool opencode --division engineering --dry-run
Un avertissement documenté par le dépôt et que la plupart des articles passent sous silence : le runtime d'OpenCode enregistre environ 119 agents et abandonne silencieusement le reste. Installer un sous-ensemble avec --division vous maintient sous la limite, et l'installateur vous prévient lorsqu'une sélection la dépasserait. La troncature silencieuse est le pire mode de défaillance possible : le rôle que vous vouliez est absent et rien ne vous en informe.
Même sans ce bug, installer les 300 est une erreur. Un effectif dont vous ne vous souvenez pas est un effectif que vous n'utiliserez pas. Installez la division dans laquelle vous travaillez, lisez cinq fichiers et supprimez ceux qui ne correspondent pas au fonctionnement de votre équipe.
Où s'arrête une définition de rôle
Un rôle est un cadre. Il détermine ce que l'agent recherche, le format qu'il produit et ce qu'il considère comme terminé. Cela vaut plus qu'il n'y paraît, car ce qui rend souvent la production d'un agent faible n'est pas que le modèle se trompe, mais qu'il optimise pour une mauvaise forme de réponse.
Deux choses qu'un rôle ne peut pas faire.
Il ne peut pas fournir des informations que le modèle ne possède pas. Un rôle Backend Architect produit du code bien organisé face à une interface qu'il a déduite. Le rôle a amélioré la structure. Il n'a pas rendu le résultat correct.
Il ne survit pas à la session. Vous activez un rôle, il exécute une tâche, le terminal se ferme. Le lendemain, vous retapez l'activation. Neuf des divisions de ce dépôt décrivent des métiers qui n'existent qu'au sein d'une organisation, et l'outil qui les installe n'a aucune notion d'organisation. Il n'y a pas d'attribution, aucune trace de ce que le relecteur sécurité a trouvé mardi dernier, et aucun moyen pour un collègue de voir tout cela.
De la définition de rôle à l'Agent auquel confier du travail
Une définition de rôle est un prompt que vous retapez. Un Agent dans Sharkly est une configuration enregistrée : instructions, runtime, compétences, dépôts et environnement. C'est la version durable de ce que vise un fichier dans ~/.claude/agents/.
Chaque brique a une fonction précise. L'Agent définit comment le travail doit être traité. Le Computer fournit l'hôte et les ressources locales. Le Runtime exécute la session d'agent proprement dite, en utilisant l'outil de codage que votre équipe a déjà installé. La Task reste le registre partagé.
Sharkly ne remplace ni Claude Code, ni Codex, ni les rôles de ce dépôt. Il ajoute autour d'eux la couche de tâche partagée, de Computer, de contexte, de contrôle et de revue. L'usage des modèles continue de passer par les abonnements ou les clés API configurés dans ces outils.
Le concept de division se transpose directement. Un Crew est un groupe réutilisable de People et d'Agents coordonné par un Agent leader. Les Crews fonctionnent selon le principe du leader d'abord : le leader lit le contexte de la tâche, décide quels membres impliquer et réunit leurs résultats dans une seule Task, au lieu que chaque spécialiste se lance en même temps. C'est ce que agency-agents esquisse avec ses huit divisions sans pouvoir le mettre en œuvre, car un dossier de fichiers n'a ni leader ni tâche partagée vers laquelle revenir.
L'exécution, les blocages, les résultats et les échanges de suivi reviennent dans la chronologie de la tâche. Quand quelqu'un demande ce que le relecteur sécurité a trouvé, la réponse se trouve dans la Task.
Utilisez le dépôt comme une bibliothèque, pas comme une équipe
Utilisez agency-agents directement si vous êtes une personne seule, travaillant en local, et que vous voulez mieux cadrer le travail du jour. Installez une division, lisez les fichiers, obtenez un résultat en vingt minutes.
Utilisez des Agents enregistrés quand le rôle doit être réutilisé par plusieurs personnes, quand le résultat doit être relu avant d'être validé, ou quand quelqu'un demandera dans trois mois ce qu'un rôle a produit et pourquoi. Le seuil n'est pas la taille de l'équipe. C'est de savoir si le rôle doit survivre à la session.
La démarche pratique consiste à traiter le dépôt comme une matière première. Reprenez la structure de fichier, qui est la partie réellement réutilisable, remplacez le contenu générique par votre stack et votre définition du « terminé », et faites passer tout ce que vous utilisez deux fois par semaine en configuration enregistrée. Les bons fichiers partagent tous la même forme : une identité, une mission, un processus ordonné, des livrables avec un format, et des critères de réussite. Un rôle de relecture doté d'un processus en sept étapes produit des résultats cohérents d'une session à l'autre. Sans cela, il produit ce dont le modèle avait envie ce jour-là.
Les Agents recherchent, exécutent, testent et rendent compte. Les People fixent la direction, accordent l'autorité et acceptent le résultat.
Questions fréquentes
agency-agents fonctionne-t-il avec d'autres outils que Claude Code ? Oui. Un script de conversion génère des fichiers d'intégration pour chaque outil, et install.sh --tool en cible un précis. Claude Code, Cursor, Codex, Gemini CLI, OpenCode, Copilot, Windsurf, Aider et Kimi Code figurent parmi les cibles prises en charge. Une application de bureau pour macOS, Linux et Windows est également disponible.
Faut-il installer les 300 rôles ? Non. Sur OpenCode, c'est impossible : environ 119 s'enregistrent et le reste est abandonné sans avertissement. Sur d'autres outils, vous le pouvez, mais vous n'en utiliserez pas la plupart. Installez par division.
Les rôles rendent-ils un agent plus performant ? Ils le rendent mieux orienté. La cohérence et le format de sortie s'améliorent. La connaissance de faits que le modèle n'a jamais eus, elle, ne change pas.
Est-ce la même chose qu'un framework d'agents ? Non. Un framework vous apporte de l'orchestration d'exécution dans le code. agency-agents vous fournit des fichiers markdown qui modifient le comportement d'un agent existant. Couches différentes, aucun recoupement.
Quel est le rapport avec les Sharkly Skills ? Une Skill est une capacité que vous attachez à la configuration d'un Agent : elle est donc réutilisée avec cet Agent plutôt que réinstallée sur chaque machine. Les définitions de rôles de ce dépôt constituent une bonne matière première pour les écrire.
En résumé
agency-agents est la meilleure version disponible d'une idée : un agent travaille mieux quand il sait quel rôle il joue. Installez une division, lisez les fichiers, adaptez-les pour qu'ils correspondent à votre équipe.
Ensuite, soyez clair sur la limite. Les rôles ne connaissent pas les faits qui n'ont jamais été fournis à votre modèle, et ils ne perdurent dans rien qu'une équipe puisse voir ou relire. Un effectif est un bon point de départ. Ce n'est pas une organisation. Sharkly détient l'autre moitié : la Task est le registre partagé, l'exécution se déroule sur des Computers que vous connectez via les runtimes que vous payez déjà, et les résultats reviennent à un endroit où une personne peut les examiner et les accepter.
