Godogen: Habilidades de Código Claude para la Generación Completa de Juegos Godot

Godogen es una canalización que toma una indicación de texto y genera proyectos completos y jugables de Godot 4. Utiliza las habilidades de Claude Code para diseñar la arquitectura, generar activos 2D/3D, escribir GDScript y realizar pruebas visuales.

Soluciones de Ingeniería

El desarrollador resolvió tres cuellos de botella específicos:

• Escasez de Datos de Entrenamiento: Los LLM tienen un entrenamiento mínimo en GDScript. Godogen incluye un sistema de referencia personalizado con una especificación del lenguaje escrita a mano, documentación completa de la API convertida desde el código fuente XML de Godot y una base de datos de peculiaridades para comportamientos no documentados del motor. El agente carga de forma diferida solo las API necesarias en tiempo de ejecución para evitar el desbordamiento de la ventana de contexto debido a las ~850 clases de Godot.
• Estado en Tiempo de Compilación vs. Tiempo de Ejecución: Las escenas son generadas por scripts sin interfaz gráfica que construyen gráficos de nodos en memoria y los serializan en archivos .tscn, evitando la fragilidad de la edición manual del formato de serialización de Godot. Se le enseña al modelo qué API están disponibles en cada fase y que cada nodo necesita que su propietario esté configurado correctamente.
• Ciclo de Evaluación: Un agente separado de Gemini Flash actúa como control de calidad visual, analizando capturas de pantalla renderizadas del motor en ejecución para detectar errores visuales como z-fighting, objetos flotantes, explosiones de física y colocaciones en forma de cuadrícula que deberían ser orgánicas.

Arquitectura y Configuración

El sistema se ejecuta como dos habilidades de Claude Code: un orquestador que planifica la canalización y un ejecutor de tareas que implementa cada parte en una ventana context: fork para evitar errores y la acumulación de estado.

Prerrequisitos:

• Godot 4 (sin interfaz gráfica o editor) en PATH
• Claude Code instalado
• Claves API como variables de entorno: GOOGLE_API_KEY para Gemini (generación de imágenes y control de calidad visual), TRIPO3D_API_KEY para Tripo3D (conversión de imagen a modelo 3D, solo para juegos 3D)
• Python 3 con pip

Comenzar:

Ejecuta ./publish.sh ~/mi-juego para crear una nueva carpeta de proyecto con todas las habilidades instaladas. Esto crea el directorio de destino con .claude/skills/ y un CLAUDE.md, luego inicializa un repositorio git. Abre Claude Code en esa carpeta y describe qué juego quieres hacer: la habilidad /godogen maneja todo.

Notas de Rendimiento:

• Una sola ejecución de generación puede tomar varias horas
• Ejecutar en una VM en la nube con una GPU T4 o L4 funciona bien para la captura de pantallas de Godot
• Claude Code con Opus 4.6 ofrece el mejor resultado; Sonnet 4.6 funciona pero requiere más orientación del usuario
• OpenCode es una alternativa viable y portar las habilidades es sencillo

Generación de Activos: Gemini crea arte y texturas 2D; Tripo3D convierte imágenes seleccionadas en modelos 3D. El sistema es consciente del presupuesto, maximizando el impacto visual por centavo gastado.

Entorno Probado: Ubuntu y Debian. macOS no está probado: la captura de pantallas depende de X11/xvfb/Vulkan y necesita una ruta de captura nativa.