← Torna al blog
Aicirca 7 min di lettura

49 agenti, un solo gioco

Pubblicato 9 nov 2026
49 agenti, un solo gioco

Claude Code Game Studios è un template GitHub che trasforma una sessione di Claude Code in uno studio di videogiochi da 49 persone. 36.824 stelle, licenza MIT, 49 agenti, 74 skill sotto forma di slash command, 15 hook, 14 regole con ambito di percorso, 62 template di documenti.

Questo paragrafo è la versione che viene condivisa. La versione che vale la pena leggere è quattro righe più in basso nel README, in una sezione intitolata «Produce giochi o documenti?».

L'autore ha costruito quattro giochi partendo da un unico brief con impostazioni di processo diverse, e ha contato quanti documenti ciascuno ha scritto prima della prima riga di codice di gioco.

Con minimal il numero era uno — il brief di una pagina — e il tempo zero minuti. Con standard erano trenta documenti e cinquantotto minuti. Tutte e quattro le build hanno prodotto un gioco funzionante e testato.

Poi due revisori in cieco e un playtest umano hanno classificato la build standard all'ultimo posto.

Trenta documenti in più hanno comprato tracciabilità. Non hanno comprato un gioco migliore. Pubblicare quel risultato nel proprio README, in un progetto la cui intera proposta di valore è il processo, è un livello di onestà che non mi aspettavo, ed è il motivo per cui esiste questo pezzo.

Cosa c'è davvero nella scatola

La struttura è un organigramma di studio vero, ed è la decisione di design da cui discende tutto il resto.

Il primo livello sono i direttori: un direttore creativo, un direttore tecnico, un producer. Il secondo sono i capi reparto: game design, programmazione, arte, audio, narrativa, QA, release, localizzazione. Il terzo è una ventina abbondante di specialisti: programmatore gameplay, programmatore di engine, programmatore AI, programmatore di rete, programmatore di tool, programmatore UI, designer di sistemi, level designer, designer economico, technical artist, sound designer, scrittore, world builder, designer UX, prototipatore, analista di performance, ingegnere devops, ingegnere analytics, ingegnere della sicurezza, tester QA, specialista di accessibilità, designer live-ops.

Ognuno ha una responsabilità definita, un percorso di escalation e dei quality gate. La formulazione del README è che decidi ancora tutto tu, ma ora qualcuno ti fa le domande che farebbe uno studio: questo rientra nella visione, questo numero è una costante magica, dov'è il design doc di questo sistema.

Le skill sono il flusso di lavoro: /start, /brainstorm, /setup-engine godot 4.7, /project-stage-detect, /design-system, /create-epics, /create-stories, /dev-story, /story-done. Gli hook sono validazioni che scattano su commit, push, cambi agli asset, letture dei design doc e ciclo di vita della sessione. Le regole sono standard di codice con ambito di percorso, che si applicano quando modifichi codice di gameplay, codice di rete o file di scena.

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

Installarlo richiede circa un minuto

Prerequisiti: Git, Claude Code, Python 3, Bash e jq se vuoi la validazione degli hook. Su Windows, Bash arriva con Git for Windows.

Poi:

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

Avvia la sessione nella cartella che contiene CLAUDE.md e project.yaml. Avviarla in src/ salta gli hook del progetto, le regole di esclusione e la modalità di permessi che chiede prima di agire, disattivando di fatto buona parte del sistema.

Poi lancia /start. Ti chiede a che punto sei — nessuna idea, concetto vago, design chiaro, lavoro già avviato — e ti instrada. Se sai già cosa vuoi, passa direttamente a /brainstorm o /setup-engine godot 4.7.

L'unica decisione di configurazione che conta è modes.rigor: minimal, standard o full. È un singolo interruttore davanti a sei manopole separate: quali sezioni del GDD sono obbligatorie, densità dei documenti, livello di QA, granularità delle storie e modalità di revisione. /start lo scrive per te.

La parte che trovo davvero ben progettata

Due meccanismi spiccano.

Python è portante, e il README lo ammette. Ogni skill e ogni hook leggono project.yaml tramite Python. Se Python manca, ogni impostazione ricade silenziosamente sul valore predefinito. Gli hook altrimenti falliscono senza danni, perdi la validazione, niente si rompe. C'è esattamente un punto di blocco: un commit che mette in stage JSON di dati viene fermato se non c'è Python a validarlo. È un dettaglio strano, specifico, credibile. È l'aspetto che ha un sistema dopo un anno di uso reale.

Una modifica visiva non è finita finché qualcuno non l'ha guardata. Qualsiasi storia che cambi qualcosa che il giocatore vede non si chiude finché il gioco non è stato avviato, osservato e uno screenshot non è stato salvato in production/qa/evidence/. Un test che passa non è una partita. Un controllo di parsing non è una partita. Vale a ogni livello di rigore, compreso minimal, dove i test automatici sono esonerati ma l'occhio no.

Quella singola regola fa più per la qualità dell'output di quaranta documenti. I giochi falliscono visivamente in modi che i test non vedono: un menu disegnato fuori schermo, uno sprite con il pivot sbagliato, una camera che attraversa il pavimento alla seconda curva. Richiedere uno screenshot è la protezione più economica contro la classe di errori più comune, ed è imposta da un hook invece che dalla speranza.

A cosa servono i 62 template

Documenti di game design, specifiche UX, record delle decisioni architetturali, piani di sprint, design dell'HUD, revisioni di accessibilità. Presi da soli sono la carta che nessuno vuole scrivere. Dentro un sistema come questo sono ciò che gli agenti leggono prima di agire.

Questa è la loro funzione reale. Un documento qui non è una consegna: è il contesto che impedisce a un agente specialista di inventare una costante magica perché non conosceva la curva dei danni del sistema di combattimento. Quando l'agente art director deve sapere se il gioco è stilizzato o fotorealistico, legge il template dell'art bible che qualcuno ha compilato. Senza quel file, tira a indovinare.

Il che rilegge la misurazione di prima. Trenta documenti prima della prima riga di codice non sono trenta documenti di valore. Sono una scommessa che quei documenti verranno letti, dagli agenti, nei task successivi, più volte. Quando la scommessa paga ottieni coerenza. Quando non paga ottieni cinquantotto minuti di scrittura e una build classificata ultima da una giuria cieca.

La mia lettura è che il ritorno dipenda interamente da quanto il progetto dura più di una settimana. Su un weekend, scrivi una pagina. Su tre mesi, scrivi le trenta.

Il percorso di aggiornamento di cui nessuno parla

Clonare un template è facile. Portare le modifiche upstream in un repository che stai personalizzando da due mesi è la parte che fa male. Gli agenti vengono modificati, le regole vengono adattate al tuo engine, e la release successiva riorganizza una cartella.

Il README ha una sezione sugli aggiornamenti, che è più di quanto offrano quasi tutti i template, e il consiglio che conta è tenere le proprie modifiche in pochi posti prevedibili, i file delle regole e project.yaml, così che il resto si possa sostituire in blocco. Se fai un fork degli agenti stessi non potrai più prendere gli aggiornamenti, e il progetto si muove abbastanza in fretta perché questo conti entro una release o due.

Dove porta questo schema

Togli il vocabolario specifico del gioco e resta una ricetta generale: definisci i ruoli, dai a ciascuno un mandato stretto, metti dei gate tra le fasi e lascia che un agente direttore tenga la visione mentre gli specialisti eseguono. È la stessa forma di un'organizzazione ingegneristica reale, ed è la stessa forma che diversi team stanno costruendo per altri domini: una troupe cinematografica, un reparto marketing, un laboratorio di ricerca.

La riserva onesta è quella che l'autore ha già pubblicato. Più processo non correla con un risultato migliore, almeno a questa scala, con un brief e quattro build. Correla con la capacità di spiegare, tre settimane dopo, perché è stata presa una decisione. Per un team vale qualcosa, per una jam in solitaria quasi nulla.

Dovresti usarlo

Se stai costruendo un gioco da solo e il fallimento ricorrente è «ho trenta sistemi e nessuna visione coerente», parti da standard e guarda se le domande aiutano. Se il fallimento ricorrente è «passo tutto il tempo a scrivere documenti», parti da minimal, e nota che anche quell'impostazione fa comunque guardare lo schermo all'agente prima di dichiarare finita una storia.

Il template non costruisce un gioco per te. Fa comportare una sessione come una stanza piena di persone che hanno già pubblicato qualcosa. Se questo valga cinquantotto minuti è una domanda a cui ora puoi rispondere con una misura invece che con una sensazione, che è più di quanto offra la maggior parte degli strumenti AI.

Articoli correlati