← Voltar ao blog
Aicerca de 8 min de leitura

Quarenta e nove agents, setenta e quatro skills e um estúdio que pergunta antes de construir

Publicado 8 de nov. de 2026
Quarenta e nove agents, setenta e quatro skills e um estúdio que pergunta antes de construir

A lista semanal do GitHub deste mês está cheia de repositórios que embrulham o Claude Code numa interface mais bonita. O Donchitos/Claude-Code-Game-Studios faz algo menos na moda: dá à sessão um organograma. O repositório é um template, não um app. Você clona, abre o Claude Code na raiz, e o assistente herda um sistema de arquivamento, um conjunto de regras sobre quem pode decidir o quê, e 74 comandos de barra. Ganhou cerca de 5.700 estrelas em uma semana e está em 36.845.

Os números de manchete são 49 agents, 74 skills, 15 hooks, 14 regras e 62 templates de documento. A contagem de agents é a coisa mais fácil de inflar, então é a parte menos interessante. O que torna o repositório digno de leitura é o que é difícil de falsificar: um modelo de delegação com caminho de escalonamento, e hooks que checam se um subagent realmente fez o que lhe foi pedido.

Três níveis, e um motivo para cada

Os 49 agents estão dispostos do jeito que um estúdio é disposto.

O primeiro nível são três diretores: creative-director, technical-director e producer. O segundo são os líderes de departamento: game-designer, lead-programmer, art-director, audio-director, narrative-director, qa-lead, release-manager e localization-lead. O terceiro são uns trinta especialistas cobrindo gameplay, engine, programação de IA e de rede, design de níveis e economia, arte técnica, sound design, roteiro, construção de mundo, UX, prototipagem, performance, DevOps, analytics, segurança, QA, acessibilidade, live ops e comunidade.

As regras de como eles conversam estão no README, e são mais rígidas que a maioria dos arranjos multi-agent:

Só delegação vertical, de diretores para líderes, de líderes para especialistas. Consulta horizontal é permitida, mas agents do mesmo nível não podem tomar decisões vinculantes fora do próprio domínio. Divergências escalam para um pai comum: creative-director para discussões de design, technical-director para as técnicas. Mudanças entre departamentos passam pelo producer. E nenhum agent edita arquivos fora do seu domínio sem delegação explícita.

A última regra é a que importa na prática. A maioria das falhas multi-agent não é falha de raciocínio, é falha de escopo: um agent encarregado de corrigir um bug de iluminação reescreve o sistema de save porque notou outra coisa. Escrever a fronteira do domínio e fazê-la valer por um líder que precisa delegar é um remédio grosseiro e real.

Os níveis de modelo são uma questão de orçamento

Cada agent declara um modelo no frontmatter. Os três diretores pedem Opus. lead-programmer e quinze especialistas indicam Sonnet. Os trinta restantes herdam o modelo que a sua sessão estiver rodando.

O README é incomumente direto nisso: trate os níveis como senioridade de papel, não como plano de cobrança, porque a maior parte do estúdio roda no modelo que você já tem. É a versão honesta da história de custo de um framework de agents. Na prática você paga uma sessão mais um punhado de chamadas a Opus nas decisões que determinam todo o resto, e é um lugar defensável para gastar.

O que os hooks realmente verificam

Quinze hooks rodam em eventos de sessão. Dois merecem ser citados.

`log-agent.sh` e `log-agent-stop.sh` escrevem uma trilha de auditoria quando um subagent começa e para. Isso é escrituração, e barata.

`validate-agent-artifact.sh` é o interessante. Ele dispara quando um agent para e avisa se aquele subagent nunca escreveu o arquivo nomeado no seu briefing. A checagem é pequena e mira uma falha específica que qualquer um que já rodou agents em paralelo conhece: o subagent reporta sucesso, o orquestrador segue em frente, e o arquivo não existe. Pegar isso no evento de stop é o lugar certo, porque é o último momento em que o pai ainda tem contexto para reenviar a tarefa.

Os outros hooks cobrem commits, pushes, mudanças de asset, leitura e escrita de documentos de design, registros e o ciclo de vida da sessão. Hooks degradam com elegância quando falta uma ferramenta opcional, com uma exceção deliberada: um commit que dá stage em JSON de dados é bloqueado se não houver Python, porque o validador não roda.

As armadilhas estão na lista de requisitos

A instalação são quatro linhas no README, e uma delas é um aviso.

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

Depois digite `/start`. O sistema pergunta em que ponto você está, de nenhuma ideia a projeto existente, e te encaminha para um workflow. Você também pode pular direto para `/setup-engine godot 4.7`, `/brainstorm` ou `/project-stage-detect`.

O aviso: inicie o Claude Code na pasta que contém `CLAUDE.md` e `project.yaml`. Se iniciar em `src/`, os hooks do projeto, as regras deny e o modo de permissão que pergunta antes de agir são todos ignorados. Você fica com um assistente sem estrutura nenhuma, e nada te avisa.

As dependências são Git, Claude Code (o instalador nativo é recomendado, embora `npm install -g @anthropic-ai/claude-code` funcione no Node 22+), Python 3 e Bash. Python 3 não é opcional do jeito que parece: todo skill e todo hook lê `project.yaml` através dele, e sem Python toda configuração volta em silêncio ao valor padrão. Um fallback silencioso é pior que um crash, porque o estúdio continua rodando com a configuração errada e ninguém percebe até uma regra deixar de disparar. jq é recomendado para validação de hooks.

O desenvolvimento principal é em Windows 10 com Git Bash, e os hooks também são testados no macOS com o bash 3.2 de fábrica e no Linux. O `notify.sh` usa PowerShell para notificações no Windows e não faz nada nas outras plataformas, então notificações de desktop por enquanto são só no Windows.

Nove especialistas de engine, e você só precisa de um

O template traz conjuntos de agents para Godot 4, Unity e Unreal Engine 5. Cada um tem um lead e subespecialistas: GDScript, shaders e GDExtension para Godot; DOTS/ECS, shaders e VFX, Addressables e UI Toolkit para Unity; GAS, Blueprints, replication e UMG/CommonUI para Unreal.

Manter os três num repositório só é uma proteção razoável, e também significa que o repositório carrega muito texto que você nunca vai carregar. A seção de customização do README diz para apagar os arquivos de agents que você não precisa, o que é o conselho certo e também uma tarefa que ninguém faz.

A parte que não é autonomia

O README afirma claramente que isto não é um piloto automático, e o protocolo de colaboração sustenta isso. Agents perguntam antes de propor. Apresentam de duas a quatro opções com os tradeoffs. O usuário decide. Mostram um rascunho antes de finalizar. Nada é escrito sem aprovação. Os modos `guided` e `autonomous` trocam parte dessas confirmações por velocidade, e o README aponta para o próprio documento de setup para os caminhos até o modo automático.

Há também um harness de teste para o próprio framework. `studio-tests/` cataloga os 74 skills e os 49 agents com rubricas por categoria e especificações de comportamento, e `/skill-test` roda um linter estático com sete checagens de conformidade, uma rubrica de categoria ou asserções de especificação. `/skill-improve` roda um ciclo de testar, corrigir e retestar, e reverte se a nota não subir. Testar o framework separado do jogo é a disciplina que torna editá-lo suportável.

Para que isso serve de verdade

O README faz a própria pergunta incômoda no título de uma seção: isso produz jogos ou documentos? Um template que entrega 62 templates de documento e um portão em cada milestone aposta que o desenvolvimento solo falha no processo, não no código. A aposta se sustenta. Os modos de falha de um projeto individual assistido por IA são um número mágico escrito à mão que ninguém anotou, um documento de design que descreve um jogo de três revisões atrás, e um build que sai com tutorial quebrado porque ninguém rodou o smoke check.

Quarenta e nove agents não consertam isso. Uma regra limitada a um caminho que dispara quando código de gameplay é editado, um `/smoke-check` que precisa rodar antes de um build, e um hook que bloqueia um commit quando o validador não roda têm mais chance. O interessante aqui é que alguém escreveu o organograma, incluindo as partes em que um especialista precisa escalar e esperar.

Artigos relacionados