Godogen : Compétences de Code Claude pour la Génération Complète de Jeux Godot

Godogen est un pipeline qui prend un prompt textuel et génère des projets Godot 4 complets et jouables. Il utilise les compétences de Claude Code pour concevoir l'architecture, générer des actifs 2D/3D, écrire du GDScript et effectuer des tests visuels.

Solutions d'Ingénierie

Le développeur a résolu trois goulots d'étranglement spécifiques :

• Pénurie de Données d'Entraînement : Les LLM ont un entraînement minimal en GDScript. Godogen inclut un système de référence personnalisé avec une spécification du langage écrite à la main, une documentation complète de l'API convertie à partir de la source XML de Godot, et une base de données des particularités pour les comportements non documentés du moteur. L'agent charge à la volée uniquement les API nécessaires au moment de l'exécution pour éviter le débordement de la fenêtre de contexte dû aux ~850 classes de Godot.
• État entre Temps de Compilation et Temps d'Exécution : Les scènes sont générées par des scripts sans interface qui construisent des graphes de nœuds en mémoire et les sérialisent en fichiers .tscn, évitant ainsi la fragilité de l'édition manuelle du format de sérialisation de Godot. Le modèle apprend quelles API sont disponibles à chaque phase et que chaque nœud doit avoir son propriétaire correctement défini.
• Boucle d'Évaluation : Un agent Gemini Flash séparé agit comme QA visuel, analysant les captures d'écran rendues par le moteur en cours d'exécution pour détecter des bugs visuels comme le z-fighting, les objets flottants, les explosions physiques et les placements en grille qui devraient être organiques.

Architecture et Configuration

Le système fonctionne avec deux compétences Claude Code : un orchestrateur qui planifie le pipeline, et un exécuteur de tâches qui implémente chaque élément dans une fenêtre context: fork pour éviter les erreurs et l'accumulation d'état.

Prérequis :

• Godot 4 (sans interface ou éditeur) dans le PATH
• Claude Code installé
• Clés API comme variables d'environnement : GOOGLE_API_KEY pour Gemini (génération d'images et QA visuel), TRIPO3D_API_KEY pour Tripo3D (conversion d'image en modèle 3D, uniquement pour les jeux 3D)
• Python 3 avec pip

Pour Commencer :

Exécutez ./publish.sh ~/mon-jeu pour créer un nouveau dossier de projet avec toutes les compétences installées. Cela crée le répertoire cible avec .claude/skills/ et un CLAUDE.md, puis initialise un dépôt git. Ouvrez Claude Code dans ce dossier et décrivez le jeu à créer — la compétence /godogen gère tout.

Notes sur les Performances :

• Une seule génération peut prendre plusieurs heures
• L'exécution sur une VM cloud avec un GPU T4 ou L4 fonctionne bien pour la capture d'écran de Godot
• Claude Code avec Opus 4.6 donne les meilleurs résultats ; Sonnet 4.6 fonctionne mais nécessite plus de guidage de l'utilisateur
• OpenCode est une alternative viable et le portage des compétences est simple

Génération d'Actifs : Gemini crée l'art 2D et les textures ; Tripo3D convertit les images sélectionnées en modèles 3D. Le système est conscient du budget, maximisant l'impact visuel par centime dépensé.

Environnement Testé : Ubuntu et Debian. macOS n'est pas testé — la capture d'écran dépend de X11/xvfb/Vulkan et nécessite un chemin de capture natif.