| name | cat-adventure |
| description | 고양이 Side-scrolling 게임 제작 오케스트레이터. SVG 에셋, 애니메이션, 물리엔진, 게임 엔진을 에이전트 팀으로 통합 제작. '게임 만들어', '게임 제작', '고양이 게임', 'side scrolling', '사이드 스크롤링 게임', '물리엔진 게임' 등 게임 제작 요청 시 반드시 이 스킬을 사용. |
Cat Adventure — Side-scrolling 고양이 게임 제작 오케스트레이터
귀여운 고양이가 도시를 모험하며 먹이를 구하고, 동료를 구출하고, 위험을 피해 목적지에 도달하는 Side-scrolling 게임을 에이전트 팀으로 제작한다. 현실감 있는 물리엔진을 적용하여 고양이의 움직임과 환경 상호작용에 생동감을 부여한다.
실행 모드: 에이전트 팀
워크플로우
Phase 1: 게임 기획 (game-designer)
game-designer 에이전트가 게임 기획서를 작성한다.
작업:
- 스토리 구성 — 고양이의 모험 배경, 각 스테이지 스토리
- 캐릭터 명세 — 주인공, 동료 고양이(5종), 적(3종), 보스(1종)
- 레벨 디자인 — 5개 스테이지 (골목길 → 공원 → 시장 → 공사장 → 옥상)
- 메카닉스 정의 — 이동, 점프, 벽점프, 아이템 수집, 동료 구출, 적 회피
- 물리 요소 명세 — 스테이지별 물리 오브젝트, 환경 효과, 상호작용 요소
- 에셋 명세서 — svg-artist가 제작할 모든 에셋 목록 (파괴 파편 포함)
산출물: _workspace/01_design_game-design-doc.md
Phase 2: 물리엔진 + 에셋 제작 + 게임 엔진 (3-way 병렬)
기획서를 기반으로 physics-engineer, svg-artist, game-developer가 병렬로 작업한다.
physics-engineer 작업:
- PhysicsWorld — 고정 timestep 시뮬레이션 루프
- RigidBody — 질량, 관성, 속도, 각속도 컴포넌트
- 충돌 형상 — AABB, Circle, Polygon, Capsule
- SAT 충돌 감지 — 브로드페이즈(Spatial Hash) + 내로페이즈(SAT)
- 임펄스 기반 충돌 해결 — 법선/접선 임펄스, 마찰
- 제약 솔버 — DistanceJoint(로프), RevoluteJoint(시소), SpringJoint(탄성)
- 환경 힘 — 중력, 바람, 부력, 공기저항
- 물리 머티리얼 — 콘크리트, 나무, 금속, 얼음, 고무, 물, 골판지
- 캐릭터 컨트롤러 — 고양이 전용 (벽 미끄러짐, 벽 점프, 코요테 타임, 점프 버퍼)
- 환경 물리 — 움직이는 플랫폼, 단방향 플랫폼, 파괴 가능 오브젝트, 컨베이어
- 물리 디버그 렌더러 — 충돌체/힘 벡터 시각화
- 물리 API 문서 — game-developer 통합용 인터페이스 문서
svg-artist 작업:
- 주인공 고양이 SVG (상태별: idle, run, jump, fall, wallslide, hurt, landing-squash)
- 동료 고양이 SVG (갇힌 상태 + 구출 상태)
- 적 캐릭터 SVG (개, 자동차, 까마귀 등)
- 배경 레이어 SVG (원경, 중경, 근경 — 패럴랙스용)
- 아이템 SVG (생선, 우유, 참치캔 등)
- 플랫폼/장애물 SVG
- 파괴 파편 SVG — 나무상자/골판지 파편, 유리 조각 등
- 물리 이펙트 SVG — 착지 먼지, 물방울, 바람 이펙트
- UI 요소 SVG (체력바, 점수판, 메뉴)
- CSS 애니메이션 정의 (착지 스쿼시/스트레치 포함)
game-developer 작업:
- 프로젝트 초기화 (Vite + 기본 구조)
- 게임 엔진 코어 (게임루프, 렌더러, 카메라)
- 입력 시스템 (키보드 + 터치)
- 엔티티 시스템 (Player, Enemy, NPC, Item — 물리 컴포넌트 슬롯 포함)
- 레벨 시스템 (로더, 스크롤링, 물리 오브젝트 인스턴스화)
- UI 시스템 (HUD, 메뉴)
- 사운드 시스템
- 애니메이션 시스템 (물리 상태 → SVG 애니메이션 매핑)
산출물:
src/physics/ — 전체 물리엔진 (physics-engineer)_workspace/02_physics_api-doc.md — 물리 API 문서 (physics-engineer)src/assets/ — 모든 SVG 에셋 (svg-artist)src/styles/animations.css — 애니메이션 정의 (svg-artist)src/ — 게임 엔진 코드 (game-developer)
Phase 3: 통합 (game-developer + physics-engineer)
game-developer가 물리엔진과 SVG 에셋을 게임 엔진에 통합한다. physics-engineer가 물리 통합을 지원한다.
작업:
- PhysicsWorld를 게임 루프에 통합 (고정 timestep + 보간)
- 엔티티에 RigidBody/충돌체 연결
- 캐릭터 컨트롤러를 입력 시스템에 연결
- SVG 에셋 로딩 및 DOM 삽입
- 애니메이션 클래스 연결 (물리 상태 → SVG 애니메이션)
- 레벨 데이터에 물리 오브젝트/머티리얼/환경 힘 매핑
- 전체 게임 플로우 연결 (메뉴 → 레벨 선택 → 플레이 → 클리어/게임오버)
Phase 4: QA 검증 (qa-tester)
qa-tester가 전체 게임을 검증한다.
작업:
- 빌드 검증 — 에러 없이 빌드되는지
- 코드 정합성 — 모듈 간 참조, import/export 확인
- 에셋 통합 — SVG 참조 일치 확인
- 물리 검증:
- 고양이 이동/점프/벽점프 자연스러운지
- 충돌 감지 정확한지 (관통/터널링 없는지)
- 환경 물리 동작 (파괴, 바람, 움직이는 플랫폼)
- 물리 머티리얼 반응 차이 (얼음 미끄러짐, 고무 튕김)
- 60fps 유지되는지 (물리 연산 병목 없는지)
- 게임 로직 — 점수, 레벨 전환, 상태 전이 검증
- 버그 리포트 작성 및 수정 요청
산출물: _workspace/04_qa_test-report.md
Phase 5: 버그 수정 및 폴리싱
qa-tester의 리포트를 기반으로 game-developer, physics-engineer, svg-artist가 수정한다.
데이터 흐름
game-designer ──기획서──→ physics-engineer (물리 요소 명세)
──→ svg-artist (에셋 명세)
──→ game-developer (메카닉스, 레벨)
physics-engineer ──물리 API 문서──→ game-developer (통합 인터페이스)
──파편 SVG 요청──→ svg-artist
──물리 모듈──→ game-developer (src/physics/)
svg-artist ──에셋──→ game-developer (SVG 파일, 클래스명)
game-developer ──빌드──→ qa-tester (실행 가능한 게임)
──통합 이슈──→ physics-engineer (물리 버그)
qa-tester ──버그리포트──→ game-developer (게임 버그)
──물리이슈──→ physics-engineer (물리 버그)
──에셋이슈──→ svg-artist (에셋 수정)
팀 구성
TeamCreate(
team_name="cat-adventure-team",
members=[
{"name": "game-designer", "agent": "game-designer", "model": "opus"},
{"name": "physics-engineer", "agent": "physics-engineer", "model": "opus"},
{"name": "svg-artist", "agent": "svg-artist", "model": "opus"},
{"name": "game-developer", "agent": "game-developer", "model": "opus"},
{"name": "qa-tester", "agent": "qa-tester", "model": "opus"}
]
)
태스크 의존성
TaskCreate([
{"id": "T1", "name": "게임 기획서 작성", "assignee": "game-designer", "depends_on": []},
{"id": "T2", "name": "물리엔진 구현", "assignee": "physics-engineer", "depends_on": ["T1"]},
{"id": "T3", "name": "SVG 에셋 전체 제작", "assignee": "svg-artist", "depends_on": ["T1"]},
{"id": "T4", "name": "게임 엔진 코어 구현", "assignee": "game-developer", "depends_on": ["T1"]},
{"id": "T5", "name": "물리-엔진-에셋 통합", "assignee": "game-developer", "depends_on": ["T2", "T3", "T4"]},
{"id": "T6", "name": "QA 검증", "assignee": "qa-tester", "depends_on": ["T5"]},
{"id": "T7", "name": "버그 수정", "assignee": , : []},
{: , : , : , : []}
])
에러 핸들링
| 에러 유형 | 전략 |
|---|
| 에이전트 실패 | 1회 재시도 후 부분 결과로 진행 |
| 에셋-코드 불일치 | qa-tester가 감지, game-developer와 svg-artist에게 수정 요청 |
| 물리 발산/터널링 | qa-tester가 감지, physics-engineer에게 즉시 전달 |
| 물리-엔진 통합 이슈 | game-developer와 physics-engineer가 직접 소통하여 해결 |
| 빌드 실패 | game-developer에게 에러 로그 전달, 즉시 수정 |
| 성능 이슈 (물리) | physics-engineer에게 최적화 요청 (sleep, 브로드페이즈 조절) |
| 성능 이슈 (렌더링) | svg-artist에게 에셋 단순화, game-developer에게 렌더링 최적화 요청 |
테스트 시나리오
정상 흐름
- game-designer가 기획서 작성 (물리 요소 명세 포함)
- physics-engineer, svg-artist, game-developer가 병렬 작업
- physics-engineer가 물리 API 문서를 game-developer에게 전달
- svg-artist가 파괴 파편 SVG를 physics-engineer 요청에 따라 제작
- game-developer가 물리엔진 + 에셋 통합 완료
- qa-tester가 물리 동작 포함 전체 검증, 경미한 버그 보고
- physics-engineer와 game-developer가 수정, 최종 빌드 완성
에러 흐름
- game-designer 기획서 완성
- physics-engineer가 물리엔진 구현, 충돌 해결에서 관통 이슈 발생 → CCD 추가 구현
- game-developer 통합 시 물리 timestep과 렌더링 프레임 불일치 → physics-engineer와 보간 로직 조율
- qa-tester가 4단계(공사장) 컨베이어에서 고양이 떨림 버그 발견 → physics-engineer가 velocity iteration 횟수 조정
- 재검증 후 통과
