← Torna al blog
Aicirca 7 min di lettura

Quarantanove agents, settantaquattro skills e uno studio che chiede prima di costruire

Pubblicato 8 nov 2026
Quarantanove agents, settantaquattro skills e uno studio che chiede prima di costruire

La classifica settimanale di GitHub, questo mese, è piena di repository che impacchettano Claude Code in un'interfaccia più gradevole. Donchitos/Claude-Code-Game-Studios fa una cosa meno alla moda: dà alla sessione un organigramma. Il repository è un modello, non un'app. Lo cloni, apri Claude Code nella radice e l'assistente eredita un sistema di archiviazione, un insieme di regole su chi può decidere cosa, e 74 comandi slash. Ha preso circa 5.700 stelle in una settimana e ora sta a 36.845.

I numeri di richiamo sono 49 agents, 74 skills, 15 hook, 14 regole e 62 modelli di documento. Il numero di agents è la cosa più facile da gonfiare, quindi è la parte meno interessante. Quello che rende il repository degno di lettura è la parte difficile da falsificare: un modello di delega con una via di escalation, e hook che verificano se un subagent ha davvero fatto ciò che gli era stato detto.

Tre livelli, e una ragione per ciascuno

I 49 agents sono disposti come è disposto uno studio.

Il primo livello sono tre direttori: creative-director, technical-director e producer. Il secondo sono i capi reparto: game-designer, lead-programmer, art-director, audio-director, narrative-director, qa-lead, release-manager e localization-lead. Il terzo è una trentina di specialisti che coprono gameplay, motore, programmazione IA e di rete, design di livelli ed economia, technical art, sound design, scrittura, world building, UX, prototipazione, prestazioni, DevOps, analytics, sicurezza, QA, accessibilità, live ops e community.

Le regole su come si parlano sono nel README, e sono più rigide della maggior parte dei setup multi-agent:

Solo delega verticale, dai direttori ai capi, dai capi agli specialisti. La consultazione orizzontale è ammessa, ma agents dello stesso livello non possono prendere decisioni vincolanti fuori dal proprio dominio. I disaccordi salgono a un genitore comune: creative-director per le dispute di design, technical-director per quelle tecniche. I cambi tra reparti passano da producer. E nessun agent tocca file fuori dal proprio dominio senza delega esplicita.

L'ultima regola è quella che conta sul campo. La maggior parte dei fallimenti multi-agent non è un fallimento di ragionamento, è un fallimento di perimetro: un agent a cui è stato chiesto di correggere un bug di illuminazione riscrive il sistema di salvataggio perché ha notato qualcosa. Scrivere il confine del dominio e farlo rispettare da un capo che deve passare dalla delega è un rimedio grezzo e reale.

I livelli di modello sono una questione di budget

Ogni agent dichiara un modello nel frontmatter. I tre direttori chiedono Opus. lead-programmer e quindici specialisti indicano Sonnet. I restanti trenta ereditano il modello che sta girando nella tua sessione.

Il README è insolitamente esplicito: tratta i livelli come anzianità di ruolo, non come un piano tariffario, perché gran parte dello studio gira sul modello che hai già. È la versione onesta del discorso sui costi di un framework di agents. In pratica paghi una sessione più una manciata di chiamate a Opus sulle decisioni che determinano tutto il resto, ed è un posto difendibile dove spendere.

Che cosa controllano davvero gli hook

Quindici hook girano sugli eventi di sessione. Due meritano di essere nominati.

`log-agent.sh` e `log-agent-stop.sh` scrivono una traccia di audit quando un subagent parte e si ferma. È contabilità, ed è economica.

`validate-agent-artifact.sh` è quello interessante. Scatta quando un agent si ferma e avvisa se quel subagent non ha mai scritto il file indicato nel suo incarico. Il controllo è piccolo e punta a un guasto preciso, che conosce chiunque abbia lanciato agents in parallelo: il subagent dichiara successo, l'orchestratore va avanti, e il file non esiste. Prenderlo sull'evento di stop è il punto giusto, perché è l'ultimo momento in cui il genitore ha ancora il contesto per rilanciare il compito.

Gli altri hook coprono commit, push, cambi di asset, lettura e scrittura dei documenti di design, registri e ciclo di vita della sessione. Gli hook degradano con garbo quando manca uno strumento opzionale, con un'eccezione voluta: un commit che mette in stage un JSON di dati viene bloccato se Python non c'è, perché il validatore non può girare.

Le trappole stanno nell'elenco dei requisiti

L'installazione sono quattro righe nel README, e una è un avvertimento.

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

Poi digita `/start`. Il sistema chiede a che punto sei, da nessuna idea a progetto esistente, e ti instrada verso un workflow. Puoi anche saltare diretto a `/setup-engine godot 4.7`, `/brainstorm` o `/project-stage-detect`.

L'avvertimento: avvia Claude Code nella cartella che contiene `CLAUDE.md` e `project.yaml`. Se lo avvii in `src/`, gli hook del progetto, le regole deny e la modalità di permessi che chiede prima di agire vengono saltati del tutto. Ottieni un assistente senza nessuna struttura, e niente te lo dice.

Le dipendenze sono Git, Claude Code (si consiglia l'installer nativo, anche se `npm install -g @anthropic-ai/claude-code` funziona su Node 22+), Python 3 e Bash. Python 3 non è opzionale come sembra: ogni skill e ogni hook legge `project.yaml` attraverso di lui, e senza Python ogni impostazione torna in silenzio al valore predefinito. Un ritorno silenzioso è peggio di un crash, perché lo studio continua a girare con la configurazione sbagliata e nessuno se ne accorge finché una regola non scatta. jq è consigliato per la validazione degli hook.

Lo sviluppo principale è su Windows 10 con Git Bash, e gli hook sono testati anche su macOS con il suo bash 3.2 di serie e su Linux. `notify.sh` usa PowerShell per le notifiche di Windows e sulle altre piattaforme non fa nulla, quindi le notifiche desktop per ora sono solo su Windows.

Nove specialisti di motore, e te ne serve uno

Il modello fornisce set di agents per Godot 4, Unity e Unreal Engine 5. Ognuno ha un lead e dei sotto-specialisti: GDScript, shader e GDExtension per Godot; DOTS/ECS, shader e VFX, Addressables e UI Toolkit per Unity; GAS, Blueprints, replication e UMG/CommonUI per Unreal.

Tenere tutti e tre in un unico repository è una copertura ragionevole, e significa anche che il repository trasporta molto testo che non caricherai mai. La sezione sulla personalizzazione del README dice di cancellare i file degli agents che non servono: è il consiglio giusto e anche un compito che nessuno fa.

La parte che non è autonomia

Il README dice chiaramente che non è un pilota automatico, e il protocollo di collaborazione lo sostiene. Gli agents chiedono prima di proporre. Presentano da due a quattro opzioni con i relativi compromessi. Decide l'utente. Mostrano una bozza prima di finalizzare. Niente viene scritto senza approvazione. Le modalità `guided` e `autonomous` barattano parte di quelle conferme con la velocità, e il README rimanda al proprio documento di setup per le vie verso la modalità automatica.

C'è anche un harness di test per il framework stesso. `studio-tests/` cataloga tutti i 74 skills e i 49 agents con rubriche per categoria e specifiche di comportamento, e `/skill-test` esegue un linter statico con sette controlli di conformità, una rubrica di categoria o asserzioni di specifica. `/skill-improve` fa un ciclo di test, correzione e nuovo test, e torna indietro se il punteggio non sale. Testare il framework separatamente dal gioco è la disciplina che rende modificabile il resto.

A che cosa serve davvero

Il README pone la propria domanda scomoda nel titolo di una sezione: produce giochi o documenti? Un modello che consegna 62 modelli di documento e un cancello a ogni milestone scommette che lo sviluppo in solitaria fallisca sul processo e non sul codice. La scommessa è difendibile. I modi in cui un progetto individuale assistito dall'IA si rompe sono un numero magico scritto a mano che nessuno ha annotato, un documento di design che descrive un gioco di tre revisioni fa, e una build che esce con un tutorial rotto perché nessuno ha lanciato lo smoke check.

Quarantanove agents non risolvono questo. Una regola limitata a un percorso che scatta quando si modifica codice di gameplay, un `/smoke-check` che deve girare prima di una build e un hook che blocca un commit quando il validatore non può girare hanno più possibilità. La cosa interessante è che qualcuno ha messo per iscritto l'organigramma, comprese le parti in cui uno specialista deve escalare e aspettare.

Articoli correlati