---
title: PenguTown 펭귄 에셋과 웹 이동 프로토타입
date: 2026-11-01T07:39:05.824Z
version: v1.0.0
status: 작업 중
state: progress
project: pengutown
type: 작업 메뉴얼
report_kind: manual
category: 순차 작업 · 반복 QA
summary: 공유 기획을 확인하고 실제 펭귄 에셋을 확보해 기본 이동과 물리 동작을 검증합니다.
format: tracefolio-v2
priority: normal
manual_id: pengutown-movement-20261101
round: 1
manual_state: active
payload: ../assets/submissions/2026-11-01-manual-20261101073905824-v1.0.0.json
---

## 목표와 완료 기준

공유 기획의 브라우저 3D 펭귄 공간을 기반으로 걷기·배 미끄러짐·경사·다이빙·수영 기본 구현

완료 기준: 실제 에셋·라이선스·애니메이션 확인, 기본 동작 구현, 실제 브라우저 검증, 결과 보고서 공개

최초 1회차 · 순차 진행 · 전체 4개 · 이번 실행 T01, T02, T03, T04

## 순차 작업 메뉴얼

| 순서 | 작업 | 실행 절차 | 완료 기준 | QA 절차 | 상태 |
| --- | --- | --- | --- | --- | --- |
| T01 | 에셋과 기획 확인 | 공유 본문을 브라우저에서 읽고 무료 모델 원본과 판매자 정보를 확인합니다. | 확인한 라이선스와 실제 클립 목록을 기록합니다. | 원본 ZIP·GLB 구조·출처를 대조합니다. | 진행 |
| T02 | 기본 이동 구현 | 눈섬·바다와 걷기·배 미끄러짐·경사 가속·다이빙·수영·카메라를 구현합니다. | 동작이 연결되고 실제 펭귄 에셋이 표시됩니다. | 자동 물리 시나리오와 빌드, 실제 조작을 검사합니다. | 대기 |
| T03 | 실행 검증 | 브라우저에서 씬·조작·상태 전환을 실행하고 관찰한 문제를 수정합니다. | 모델이 표시되고 핵심 이동 전환이 실행됩니다. | 실제 화면·로그와 물리 테스트 결과를 비교합니다. | 대기 |
| T04 | 배포와 결과 공개 | 소스·사이트와 중앙 보고서를 게시하고 배포 상태·개별 링크를 확인합니다. | 실행 결과와 제한을 외부에서 열리는 보고서로 전달합니다. | 정확한 커밋·배포 상태·공개 본문을 확인합니다. | 대기 |

## QA 반복 기록

아직 실행한 QA가 없습니다. 준비된 절차를 통과 결과로 표시하지 않습니다.

## 남은 작업과 다음 반복

구현·실행 QA·게시 진행 중

최초 회차입니다. 실패·미검증·남은 작업은 다음 회차에서1~5개로 줄여 이어갑니다.

## 작업 시간

- 제안 시간: 조사 5~10분, 구현·검증 추가 20~40분
- 실제로 완료된 시간: 진행 중
- XERJ: 미사용 — 빈 프로젝트이며 제공된 XERJ 연결·검색 스크립트 없음. 직접 파일 검사와 rg 사용