AIGD · 오케스트레이터
AIGD = AI 게임 디자인(AI Game Design). 휴대용 AI 게임 개발 방법론 패키지로서, 브레인스토밍 → 시스템 설계 → 플레이테스트 반복 → 최종화 및 핸드오프까지를 다루며, '다른 AI가 직접 개발할 수 있는' 핸드오프 패키지(플랫폼 독립적)를 생성합니다. 구현(기술 스택을 선택하여 클라이언트/서버를 작성하는 것)은 이 패키지에 포함되지 않으며, 향후 전용 랜딩 스킬에 맡깁니다.
상태: v0 (프리릴리스) — 종단 간 검증 완료 (실제 실행 데모 + 리포지토리 README의 실행 가능한
examples/워크스루).patterns/는 계속 성장하는 스타터 팩입니다 (references/README.md참조).
코어 모델 (세부 사항은 references/ 참조)
- 두 계층: ① 라이브 프로젝트 계층(스파인) —
프로젝트 차터(컨셉 / 플랫폼 / 대상 사용자 / 장르 / 스타일 / 명명 규칙) +매니페스트(시스템 목록 + 의존성 그래프 + 교차 계층 인덱스 + 고정 원장 + 번호 범위 레지스트리), 지속적으로 수정됨; ② 시스템별 제작 루프. - 중앙 집중식 진실 공급원: 열거형 / 번호 지정 / 인터페이스 계약 / 구성 테이블은 프로젝트 계층에 속함; 이중 복사본 (시스템 + 전역): 승인 / 리소스 요구 사항 / 프로토타입; 시스템 계층 전용: 규칙 / 백엔드 알고리즘.
- 모든 작업: 스파인 읽기 → 작업 수행 → 스파인에 다시 쓰기. 하위 계층에서 발견된 사항(새 시스템 / 새 의존성 / 새 열거형 / 변경된 컨셉)은 상위 계층으로 다시 작성됩니다.
- 방법론 진실 공급원:
references/methodology.md,references/README.md.
라우팅: "이번에 하고 싶은 작업"에 따라 하위 스킬 디스패치
| 하고 싶은 작업 | 하위 스킬 |
|---|---|
| 컨셉 / 코어 루프 / 플랫폼 / 대상 사용자 / 시스템 분할 | aigd-concept |
| 시스템 설계 (규칙 + 구성 테스트 데이터 + HTML 프로토타입) | aigd-system |
| 플레이테스트 후 시스템 최적화 (규칙/구성/프로토타입, 반복 가능) | aigd-iterate |
| 시스템 최종화 → 계약 / 승인 / 클라이언트-서버 문서 / 디자이너 대상 승인 체크리스트 | aigd-handoff |
| 전역 스펙 / 전체 프로토타입 / 구현 마스터 가이드 동기화; 공유 항목 변경 시 재확인 표시 | aigd-sync |
| UI 스크린샷 → UI DSL (패턴 UI 패러다임 지식 베이스 구축, 설계 시간 검색 및 참조용) | aigd-ui-capture |
사용법
- 먼저 스파인 읽기 (프로젝트 차터 + 매니페스트)를 통해 프로젝트가 어느 단계에 도달했는지, 이번 시스템의 상태는 무엇인지, 무엇이 누락되었는지 판단합니다.
- 스파인이 없음 →
aigd-concept로 프로젝트 시작 (스파인 구축). - 일치하는 하위 스킬을 선택하고 Skill 도구로 호출하여 실행합니다. 모든 하위 스킬은 동일한 스파인을 읽고 쓰며, 일관성과 재진입성을 유지합니다 (세션 간 / 다른 AI가 이어받을 수 있음).
- 일반적인 경로: 컨셉 (한 번) → 시스템별 {시스템 → 반복... (반복) → 핸드오프 최종화} → 동기화 (지속). iterate는 sync로 바로 이동하지 않습니다 — sync 진입을 위해서는 시스템이 이미
Final상태여야 하며, handoff만 최종화할 수 있습니다. 순서는 강제되지 않으며 필요에 따라 라우팅합니다.
스파인이 없을 때 (프로젝트에 처음 사용할 때,
project charter/manifest가 아직 존재하지 않음): "스파인 읽기"가 빈 결과를 반환 →aigd-concept로 직접 라우팅하여 스파인을 시작합니다. 이는 정상이며 오류가 아닙니다.
시작 자체 점검 (/aigd에 진입할 때마다 실행 — 사용자가 추측하도록 기다리지 말고 능동적으로 추진)
- 스파인이 존재하는가? 예 →
project-charter.md+manifest.md읽기; 아니오 →aigd-concept로 라우팅하여 프로젝트를 시작합니다. - 상태가
Final이 아닌 시스템은 무엇인가? 나열하고, 이번에 어느 것을 진행할지 사용자에게 묻습니다. Recheck시스템이 있는가? 먼저 재확인하도록 상기시킵니다 (일부 공유 항목이 변경됨) →aigd-sync로 라우팅하여 해결 (재확인 통과 →Final로 복귀 / 실패 → 반송).- 번호 범위 충돌 / 의존성 그래프의 순환? 확인하고 보고합니다.
상태 전이 (비선형 · 롤백 가능)
개념 ──→ 시스템 설계 ⇄ 플레이테스트 반복 ──→ 최종화 ──→ 통합
▲ │ │ │(반송)
│ │ │ ▼
│ └─경계 오류──┴────→ 플레이테스트로 복귀 / 개념으로 복귀
└────────── 통합에서 비호환성 발견 / 재분할 필요 ──────────┘
- 모든 반송 / 재분할은 매니페스트의 "롤백 로그"에 항목을 기록하며, "반송 규칙"에 따라
depended-on-by를 역조회하여 이미 최종화된 다운스트림 시스템을Recheck로 표시합니다 (aigd-handoff/aigd-sync참조). - 템플릿:
references/templates/(프로젝트 차터 / 매니페스트 / 구현 마스터 가이드, 강력한 형식).
패키지 구조 (전체 패키지 설치, 분할 금지)
aigd (이 오케스트레이터, references/ 방법론 및 템플릿 포함) + 6개의 하위 스킬 aigd-concept / system / iterate / handoff / sync / ui-capture, 이 환경의 스킬 디렉토리에 동일한 레벨로 설치됩니다 (호스트 에이전트 예: Claude Code의 .claude/skills/). 하위 스킬 본문은 ../aigd/references/를 사용하여 방법론을 가져옵니다 → aigd/는 동일한 레벨에 존재해야 함 (aigd-ui-capture는 ../aigd/references/ui-dsl-spec.md 및 scripts/를 거침, 마찬가지). 단일 진실 공급원, 개별 복사 금지; 나중에 독립적으로 배포하려면 플러그인으로 업그레이드하십시오 (references/README.md "패키징 및 휴대성" 참조).
프로젝트 환경 권장 사항
- 스파인 파일 (
project charter/manifest) 및 디자인 아티팩트는 Git/SVN 관리 아래에 두는 것이 좋습니다. 오케스트레이터는 각 작업 전에 버전 상태를 확인해야 합니다. - CHANGELOG (변경 원장)는 버전 관리를 보완합니다: VCS는 "무엇이 변경되었는지"를 기록하고, CHANGELOG는 "왜 + 어떤 모델인지"를 기록합니다 (이 방법론은 AI 지원 워크플로우이므로, 모델 기록은 특정 변경이 어디서 왔는지 추적하는 데 도움이 됩니다).
경계
- "다른 AI가 직접 개발할 수 있는 핸드오프 패키지"까지 다룹니다 (플랫폼 독립적: 규칙 / 계약 / 구성 / 승인 / 프로토타입 / 리소스 요구 사항).
- 기술 스택 선택 및 클라이언트/서버 구현 = 다운스트림, 이 패키지에 포함되지 않음.