---
type: 설계문서
project: 수상한잡화점
subject: Phase 3 재개 로드맵 확정 (#38)
version: v1
date: 2026-04-20
status: 확정
author: 개발팀장
related:
  - 프로젝트/수상한잡화점/기획/Phase3_재개준비_체크리스트_v1.md
  - 프로젝트/수상한잡화점/시뮬레이터/01_시뮬레이터_아키텍처_v1.md
  - 프로젝트/수상한잡화점/시뮬레이터/02_시나리오_JSON_스키마_v1.md
  - 프로젝트/수상한잡화점/시뮬레이터/03_결과_JSON_포맷_v1.md
  - 프로젝트/수상한잡화점/시뮬레이터/04_MCP_호출_스니펫_v1.md
  - 공유/소통/개발팀→기획팀/2026-04-20_Phase3_재개_로드맵_병렬착수.md
핵심원칙:
  - Unity MCP EditMode 실측만을 단일 SOT로 채택
  - 기존 Unity 코드(Assets/Script/) 불변
  - 배경(과거형)과 현 상태(현재형) 섹션 분리
---

# Phase 3 재개 로드맵 확정 v1 (#38)

## 0. 문서 목적

개발팀 #38 "Phase 3 재개 로드맵 — Unity MCP 단일축 밸런스 작업 재개 범위·선후관계·검증 축 확정" PD님 재개 지시 수령(2026-04-20) 후 개발팀 공식 SOT로 3요소 확정. 기획팀 `Phase3_재개준비_체크리스트_v1.md` 담당 매핑을 전제로 **개발팀 역할 + 병렬 진행 경계**만 본 문서가 확정한다.

---

## 1. 배경 (과거형 기록 — 현 블로커 아님)

### 1-1. 과거 HOLD 트리거 사유 (#28·#37에서 해결 완료)

| 항목 | 과거 상태 | 해결 커밋 |
|------|----------|----------|
| Python 자체 시뮬 vs Unity 실 메커닉 수치 괴리 | Q-P2 정밀 2차에서 `PCDefence_Mul=0.3` 실측(기획 가정 50% 불일치) | #28 (2026-04-17 Unity MCP 단일축 전환 확정) |
| Unity MCP 시뮬레이터 부재 | `Assets/Sim/` 독립 어셈블리 부재 | #37 (2026-04-17 `SimulationRunner`·`ScenarioLoader`·`ResultEmitter` + `ActorModel`·`DefenceModel`·`DamageCalc` 구현 완료) |

본 섹션은 **역사적 배경 기록**이며, 본 로드맵 실행 시점 현 블로커가 아니다 (P28-8 · `feedback_resolved_cause_as_current_hold.md` 준수).

### 1-2. 방향 확정 (재논의 대상 아님)

- Unity MCP EditMode 실측 = Phase 3 v2 밸런스 산출의 **단일 SOT**
- 기존 `Assets/Script/` 불변 (시뮬 코드는 `Assets/Sim/` 독립 어셈블리, Editor-only)

---

## 2. 현 상태 (현재형 — 2026-04-20 기준)

### 2-1. 재개 선행 조건 4종 현황 (`Phase3_재개준비_체크리스트_v1.md §1-1`)

| # | 조건 | 담당 | 현 상태 |
|---|------|------|--------|
| 1 | Unity MCP EditMode 독립 어셈블리(`Assets/Sim/`) 시뮬 환경 구축 | 개발팀장 | ✅ 충족 (#37 완료) |
| 2 | Unity MCP EditMode 실측 검증 (결정론·리플레이 보장) | 개발팀장 + 기획팀장 | ⏳ 미충족 (리포트 미작성) |
| 3 | 기획팀용 Unity MCP 시뮬 실행 가이드 | 개발팀 | ⏳ 미충족 (`공유/소통/개발팀→기획팀/` 빈 폴더) |
| 4 | PD님 재개 지시 | 총괄PM | ✅ 충족 (2026-04-20 수령) |

**진단**: 4종 중 2·3 미충족. 그러나 이 둘은 기획팀이 Unity MCP 실행을 필요로 하는 작업(Day 2~3 Phase 0~2 재검증) 착수 전에만 충족되면 족하므로, **기획팀 Day 1 작업은 병렬 착수 가능**.

### 2-2. 현 진행 블로커

- **외부 블로커**: 없음. PD님 재개 지시 수령으로 모든 외부 트리거 해제.
- **내부 선행 작업**: 조건 2·3 집행 필요 (개발팀 주도, 기획팀 Day 1과 병렬).

---

## 3. 재개 범위 (3요소 ①)

`밸런싱문서_일관성점검_v1.md §2` + Phase3 체크리스트 §2 기반.

### 3-1. 본 로드맵 재개 범위 (28개 재검증 항목 전수)

| 블록 | 재검증 항목 수 | 체크리스트 Day | 산출물 |
|------|-------------|-------------|-------|
| Phase 0~2 재검증 | 6건 (#1~#6) | Day 2~3 | `재검증보고_Phase0_1_2_v1.md` |
| Phase 3 본작업 — 성장 요소 기여도 | 6건 (#16~#21) | Day 4~7 | **`Phase3_성장요소기여도_v2.md`** (신규) |
| 이슈 1·3 통합 재논의 | 2건 | Day 8~10 | `이슈1_3_통합재논의_v1.md` |
| 스테이지 난이도·맵 패턴 | 9건 (#11~#15·#22~#25) | Day 11~14 | `재검증보고_맵패턴_v1.md` + 42개 슬롯 배치안 |
| 밸런싱 목표 재조정·v2 확정 | 5건 (#7~#10·#26~#28) | Day 15+ | `밸런싱전략_v1.md` §3 업데이트 |

### 3-2. 범위 외 (본 로드맵 배제)

- N7 방어 성공 조건 조건 풀 확장 → 별도 트랙 (`재논의대기_사전자료모음_v1.md §4-1`, #37 Q-P2 정밀 2차 실측 반영)
- 서버 Critical 3건(#2) → 서버팀 가동 대기 (본 로드맵과 독립)

---

## 4. 선후관계 (3요소 ②)

### 4-1. 의존성 그래프

```
[개발팀] 조건 2 실측 검증 리포트 (Day 1~3)
    │
    ├─→ [개발팀] 조건 3 기획팀용 실행 가이드 (Day 1~3 병렬)
    │       │
    │       ↓
    │   [기획팀] Day 2~3 Phase 0~2 재검증 6건 (조건 2·3 완결 필요)
    │       │
    │       ↓
    │   [기획팀] Day 4~7 성장 요소 기여도 6건
    │       │
    │       ↓
    │   [기획팀] Day 8~10 이슈 1·3 통합 재논의
    │       │
    │       ↓
    │   [기획팀+레벨기획자] Day 11~14 맵 패턴 재검증
    │       │
    │       ↓
    │   [기획팀장 → 총괄PM → PD님] Day 15+ v2 확정

[기획팀] Day 1 체크리스트 + 3개 사전 산출물 재독 (선행 조건 2·3 무관, 독립 착수)
```

### 4-2. 병렬 실행 라인 (본 로드맵 핵심)

| 라인 | 주체 | 작업 | 선행 조건 2·3 의존 |
|------|------|------|----------------|
| **A** | 개발팀 | 조건 2 실측 검증 리포트 작성 | — (본인이 조건 2) |
| **B** | 개발팀 | 조건 3 기획팀용 실행 가이드 작성 | — (본인이 조건 3) |
| **C** | 기획팀 | Day 1-1 체크리스트 전수 수행 | ❌ 무관 (독립 착수) |
| **D** | 기획팀 | Day 1-4 기존 3개 사전 산출물 재독 | ❌ 무관 (독립 착수) |
| **E** | 기획팀 | Day 2~3 Phase 0~2 재검증 6건 | ✅ A·B 완결 필요 |

A·B·C·D는 **즉시 병렬 착수**. E는 A·B 완결 후 순차 착수.

---

## 5. 검증 축 (3요소 ③)

### 5-1. 정본(正) 판정 기준

1. **Unity MCP EditMode 실측 = 정본** (Phase 3 v2 수치의 유일 근거)
2. **오차 허용**: 동일 시나리오에서 Unity 실 빌드 PlayMode vs MCP 시뮬 결과 **10% 이내** (`01_시뮬레이터_아키텍처_v1.md §5-3`)
3. **오차 초과 시**: Unity 실 빌드 결과를 정(正)으로, MCP 시뮬 모델 재조정 (`Phase3_재개준비_체크리스트_v1.md §6-1`)

### 5-2. 결정론·리플레이 요건

조건 2 검증 리포트에 다음을 실측으로 기록:
- **결정론**: 동일 시나리오 JSON · 동일 시드 · 동일 빌드 해시 → 결과 JSON 완전 일치 (해시 대조)
- **리플레이**: 결과 JSON 재주입 → 동일 tick 수 · 동일 최종 상태 재현

### 5-3. Phase 3 v2 채택 조건

- 성장 요소 기여도 목표치(`밸런싱문서_일관성점검_v1.md §2-4`)와 실측 대조 후 괴리 ±20% 이내면 수치 채택
- 괴리 20% 초과 시 기획팀장이 Day 8~10 이슈 1·3 통합 재논의로 이관 후 PD님 판단 요청

### 5-4. 회귀 방지

Phase 3 v2 수치 확정 후 해당 시나리오를 `Assets/Sim/Tests/` 회귀 셋으로 보존하여 이후 `Assets/Script/` 밸런스 수정 시 회귀 여부 자동 검출 (향후 개발팀 후속 작업).

---

## 6. 잔여 선행 조건 2·3 후속 집행 계획

### 6-1. 조건 2 실측 검증 리포트 (담당: 개발팀장 + 기획팀장)

산출물: `공유/소통/개발팀→기획팀/{YYYY-MM-DD}_Unity_MCP_실측검증_리포트_v1.md`

최소 포함 항목:
1. Unity Editor 버전 + 빌드 해시 (`Dev 브랜치 43b6074c4` 또는 최신)
2. 시나리오 JSON 5종 실행 결과 (앵커 전투 1 + 카드 시너지 2 + 성장 요소 2)
3. 결정론 검증 (3회 반복 실행 결과 해시 일치)
4. 리플레이 검증 (결과 JSON 재주입 → 동일 최종 상태)
5. Unity 실 빌드 PlayMode 대조 (5종 시나리오 중 앵커 1건 이상 대조)
6. 오차 측정 및 원인 분석

**Unity MCP 접근 환경 필요**. 본 세션 범위 밖 (C23 정직 — 실 Unity Editor + MCP 연결 환경 필요).

### 6-2. 조건 3 기획팀용 실행 가이드 (담당: 개발팀)

산출물: `공유/소통/개발팀→기획팀/{YYYY-MM-DD}_Unity_MCP_시뮬실행_가이드_v1.md`

최소 포함 항목:
1. Unity Editor 기동 절차 + MCP 연결 확인
2. 시나리오 JSON 작성 규칙 (`02_시나리오_JSON_스키마_v1.md` 축약)
3. `execute_code` 호출 스니펫 (`04_MCP_호출_스니펫_v1.md` 기반 기획팀 사용 시점 최적화)
4. 결과 JSON 해석 (`03_결과_JSON_포맷_v1.md` 축약)
5. 자주 발생 오류 TOP 5 + 해결법
6. 기획팀→개발팀 에스컬레이션 경로 (REQ 템플릿 연계)

### 6-3. 예상 소요 (C9-2 준수 — 일정 표현 없음)

종속 관계만 명시:
- 조건 2 완결 후 조건 3 최종본 산출 (조건 2 실측 결과를 가이드 예시에 반영)
- 조건 3 완결 후 기획팀 Day 2~3 착수 가능

---

## 7. 개발팀 역할 요약

| 역할 | 담당 | 산출물 |
|------|------|-------|
| 조건 2 실측 검증 | 개발팀장 주도 + 기획팀장 공동 | 리포트 v1 |
| 조건 3 실행 가이드 | 개발팀(클라이언트팀장 검토) | 가이드 v1 |
| `Assets/Sim/` 메커닉 불일치 시 모델 재조정 | 개발팀 클라이언트팀 | `Models/*.cs` 수정 커밋 |
| 기획팀 조건 판정 로직 구현 요청 대응 | 개발팀 클라이언트팀 | REQ 응답 |
| 회귀 셋 보존 (Phase 3 v2 확정 후) | 개발팀장 | `Assets/Sim/Tests/` append |

## 8. 기각안

1. **조건 2·3 동시 완결 후 기획팀 전체 착수** — 병렬 라인 차단으로 조직 생산성 저하. 본 로드맵은 C·D 즉시 착수 채택
2. **Python 시뮬 병행 교차 검증** — #28에서 기확정 폐기 사안. 재논의 대상 아님
3. **Phase 3 범위 축소 v2 (성장 요소만)** — 일관성 점검 28개 재검증 항목 전수 처리가 조직 완성도 원칙 (C9) 부합

---

## 참조

- `프로젝트/수상한잡화점/기획/Phase3_재개준비_체크리스트_v1.md` (기획팀 SOT)
- `프로젝트/수상한잡화점/시뮬레이터/01~04_*.md` (시뮬 인프라 설계)
- `프로젝트/수상한잡화점/기획/밸런싱문서_일관성점검_v1.md` (28개 재검증 항목 원천)
- `공유/소통/개발팀→기획팀/2026-04-20_Phase3_재개_로드맵_병렬착수.md` (기획팀 공유본)

## 변경 이력

| 일시 | 변경자 | 변경 필드 | 이전값 → 이후값 | 재미/품질 근거 | 관련 PD 지시 |
|------|-------|---------|-------------|-------------|-----------|
| 2026-04-20 | 개발팀장 | 신규 작성 | — → v1 | #38 PD님 재개 지시 수령 후 3요소(재개 범위·선후관계·검증 축) 확정 필요 | 개발팀 #38 |
