GodotPrompter
무엇인가
GodotPrompter는 Godot 4.x 게임 개발에 필요한 도메인 지식을 AI 코딩 에이전트에 주입하는 스킬 묶음이다. 프로젝트 구조 설계, 아키텍처, 게임플레이 시스템, 입력 처리, 물리, 2D/3D, 애니메이션, 셰이더, 오디오, UI, 멀티플레이, 로컬라이제이션, 절차적 생성, XR/VR, 네이티브 확장, 멀티스레딩, 모바일 배포, 최적화, GDScript/C# 패턴, 서드파티 애드온(LimboAI·Beehave·Popochiu·Dialogue Manager·Phantom Camera)까지 영역별로 규율한다. 대상 엔진 버전은 Godot 4.3+이며 GDScript와 C# 예제를 함께 제공하고, 4.5~4.7의 신규 기능은 주석이 달린 추가 절로 분리해 표기한다.
어떻게 동작하나
동작은 온디맨드 로딩이다. 각 스킬은 `SKILL.md` 파일로 존재하고, `SKILL.md`당 16KB 토큰 예산이 검증기로 강제된다. Claude Code에서는 SessionStart 훅이 작업 디렉터리 기준 상위 4단계·하위 3단계까지 `project.godot`을 탐색해 Godot 프로젝트를 감지하면 스킬 라우팅 카드를 세션에 주입한다. 벤더링된 `addons/`와 점(.) 디렉터리는 건너뛰므로 플러그인에 딸린 데모 프로젝트를 사용자 프로젝트로 오인하지 않는다. 훅이 없는 Codex·Antigravity는 `AGENTS.md`/`GEMINI.md` 부트스트랩으로 같은 스킬을 읽는다. "teach me as we go"라고 말하면 개념·에디터 설정·주석 달린 GDScript/C#·실행 후 확인 항목·다음 단계를 제시하는 멘토 모드로 전환되고, 이 설정은 프로젝트별로 `~/.godot-prompter/state/`에 저장되어 게임 저장소에는 아무것도 쓰지 않는다.
무엇과 다른가
프롬프트를 매번 직접 쓰거나 정적 `CLAUDE.md`에 규칙을 몰아넣는 방식과 다르다. 규칙이 단일 파일에 상주하지 않고 작업 종류에 따라 해당 스킬만 로드되며, 각 스킬은 Godot 버전별 API와 관례를 검증된 형태로 담는다. Claude Code용 Superpowers 플러그인 위에 얹혀 스킬 로딩·브레인스토밍·워크플로 인프라를 그대로 쓰고 Godot 도메인 지식만 확장한다. 서브에이전트에는 SessionStart 훅이 발화하지 않으므로, 저장소에 `## GodotPrompter` 절이 있는 지침 파일(`CLAUDE.md`, `AGENTS.md`, `GEMINI.md`, `.github/copilot-instructions.md`, `.claude/rules/`, `.cursor/rules/`)이 하나도 없으면 에이전트가 한 번만 추가를 제안하고 거절은 상태 파일에 기록된다.
어떻게 쓰나
Claude Code에서는 마켓플레이스를 등록한 뒤 플러그인을 설치한다. 로컬 클론을 쓰려면 저장소를 클론해 `claude plugins marketplace add ./GodotPrompter` 후 `claude plugins install godot-prompter@godot-prompter`를 실행한다. Grok Build는 `grok plugin install jame581/GodotPrompter --trust`, Antigravity CLI는 `agy plugin install https://github.com/jame581/GodotPrompter`, GitHub Copilot CLI는 `copilot plugin marketplace add jame581/skillsmith` 후 `copilot plugin install godot-prompter@skillsmith`, Cursor는 `/add-plugin godot-prompter`, Codex는 `~/.codex/godot-prompter`로 클론한 뒤 `~/.agents/skills/godot-prompter` 심볼릭 링크를 만든다. 설치 후 새 세션에서 "I'm starting a new Godot 4.3 project. How should you organize it?"처럼 물으면 `godot-project-setup` 스킬이 로드된다.
전제와 한계
훅 기반 자동 활성화는 Claude Code와 GitHub Copilot CLI에서 종단 검증되었고, Cursor는 등록만 되어 있으며 확인되지 않았다. Codex와 Antigravity는 훅 메커니즘이 없어 `AGENTS.md`/`GEMINI.md` 경유로만 부트스트랩한다. 훅은 프로젝트의 `project.godot`과 홈 디렉터리 아래 자체 상태 파일만 읽고 네트워크 요청이나 쓰기를 하지 않으며, Windows에서 bash를 쓸 수 없으면 조용히 종료된다. 서브에이전트는 훅을 받지 못하고, Godot 프로젝트가 아닌 저장소에서는 훅이 아무 동작도 하지 않는다.