MagnetismHeroes/.dryforge/002/handoff.md

# 자석 영웅과 맑은 초원 세계 — 실행 인계

## 문서 역할과 위치

| 문서 | 역할 |
|---|---|
| `.dryforge/spec.md` | 제작할 모습·게임 동작·유지 경계·완성 및 검증 조건 |
| `.dryforge/plan.md` | 작업 대상·담당 경계·순서·작업별 검증과 실행 의존 관계 |
| `.dryforge/handoff.md` | 위 문서를 실행할 때 지킬 공통 원칙과 인계 조건 |

결과의 모습과 동작에 충돌이 있으면 spec을 따른다. plan의 방법과 세부 작업 분할은 spec을 만족하는 범위에서 조정할 수 있다. spec의 요구 변경은 사용자와 확인한다. 기존 코드와 제작 도구는 구현 방식의 참고이며 새 외형의 요구를 대신하지 않는다. 프로젝트 지침의 수학·저장·자산 보호 경계는 유지한다.

현재 `.dryforge/status.json`이 존재하는 기존 프로젝트 작업이다. 프로젝트 자체의 새 기획·기반 구축은 하지 않는다. 과거 `.dryforge/001/` 문서와 기존 프로젝트 문서는 이전 결정·검증 이력으로 보존한다. 이번 문서가 지정한 새 기사 외형과 세 자연 풍경은 이전 시각 디자인을 교체한다.

## 실행 개요

편집 가능한 Blender 영웅 원본과 자연 세계 원본을 각각 제작하고, 구 몸체·기사 장비·초원·꽃 언덕·바위 언덕의 완성 모델을 사용자에게 검토받는다. 모든 대상에 대한 명시적 승인 후 한 담당자가 실제 Unity 게임에 연결한다. 실제 장면에서 조작·시각 품질을 확인하고 보정한 뒤, 같은 최종 소스의 Android 앱을 빌드·설치·검증한다. 원본·게임 파일·출처·검수 증거를 함께 납품한다.

사용자가 채택한 방향은 묶음당 기사 한 명, 둥근 구 몸체와 기존 표정·작은 반응, 투구·짧은 칼·방패, 전체 30개 스테이지의 초원·꽃 언덕·바위 언덕 교체, 게임 적용과 Android 시험용 앱 검증까지다. 이 네 방향은 다시 선택받을 필요가 없다.

참고 이미지는 `.dryforge/reference/cartoon-landscape.png`다. 색·형태·소재·빛의 방향을 참고하며 원작 캐릭터나 총을 복제하지 않는다. 영웅 장비뿐 아니라 구 몸체의 메시·재질 자체를 개선해야 한다. 모든 핵심 의도는 spec과 plan에 수록했으며 별도의 숨은 요구는 없다.

## 반드시 지킬 조건

- 모델링 완료 후 실제 원본의 렌더·편집 가능한 파일 링크·검토 대상 해시를 제시하고 사용자 승인을 기다린다. 무응답·일부 승인·자동 검사·제작 문서 승인은 전체 모델 승인이 아니다. 승인 전 기존 게임의 시각 참조 교체·런타임 채택·후속 APK 검증을 진행하지 않는다. 수정 요청에는 변경본을 다시 검토받고 승인 기록을 갱신한다. 적용 중 승인된 외형을 눈에 띄게 바꾸는 경우에도 해당 변경본을 다시 검토받는다.
- 구 하나는 계속 1이고, 기본 크기·ID·총량·소속·아이 배열·수학 판정·기존 초기 위치를 보존한다. 기사 장비는 묶음당 한 벌이며 입력 대상이나 새 구가 아니다.
- 구의 얼굴 여섯 표정·숫자·계수·선택·접촉 표시가 실제 화면에서 보이고 조작 가능해야 한다. 분리·대표 변경·취소·재입장 때 장식이 남거나 중복되지 않는다.
- 30개 스테이지와 자유 놀이의 배경 전체를 같은 맑은 자연 세계로 교체한다. 내부 테마 값 `Garden`·`Cloud`·`Workshop`을 유지하면서 새 외형을 연결한다. 테마는 새로운 정답 조건이 아니다.
- 실제 가림과 아치 빈틈을 유지하고 구 발견·선택을 확인한다. 앞 소품 hit를 무시하는 입력 우회나 구 초기 위치 변경으로 검사를 통과시키지 않는다.
- 기존 진행과 JSON 저장 계약·복구·44개 승인 음성·한국어 UI·글꼴·오프라인을 보존한다. 새 음원·보행·전투·원격 전송·계정·광고·결제·플랫폼·게시를 추가하지 않는다.
- 초기 전체 builder로 완성 씬·프리팹·StageAsset·승인 자산을 다시 만들지 않는다. Unity 자산은 Unity의 편집·생성 경로로 필요한 대상만 변경한다. 모델 축·피벗·imported root 회전과 Unity 생성 `.meta`를 확인한다.
- 제작 원본과 과거 출처 이력을 보존한다. 새 원본·내보내기·런타임·검수의 경로·해시·사용 조건을 연결하고 제작 도구와 원본을 APK에 포함하지 않는다.
- Blender 렌더만으로 품질을 완료 판정하지 않는다. 실제 게임의 영웅·세 풍경, 여러 구 배열·시점·화면 비율에서 시각 검토표와 조작 증거를 남긴다. 비용은 모바일 사용을 고려해 조정하며 Editor·AVD 측정을 실기기 성능 합격으로 기록하지 않는다.
- 최종 제품 소스에서 spec의 네 단계 Final 검증을 실제 수행한다. 기존 증거를 보존하고 소스·제품 파일·APK·설치본 해시와 로그를 같은 실행으로 연결한다. 0개 검사·미평가·필수 사례 건너뜀은 통과가 아니다.
- 수량이나 이어하기 손상, 미승인 채택·요청하지 않은 외부 전송을 발견하면 관련 변경을 멈추고 증거·영향을 즉시 알린다. 다른 문제는 먼저 재현·수정하고 해결할 수 없는 실제 재현 문제만 findings에 남긴다.

## 실행 소유와 완료 인계

영웅·자연 모델은 서로 다른 파일을 소유한다. T3는 사용자의 모델 검토·승인 단계이며 자료 준비만으로 완료 처리하지 않는다. 공통 Unity 프리팹·씬·StageAsset·재질은 승인 후 T4의 한 작성자가 연결한다. 검사·Editor·Blender 저장·ADB·녹음은 지정한 실행 소유자가 관리하며 같은 환경을 동시에 조작하지 않는다. T6이 공통 자산 등록·운영·상태 문서를 최종 갱신한다.

현재 환경의 Unity·Blender·Android 절차와 실기기 후속 경계는 `docs/operations.md`, `docs/tracking/status.md`를 따른다. 현재 Android 검증은 전용 AVD에서 수행하며 실제 사용자 기록을 초기화하지 않는다. 실제 스마트폰·태블릿 FPS·발열·배터리와 아이 사용성, iOS·스토어 배포는 이번 검증 완료 주장에 포함하지 않는다.

최종 인계에는 Blender 원본, 채택된 게임용 파일 목록과 출처, 영웅과 세 풍경의 실제 게임 화면, 시각 검토표·조작/자원 관찰 결과, 네 단계 검사 결과, APK와 설치 해시, 미검증 범위를 포함한다.

이 문서 작성 단계의 산출물은 제작 명세와 계획이다. 제품 자산 생성·교체·빌드·Git 커밋은 아직 수행하지 않는다. 세 문서 검토·승인 후 같은 대화에서 `dryforge:go`를 호출하여 실행한다.