← Voltar ao blog
Aicerca de 8 min de leitura

49 agentes, um jogo

Publicado 9 de nov. de 2026
49 agentes, um jogo

Claude Code Game Studios é um template do GitHub que transforma uma sessão do Claude Code num estúdio de jogos de 49 pessoas. 36.824 estrelas, licença MIT, 49 agentes, 74 skills de comando com barra, 15 hooks, 14 regras por caminho, 62 templates de documento.

Esse parágrafo é a versão que circula. A versão que vale ler está quatro linhas abaixo no README, numa seção chamada «Isso produz jogos ou documentos?».

O autor construiu quatro jogos a partir de um mesmo briefing, com configurações de processo diferentes, e contou quantos documentos cada um escreveu antes da primeira linha de código do jogo.

Em minimal, o número era um — o briefing de uma página — e o tempo era zero minuto. Em standard, eram trinta documentos e cinquenta e oito minutos. As quatro builds produziram um jogo que roda e tem teste.

Aí dois avaliadores cegos e um teste de jogo com humano colocaram a build standard em último.

Trinta documentos extras compraram rastreabilidade. Não compraram um jogo melhor. Publicar esse resultado no próprio README, num projeto cuja proposta de valor inteira é processo, é um nível de honestidade que eu não esperava, e é o motivo deste texto existir.

O que tem de fato na caixa

A estrutura é um organograma de estúdio de verdade, e essa é a decisão de design de que tudo o mais decorre.

O primeiro nível são diretores: um diretor criativo, um diretor técnico, um produtor. O segundo nível são líderes de departamento — design de jogo, programação, arte, áudio, narrativa, QA, lançamento, localização. O terceiro nível são uns vinte especialistas: programador de gameplay, programador de engine, programador de IA, programador de rede, programador de ferramentas, programador de UI, designer de sistemas, designer de níveis, designer de economia, artista técnico, sound designer, roteirista, construtor de mundo, designer de UX, prototipador, analista de performance, engenheiro de devops, engenheiro de analytics, engenheiro de segurança, testador de QA, especialista em acessibilidade, designer de live ops.

Cada um tem responsabilidade definida, caminho de escalação e portões de qualidade. A formulação do próprio README é que você continua tomando todas as decisões, mas agora alguém te faz as perguntas que um estúdio faria — isso cabe na visão, esse número é uma constante mágica, onde está o documento de design deste sistema.

As skills são o fluxo de trabalho: /start, /brainstorm, /setup-engine godot 4.7, /project-stage-detect, /design-system, /create-epics, /create-stories, /dev-story, /story-done. Os hooks são validações que disparam em commits, pushes, mudanças de asset, leitura de documento de design e ciclo de vida da sessão. As regras são padrões de código por caminho, que valem quando você edita código de gameplay versus código de rede versus arquivos de cena.

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

Instalar leva mais ou menos um minuto

Pré-requisitos: Git, Claude Code, Python 3, Bash e jq se você quiser a validação por hook. No Windows, o Bash vem com o Git for Windows.

Depois:

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

Comece a sessão na pasta que contém CLAUDE.md e project.yaml. Começar dentro de src/ pula os hooks do projeto, as regras de negação e o modo de permissão que pergunta antes, o que desliga silenciosamente a maior parte do sistema.

Depois rode /start. Ele pergunta onde você está — nenhuma ideia, conceito vago, design claro, trabalho existente — e te encaminha. Se você já sabe o que quer, pule direto para /brainstorm ou /setup-engine godot 4.7.

A única decisão de configuração que importa é modes.rigor: minimal, standard ou full. É um interruptor único na frente de seis botões separados — quais seções do GDD são obrigatórias, densidade dos documentos, nível de QA, granularidade das histórias e modo de revisão. O /start escreve isso para você.

A parte que eu acho genuinamente bem desenhada

Dois mecanismos se destacam.

O Python é estrutural, e o README admite. Toda skill e todo hook leem project.yaml por meio de Python. Se o Python falta, toda configuração cai em silêncio para o padrão. Os hooks falham de forma controlada, você perde a validação, nada quebra. Existe exatamente uma parada dura: um commit que coloca JSON de dados em stage é bloqueado se não houver Python para validar. É um detalhe estranho, específico e crível. É com isso que um sistema se parece depois de um ano de uso real.

Uma mudança visual não está pronta até alguém ter olhado para ela. Qualquer história que mude algo que o jogador vê não pode ser fechada até o jogo ter sido aberto, observado e um screenshot salvo em production/qa/evidence/. Um teste passando não é uma execução. Uma checagem de parse não é uma execução. Isso vale em todos os níveis de rigor, inclusive minimal, onde os testes automatizados são dispensados mas o olhar não.

Essa regra sozinha faz mais pela qualidade do resultado do que quarenta documentos. Jogo falha visualmente de formas que teste não vê: um menu desenhado fora da tela, um sprite com pivot errado, uma câmera que atravessa o chão na segunda curva. Exigir um screenshot é a proteção mais barata possível contra a classe de falha mais comum, e é imposta por hook, não por esperança.

Para que servem os 62 templates

Documentos de design de jogo, especificações de UX, registros de decisão de arquitetura, planos de sprint, design de HUD, revisões de acessibilidade. Sozinhos, são a papelada que ninguém quer escrever. Dentro de um sistema como este, são o que os agentes leem antes de agir.

Essa é a função real. Um documento aqui não é entregável; é o contexto que impede um agente especialista de inventar uma constante mágica porque não sabia a curva de dano do sistema de combate. Quando o agente de direção de arte precisa saber se o jogo é estilizado ou fotorrealista, ele lê o template de bíblia de arte que alguém preencheu. Sem esse arquivo, ele chuta.

O que reenquadra a medição anterior. Trinta documentos antes da primeira linha de código não são trinta documentos de valor. É uma aposta de que os documentos serão lidos — pelos agentes, em tarefas futuras, repetidamente. Quando a aposta dá certo, você ganha consistência. Quando não dá, você ganha cinquenta e oito minutos de escrita e uma build em último lugar num painel cego.

Minha leitura é que o retorno depende inteiramente de o projeto durar mais de uma semana. Num fim de semana, escreva uma página. Em três meses, escreva os trinta.

O caminho de atualização que ninguém menciona

Clonar um template é fácil. Trazer mudanças do upstream para um repositório que você vem customizando por dois meses é a parte que dói. Agentes são editados, regras são ajustadas para a sua engine, e a versão seguinte reorganiza um diretório.

O README tem uma seção de atualização, o que já é mais do que a maioria dos templates oferece, e o conselho que importa é manter suas próprias mudanças num número pequeno de lugares previsíveis, os arquivos de regras e o project.yaml — para que o resto possa ser substituído inteiro. Se você fizer fork dos agentes em si, não vai conseguir pegar atualizações, e o projeto anda rápido o suficiente para isso importar em uma ou duas versões.

Para onde esse padrão vai

Tire o vocabulário específico de jogo e o que sobra é uma receita geral: defina papéis, dê a cada papel um mandato estreito, coloque portões entre as fases e deixe um agente diretor segurar a visão enquanto especialistas executam. É a mesma forma de uma organização de engenharia real, e é a mesma forma que várias equipes estão construindo para outros domínios — uma equipe de cinema, um departamento de marketing, um laboratório de pesquisa.

A ressalva honesta é a que o autor já publicou. Mais processo não se correlaciona com melhor resultado, pelo menos nesta escala, com um briefing e quatro builds. O que se correlaciona é conseguir explicar por que uma decisão foi tomada três semanas depois. Isso vale algo para uma equipe e quase nada para uma jam solo.

Vale usar

Se você está fazendo um jogo sozinho e a falha que você repete é «tenho trinta sistemas e nenhuma visão coerente», comece em standard e veja se as perguntas ajudam. Se a falha que você repete é «passo o tempo todo escrevendo documento», comece em minimal — e note que mesmo essa configuração ainda faz o agente olhar para a tela antes de declarar uma história concluída.

O template não faz um jogo para você. Ele faz uma sessão se comportar como uma sala cheia de gente que já lançou coisa. Se isso vale cinquenta e oito minutos é uma pergunta que você agora pode responder com medição em vez de intuição, o que é mais do que a maioria das ferramentas de IA oferece.

Artigos relacionados