고도젠: 완전한 고도트 게임 생성을 위한 클로드 코드 스킬

Godogen은 텍스트 프롬프트를 입력받아 완전히 플레이 가능한 Godot 4 프로젝트를 생성하는 파이프라인입니다. Claude Code 기술을 사용하여 아키텍처를 설계하고, 2D/3D 에셋을 생성하며, GDScript를 작성하고, 시각적으로 테스트합니다.

엔지니어링 솔루션

개발자는 세 가지 특정 병목 현상을 해결했습니다:

• 학습 데이터 부족: LLM은 GDScript 학습이 거의 없습니다. Godogen에는 직접 작성한 언어 사양, Godot의 XML 소스에서 변환된 전체 API 문서, 문서화되지 않은 엔진 동작을 위한 특이점 데이터베이스가 포함된 맞춤형 참조 시스템이 포함되어 있습니다. 에이전트는 Godot의 약 850개 클래스로 인한 컨텍스트 창 오버플로를 피하기 위해 런타임에 필요한 API만 지연 로드합니다.
• 빌드 타임 대 런타임 상태: 씬은 메모리에서 노드 그래프를 구축하고 .tscn 파일로 직렬화하는 헤드리스 스크립트로 생성되어, Godot의 직렬화 형식을 수동으로 편집하는 취약성을 피합니다. 모델은 각 단계에서 사용 가능한 API와 모든 노드가 올바르게 소유자를 설정해야 한다는 것을 학습합니다.
• 평가 루프: 별도의 Gemini Flash 에이전트가 시각적 QA 역할을 하여 실행 중인 엔진에서 렌더링된 스크린샷을 분석하여 z-파이팅, 떠다니는 객체, 물리 폭발, 유기적이어야 하는 격자형 배치와 같은 시각적 버그를 포착합니다.

아키텍처 및 설정

시스템은 두 개의 Claude Code 기술로 실행됩니다: 파이프라인을 계획하는 오케스트레이터와, 실수와 상태 누적을 방지하기 위해 context: fork 창에서 각 부분을 구현하는 작업 실행자입니다.

필수 조건:

• PATH에 Godot 4(헤드리스 또는 에디터) 설치
• Claude Code 설치
• 환경 변수로 API 키 설정: GOOGLE_API_KEY (Gemini용 - 이미지 생성 및 시각적 QA), TRIPO3D_API_KEY (Tripo3D용 - 이미지-3D 모델 변환, 3D 게임 전용)
• pip가 설치된 Python 3

시작하기:

./publish.sh ~/my-game를 실행하여 모든 기술이 설치된 새 프로젝트 폴더를 생성합니다. 이 명령은 .claude/skills/와 CLAUDE.md가 포함된 대상 디렉토리를 생성한 후 git 저장소를 초기화합니다. 해당 폴더에서 Claude Code를 열고 만들 게임을 설명하세요 — /godogen 기술이 모든 것을 처리합니다.

성능 참고사항:

• 단일 생성 실행에는 몇 시간이 걸릴 수 있습니다
• Godot의 스크린샷 캡처에는 T4 또는 L4 GPU가 있는 클라우드 VM에서 실행하는 것이 효과적입니다
• Opus 4.6가 포함된 Claude Code가 최상의 결과를 제공합니다; Sonnet 4.6도 작동하지만 더 많은 사용자 지침이 필요합니다
• OpenCode는 실행 가능한 대안이며 기술 이식은 간단합니다

에셋 생성: Gemini는 2D 아트와 텍스처를 생성합니다; Tripo3D는 선택된 이미지를 3D 모델로 변환합니다. 시스템은 예산을 고려하여, 지출된 비용당 시각적 영향을 극대화합니다.

테스트 환경: Ubuntu 및 Debian. macOS는 테스트되지 않았습니다 — 스크린샷 캡처는 X11/xvfb/Vulkan에 의존하며 네이티브 캡처 경로가 필요합니다.