Godogen: Habilidades de Código Claude para Geração Completa de Jogos Godot

Godogen é um pipeline que recebe um prompt de texto e gera projetos completos e jogáveis do Godot 4. Ele usa as habilidades do Claude Code para projetar a arquitetura, gerar assets 2D/3D, escrever GDScript e testar visualmente.

Soluções de Engenharia

O desenvolvedor resolveu três gargalos específicos:

• Escassez de Dados de Treinamento: LLMs têm treinamento mínimo em GDScript. O Godogen inclui um sistema de referência personalizado com uma especificação da linguagem escrita à mão, documentação completa da API convertida da fonte XML do Godot e um banco de dados de peculiaridades para comportamentos não documentados do motor. O agente carrega sob demanda apenas as APIs necessárias em tempo de execução para evitar o estouro da janela de contexto das ~850 classes do Godot.
• Estado em Tempo de Compilação vs Tempo de Execução: As cenas são geradas por scripts headless que constroem grafos de nós na memória e serializam para arquivos .tscn, evitando a fragilidade da edição manual do formato de serialização do Godot. O modelo é ensinado sobre quais APIs estão disponíveis em cada fase e que cada nó precisa ter seu proprietário configurado corretamente.
• Loop de Avaliação: Um agente separado do Gemini Flash atua como QA visual, analisando capturas de tela renderizadas do motor em execução para detectar bugs visuais como z-fighting, objetos flutuantes, explosões de física e posicionamentos em grade que deveriam ser orgânicos.

Arquitetura e Configuração

O sistema é executado como duas habilidades do Claude Code: um orquestrador que planeja o pipeline e um executor de tarefas que implementa cada parte em uma janela context: fork para evitar erros e acúmulo de estado.

Pré-requisitos:

• Godot 4 (headless ou editor) no PATH
• Claude Code instalado
• Chaves de API como variáveis de ambiente: GOOGLE_API_KEY para o Gemini (geração de imagem e QA visual), TRIPO3D_API_KEY para o Tripo3D (conversão de imagem para modelo 3D, apenas para jogos 3D)
• Python 3 com pip

Começando:

Execute ./publish.sh ~/meu-jogo para criar uma nova pasta de projeto com todas as habilidades instaladas. Isso cria o diretório de destino com .claude/skills/ e um CLAUDE.md, e então inicializa um repositório git. Abra o Claude Code nessa pasta e descreva qual jogo fazer — a habilidade /godogen cuida de tudo.

Notas de Desempenho:

• Uma única execução de geração pode levar várias horas
• Executar em uma VM na nuvem com uma GPU T4 ou L4 funciona bem para a captura de tela do Godot
• Claude Code com Opus 4.6 fornece o melhor resultado; Sonnet 4.6 funciona, mas requer mais orientação do usuário
• OpenCode é uma alternativa viável e portar as habilidades é direto

Geração de Assets: O Gemini cria arte 2D e texturas; o Tripo3D converte imagens selecionadas em modelos 3D. O sistema é consciente do orçamento, maximizando o impacto visual por centavo gasto.

Ambiente Testado: Ubuntu e Debian. macOS não foi testado — a captura de tela depende de X11/xvfb/Vulkan e precisa de um caminho de captura nativo.