← Retour au blog
AiEnviron 9 min de lecture

49 agents, un seul jeu

Publié le 9 nov. 2026
49 agents, un seul jeu

Claude Code Game Studios est un template GitHub qui transforme une session Claude Code en studio de jeu de 49 personnes. 36 824 étoiles, licence MIT, 49 agents, 74 compétences en commandes slash, 15 hooks, 14 règles limitées à des chemins, 62 modèles de documents.

Ce paragraphe est la version qui circule. La version qui vaut la lecture est quatre lignes plus bas dans le README, dans une section intitulée « Est-ce que ça produit des jeux, ou des documents ? »

L'auteur a construit quatre jeux à partir d'un même brief, avec des réglages de processus différents, et a compté combien de documents chacun avait écrits avant la première ligne de code de jeu.

En mode minimal, ce nombre était de un (le brief d'une page) et le temps de zéro minute. En mode standard, trente documents et cinquante-huit minutes. Les quatre versions ont produit un jeu qui tourne et qui est testé.

Puis deux relecteurs à l'aveugle et un test de jeu humain ont classé la version standard dernière.

Les trente documents supplémentaires ont acheté de la traçabilité. Ils n'ont pas acheté un meilleur jeu. Publier ce résultat dans son propre README, dans un projet dont toute la proposition de valeur est le processus, c'est un niveau d'honnêteté que je n'attendais pas, et c'est la raison d'être de cet article.

Ce qu'il y a vraiment dans la boîte

La structure est un vrai organigramme de studio, et c'est la décision de conception dont tout le reste découle.

Le premier niveau, ce sont les directeurs : un directeur créatif, un directeur technique, un producteur. Le deuxième, les responsables de département : game design, programmation, art, audio, narration, QA, publication, localisation. Le troisième, une vingtaine de spécialistes : programmeur gameplay, programmeur moteur, programmeur IA, programmeur réseau, programmeur outils, programmeur interface, designer de systèmes, designer de niveaux, designer d'économie, artiste technique, designer sonore, écrivain, constructeur de monde, designer UX, prototypiste, analyste de performance, ingénieur devops, ingénieur analytics, ingénieur sécurité, testeur QA, spécialiste accessibilité, designer live-ops.

Chacun a une responsabilité définie, une voie d'escalade et des portes de qualité. La formulation du README : vous prenez toujours toutes les décisions, mais désormais quelqu'un vous pose les questions qu'un studio poserait. Est-ce que ça correspond à la vision, est-ce que ce nombre est une constante magique, où est le document de design de ce système.

Les compétences, c'est le flux de travail : /start, /brainstorm, /setup-engine godot 4.7, /project-stage-detect, /design-system, /create-epics, /create-stories, /dev-story, /story-done. Les hooks sont des validations qui se déclenchent sur les commits, les push, les changements d'assets, la lecture de documents de design et le cycle de vie des sessions. Les règles sont des standards de code limités à des chemins, qui s'appliquent quand vous éditez du code de gameplay, du code réseau ou des fichiers de scène.

A long meeting table surrounded by empty chairs, one document at the head

L'installation prend environ une minute

Prérequis : Git, Claude Code, Python 3, Bash, et jq si vous voulez la validation par hooks. Sous Windows, Bash vient avec Git for Windows.

Ensuite :

git clone https://github.com/Donchitos/Claude-Code-Game-Studios.git my-game
cd my-game
claude

Démarrez la session dans le dossier qui contient CLAUDE.md et project.yaml. La démarrer dans src/ contourne les hooks du projet, les règles de refus et le mode de permissions « demander d'abord », ce qui désactive discrètement l'essentiel du système.

Lancez ensuite /start. Il vous demande où vous en êtes (aucune idée, concept vague, design clair, travail existant) et vous oriente. Si vous savez déjà ce que vous voulez, sautez directement à /brainstorm ou /setup-engine godot 4.7.

La seule décision de configuration qui compte est modes.rigor : minimal, standard ou full. C'est un seul interrupteur devant six boutons distincts : quelles sections du GDD sont obligatoires, la densité documentaire, le niveau de QA, la granularité des stories et le mode de relecture. /start l'écrit pour vous.

La partie que je trouve vraiment bien conçue

Deux mécanismes ressortent.

Python est porteur, et le README l'admet. Chaque compétence et chaque hook lisent project.yaml via Python. Si Python manque, tous les réglages retombent silencieusement sur leur valeur par défaut. Les hooks échouent proprement, vous perdez la validation, rien ne casse. Il existe exactement un arrêt net : un commit qui indexe des JSON de données sera bloqué s'il n'y a pas de Python pour les valider. C'est un détail étrange, précis, crédible. C'est à ça que ressemble un système après un an d'usage réel.

Un changement visuel n'est pas fini tant que personne ne l'a regardé. Toute story qui modifie quelque chose que le joueur voit ne peut pas être fermée avant que le jeu ait été lancé, observé, et qu'une capture ait été enregistrée dans production/qa/evidence/. Un test qui passe n'est pas un lancement. Une vérification de parsing n'est pas un lancement. Cela vaut à tous les niveaux de rigueur, y compris minimal, où les tests automatisés sont levés mais pas le coup d'œil.

Cette seule règle fait plus pour la qualité du résultat que quarante documents. Les jeux échouent visuellement d'une manière que les tests ne voient pas : un menu dessiné hors écran, un sprite avec le mauvais point d'ancrage, une caméra qui traverse le sol au deuxième virage. Exiger une capture est la garde la moins chère possible contre la classe de panne la plus courante, et elle est appliquée par un hook plutôt que par l'espoir.

À quoi servent les 62 modèles

Documents de design de jeu, spécifications UX, comptes rendus de décisions d'architecture, plans de sprint, design de HUD, revues d'accessibilité. En eux-mêmes, c'est la paperasse que personne ne veut écrire. Dans un système comme celui-ci, c'est ce que les agents lisent avant d'agir.

C'est la fonction réelle. Un document n'est pas une livraison ici, c'est le contexte qui empêche un agent spécialiste d'inventer une constante magique parce qu'il ne connaissait pas la courbe de dégâts du système de combat. Quand l'agent directeur artistique a besoin de savoir si le jeu est stylisé ou photoréaliste, il lit la bible artistique que quelqu'un a remplie. Sans ce fichier, il devine.

Ce qui recadre la mesure précédente. Trente documents avant la première ligne de code, ce ne sont pas trente documents de valeur. C'est un pari que les documents seront lus, par les agents, sur des tâches ultérieures, de façon répétée. Quand le pari paie, vous obtenez de la cohérence. Quand il ne paie pas, vous obtenez cinquante-huit minutes d'écriture et une version classée dernière par un jury à l'aveugle.

Mon avis, c'est que le gain dépend entièrement de la durée de vie du projet. Sur un week-end, écrivez une page. Sur trois mois, écrivez les trente.

La voie de mise à jour dont personne ne parle

Cloner un template est facile. Récupérer les changements amont dans un dépôt que vous personnalisez depuis deux mois, c'est la partie douloureuse. Les agents sont modifiés, les règles sont ajustées à votre moteur, et la version suivante réorganise un dossier.

Le README a une section sur la mise à jour, ce qui est déjà plus que la plupart des templates, et le conseil qui compte est de garder vos modifications dans un petit nombre d'endroits prévisibles, les fichiers de règles et project.yaml, pour que le reste puisse être remplacé en bloc. Si vous forkez les agents eux-mêmes, vous ne pourrez plus prendre les mises à jour, et le projet avance assez vite pour que ça compte d'ici une version ou deux.

Où mène ce schéma

Retirez le vocabulaire propre au jeu et il reste une recette générale : définir des rôles, donner à chacun un mandat étroit, placer des portes entre les phases, et laisser un agent directeur tenir la vision pendant que les spécialistes exécutent. C'est la même forme qu'une vraie organisation d'ingénierie, et la même forme que plusieurs équipes construisent aujourd'hui pour d'autres domaines : une équipe de cinéma, un service marketing, un laboratoire de recherche.

La réserve honnête est celle que l'auteur a déjà publiée. Plus de processus n'est pas corrélé à un meilleur résultat, du moins pas à cette échelle, avec un brief et quatre versions. Ce à quoi c'est corrélé, c'est la capacité d'expliquer trois semaines plus tard pourquoi une décision a été prise. Ça vaut quelque chose pour une équipe et presque rien pour une participation solo à une game jam.

Faut-il l'utiliser

Si vous construisez un jeu seul et que l'échec récurrent est « j'ai trente systèmes et aucune vision cohérente », commencez en standard et voyez si les questions aident. Si l'échec récurrent est « je passe tout mon temps à écrire des docs », commencez en minimal, et notez que même ce réglage oblige l'agent à regarder l'écran avant de déclarer une story terminée.

Le template ne fait pas le jeu à votre place. Il fait qu'une session se comporte comme une salle pleine de gens qui ont déjà livré. Savoir si ça vaut cinquante-huit minutes est une question à laquelle vous pouvez désormais répondre avec une mesure plutôt qu'avec une impression, ce qui est déjà plus que ce qu'offre la plupart de l'outillage IA.

Articles associés