Codex Game Studio

Codex 세션을 구조화된 로컬 우선 게임 스튜디오로 바꿉니다.

🇺🇸 English | 🇨🇳 简体中文 | 🇯🇵 日本語 | 🇰🇷 한국어

Codex Game Studio는 TypeScript CLI입니다. 게임 프로젝트를 위해 Codex가 바로 사용할 수 있는 워크스페이스를 만들고, 역할 프롬프트, 워크플로 프롬프트, 프로젝트 파일, 작업 상태, 검증 정보를 Git에서 리뷰 가능한 일반 파일로 저장합니다.

이 도구는 게임 엔진도, 호스팅 프로젝트 관리자도 아닙니다. Codex에 더 명확한 작업 계약을 제공하면서 창작 결정과 최종 리뷰는 사람에게 남겨 둡니다.

빠른 시작

Node.js 24 이상이 필요합니다. run <role>에는 Codex CLI가 필요합니다.

git clone git@github.com:merlinhu1/codex-game-studio.git
cd codex-game-studio
npm install
npm run build

./codex-game-studio init --name "Signal Cartographer" --engine godot --mode prototype --non-interactive \
  --concept "A compact puzzle game about routing trains through haunted switchyards"

./codex-game-studio status --project projects/signal-cartographer
./codex-game-studio validate --project projects/signal-cartographer

Codex를 실행하기 전에 역할 프롬프트를 확인할 수 있습니다.

./codex-game-studio run producer --project projects/signal-cartographer \
  "Create the initial market overview." --print-prompt

자세한 명령 설명은 영어 User Guide를 참고하세요.

왜 필요한가

빈 AI 코딩 채팅은 유연하지만, 게임 개발에는 반복 가능한 스튜디오 구조가 필요합니다.

프로듀서는 마일스톤, 핸드오프, 출시 체크가 필요합니다.
디자이너는 GDD, 시스템 명세, 플레이어 여정, 튜닝 루프가 필요합니다.
엔지니어는 경계가 명확한 구현 프롬프트와 검증 게이트가 필요합니다.
아트, QA, 오디오, 로컬라이제이션, 라이브 운영은 각자의 맥락이 필요합니다.
리뷰어는 채팅 기록이 아니라 Git에서 확인할 수 있는 파일이 필요합니다.

Codex Game Studio는 이 구조를 Codex가 읽고 사람이 리뷰할 수 있는 로컬 프로젝트 산출물로 바꿉니다.

제공하는 것

기능	의미
로컬 프로젝트 스캐폴딩	현재 저장소 루트에 결정적인 게임 워크스페이스를 만듭니다。
Codex 네이티브 스튜디오 역할	제작, 디자인, 엔지니어링, 아트, QA, 로컬라이제이션, 출시 작업용 역할 프롬프트를 생성합니다.
워크플로 프롬프트	시장 리뷰, 분석, 명세, 핸드오프, 출시 체크, UI 리뷰 등 재사용 가능한 프롬프트를 제공합니다.
엔진 오버레이	Godot, Unity, Unreal 맥락을 추가하지만 엔진 래퍼가 되지는 않습니다.
파일 기반 작업 상태	`.codex/**` 아래에 작업, 잠금, 실행 메타데이터를 저장합니다.
실행 전 검사	dry-run과 프롬프트 출력으로 Codex 실행 전 내용을 확인할 수 있습니다.
엄격한 검증	오래된 생성 파일, 잘못된 메타데이터, 누락 자산, 미래 기능 표면을 감지합니다.

더 읽기

필요	문서
설치, 명령, 워크플로, 검증	User Guide
사용 시나리오	Examples
전체 문서 지도	Docs Index

프로젝트 상태

Codex Game Studio는 현재 결정적 프로젝트 스캐폴딩, Codex 역할 실행, 워크플로 프롬프트 렌더링, 파일 기반 작업 오케스트레이션, 저장소/프로젝트 검증을 지원합니다.

planner 또는 next 명령, 텔레메트리, 호스팅 오케스트레이션, 무제한 병렬 처리, 강제 출력 소유권, CODEX.md / project_orchestrator.md 생성은 현재 제품 경계 밖입니다.

라이선스

Codex Game Studio는 MIT License로 배포됩니다. LICENSE를 참조하세요.

4.1 KiB Raw Blame History