godogen
무엇인가
godogen은 게임 개발 작업을 에이전트가 처음부터 끝까지 수행하도록 절차와 지식을 주입하는 스킬 팩이다. 규율하는 영역은 Godot 4, Bevy, Babylon.js 세 엔진의 프로젝트 스캐폴딩, 씬 생성, 에셋 생성, 엔진 실행, 결과 캡처, 그리고 그 결과에 근거한 반복 수정이다. 저장소 자체는 게임이 아니라 게임을 만들어 내는 생성기의 소스이며, godogen -> game repo -> game 순서로 산출물이 만들어진다.
어떻게 동작하나
발행된 게임 저장소는 의도적으로 얇다. 런타임 매니페스트 prompts/runtime.md, 엔진별 한 페이지 가이드 engines/godot.md·engines/bevy.md·engines/babylon.md, 크로스 엔진 에셋 생성 스킬 asset-gen/로 구성된다. publish.sh가 선택한 엔진과 호스트 에이전트에 맞춰 런타임 레이아웃을 렌더링하며, Claude 대상이면 CLAUDE.md와 .claude/skills/를, Codex 대상이면 AGENTS.md와 .agents/skills/를 생성한다. 프로젝트 스캐폴드와 캡처 도구는 별도로 배포되지 않고 가이드로부터 에이전트가 재생성한다.
무엇과 다른가
프롬프트를 매번 직접 작성하거나 단일 규칙 파일을 고정해 두는 방식과 달리, 엔진과 호스트 에이전트를 발행 시점의 렌더 선택으로 분리한다. 소스 트리를 엔진별로 나누지 않고 하나의 소스에서 조합을 렌더링하므로 규칙 본문은 공통으로 유지되고 엔진별 차이는 가이드 파일 하나로 좁혀진다. 또한 컴파일 성공이 아니라 실행 중인 게임의 라이브 URL이나 녹화 클립을 판정 근거로 삼도록 규율해, 눈에 보이는 결함이 다음 반복을 이끌게 한다.
어떻게 쓰나
publish.sh로 대상 디렉터리에 게임 저장소를 발행한다. 예를 들어 ./publish.sh --engine godot --agent claude --out ~/my-game 형태로 엔진과 호스트 에이전트를 지정하고, --force를 붙이면 기존 내용을 지우고 다시 발행한다. 발행된 저장소 안에서 에이전트를 실행하고 만들 게임을 서술하면 에이전트가 엔진 가이드를 읽고 스캐폴드와 캡처 도구를 재생성한 뒤 빌드를 진행한다. 작업을 어떻게 서술했는지에 따라 라이브 게임을 지켜보며 결정 지점에서 개입하거나, 무인 실행 후 15~20초 증거 녹화를 받는 방식이 선택된다.
전제와 한계
Godot 프로젝트에는 PATH에 Godot 4 .NET 빌드, Bevy에는 Rust/Cargo, Babylon.js에는 Node.js 22.12+와 npm, 브라우저 캡처에는 하드웨어 WebGL2를 지원하는 Chrome 또는 Chromium이 필요하다. Python 3와 pip, vulkan-tools·xvfb·ffmpeg·imagemagick 같은 시스템 패키지가 선행되며 GOOGLE_API_KEY, XAI_API_KEY, TRIPO3D_API_KEY 환경 변수를 설정해야 한다. Ubuntu, Debian, macOS에서 테스트되었고 Claude Code 또는 Codex에서 동작한다. 전체 생성 실행은 수 시간이 걸릴 수 있어 tmux나 screen 같은 세션 유지 수단과 원격 제어 인터페이스가 권장된다.