11 KiB

Raw Blame History

type

project

subject

version

date

status

author

핵심원칙

설계문서

수상한잡화점

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

2026-04-20

확정

개발팀장

프로젝트/수상한잡화점/기획/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. 정본(正) 판정 기준

Unity MCP EditMode 실측 = 정본 (Phase 3 v2 수치의 유일 근거)
오차 허용: 동일 시나리오에서 Unity 실 빌드 PlayMode vs MCP 시뮬 결과 10% 이내 (01_시뮬레이터_아키텍처_v1.md §5-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

최소 포함 항목:

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

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

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

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