Godogen
htdt/godogenAI-пайплайн для Claude Code и Codex: проектирует архитектуру, генерирует арт, пишет код на C#, делает скриншоты из движка и исправляет визуальные ошибки. Результат — готовый Godot 4 проект.
Установка
git clone https://github.com/htdt/godogen.gitREADME
Godogen: скиллы Claude Code и Codex для генерации полноценных Godot-проектов
Вы описываете, что хотите. AI-пайплайн проектирует архитектуру, генерирует арт, пишет каждую строку кода, делает скриншоты из работающего движка и исправляет то, что выглядит неправильно. На выходе — настоящий Godot 4 проект с организованными сценами, читаемыми скриптами и правильной игровой архитектурой.
Этот репозиторий — не игра на Godot. Это исходники генератора, который создаёт игры на Godot: godogen → репозиторий игры → игра. Вы публикуете скиллы в новый репозиторий игры (в варианте для Claude Code или Codex), после чего агент работает внутри этого репозитория и собирает саму игру.
В репозитории два параллельных дерева исходников — по одному на каждого хост-агента:
claude/— версия для Claude Codecodex/— версия для Codex
Что умеют скиллы
- Вывод в Godot 4 — настоящие проекты с правильными деревьями сцен, скриптами и организацией ассетов.
- Генерация ассетов — Gemini создаёт точные референсы и персонажей; xAI Grok отвечает за текстуры и простые объекты; Tripo3D конвертирует изображения в 3D-модели. Анимированные спрайты используют генерацию видео через Grok с определением петли.
- C# / .NET 9 — весь генерируемый код написан на C#. Подробнее: почему C#, а не GDScript.
- Визуальный QA замыкает цикл — делает реальные скриншоты из работающей игры и использует мультимодальный анализ для выявления z-fighting, отсутствующих текстур, сломанной физики и других визуальных регрессий.
- Работает на обычном железе — любая машина с Godot, Python и нужными API-ключами может запустить пайплайн.
Начало работы
Требования
- Godot 4 (сборка с .NET) в
PATH - Python 3 с pip
- API-ключи в переменных окружения:
GOOGLE_API_KEY— Google AI StudioXAI_API_KEY— xAI GrokTRIPO3D_API_KEY— Tripo3D для 3D-генерации
- Системные пакеты из setup.md:
vulkan-tools,xvfb,ffmpeg,imagemagick, а также платформо-зависимые дополнения - Протестировано на Ubuntu, Debian и macOS
- Claude Code или Codex
Публикация репозитория игры
Выберите вариант, соответствующий вашему хост-агенту:
./claude/publish.sh ~/my-game # записывает CLAUDE.md и .claude/skills/
./codex/publish.sh ~/my-game # записывает AGENTS.md и .agents/skills/Передайте --force, чтобы очистить существующее содержимое целевой директории перед публикацией — используйте это при повторной публикации поверх предыдущего запуска.
Запуск на сервере
Полный цикл генерации может занять несколько часов, поэтому удобно вынести его на сервер — желательно на GPU-инстанс, поскольку Godot рендерит скриншоты и видео значительно быстрее с аппаратным ускорением.
- Сохраняйте сессию при обрывах SSH с помощью
tmuxилиscreen. - Установите tg-push, чтобы агент мог отправлять обновления прогресса, скриншоты и итоговое видео в Telegram, пока вас нет рядом.
- Включите удалённое управление, чтобы проверять ход выполнения и корректировать запуск с любого устройства — и Claude Code, и Codex имеют официальные интерфейсы удалённого управления.
Улучшение скиллов
После завершения полной сессии генерации попросите использованного агента проанализировать работу пайплайна:
Analyze this session. Were the instructions optimal? Flag anything that was too obvious, missing, or misleading. Did any tools pollute context with noise? Did the screenshot verification loop catch the real problems? Any tool failures or workarounds?
Дорожная карта
- Опубликовать полную игру от начала до конца в качестве публичного демо
- Изучить Bevy Engine как альтернативу Godot
История изменений
2026-04-14 — Поддержка Codex
- Добавлено параллельное дерево исходников для Codex рядом с существующим для Claude Code
- Каждый вариант публикуется в собственную структуру директорий (
.claude/skills/и.agents/skills/)
2026-04-06 — Миграция на C#
- Все скиллы и генерируемый код переведены с GDScript на C# / .NET 9 (сравнение)
dotnet buildзаменяет циклы валидации отдельных файлов
2026-04-03 — Архитектура единого контекста
- Оркестратор и выполнение задач объединены в один основной пайплайн
- Добавлены потоки поиска по Godot API и визуального QA
2026-03-25 — xAI Grok видео
- Добавлена генерация видео через Grok для рабочих процессов с анимированными спрайтами
- Удаление фона переписано с использованием матирования BiRefNet с несколькими сигналами
2026-03-09 — Первый релиз
- Первый релиз Godogen с генерацией изображений, 3D-конвертацией, скриншот-QA и захватом видео
Следите за прогрессом: @alex_erm
