diff --git a/.claude/skills/너드나비스-코어룰/SKILL.md b/.claude/skills/너드나비스-코어룰/SKILL.md index 062c73c..c37781f 100644 --- a/.claude/skills/너드나비스-코어룰/SKILL.md +++ b/.claude/skills/너드나비스-코어룰/SKILL.md @@ -1039,20 +1039,6 @@ PD님이 **"세션 공유"**라고 지시하면, 현재 세션의 모든 변경 | **PM 확인 필요** | 신규 시스템 제안, 기존 방향 변경, 타 부서 영향 결정 | 새 메커니즘 도입, 기존 조건 체계 재편 | | **PD님 확인 필요** | 핵심 밸런싱 방향 전환, 유저 경험 직접 영향, 데이터 자산 변경(C6) | 전투 공식 변경, 과금 밸런스 조정 | -## C32. 대화로그 기록 의무 (2026-04-18 PD님 직접 지시로 **P24에서 헌법급 승격**) - -> **승격 근거**: 2026-04-18 PD님 직접 지시. "P24·P27도 코어룰로 승격 시켜." 본 규칙이 **조직 노하우 축적의 핵심 도구**로 확인되어 프로젝트 규칙에서 헌법급으로 상향. **구 P24·구 P22(결정로그) 흡수** (상세: [폐기 규칙 아카이브](../../../공유/조직공지/폐기_규칙_아카이브.md)). -> -> 본 C32 본문은 기존 P24 본문을 그대로 승격한 것이며, 아래 상세 조항(기록 시점·형식·기각안 필수화·읽기 의무 등) 전체가 헌법급 의무로 격상되었다. - -### C32-통합 안내. 구 P22 결정로그 기능 흡수 - -**구 P22 결정로그 발행 의무**(2026-04-18 C32에 흡수)는 다음과 같이 대화로그 체계로 통합한다: -- 의미 있는 결정이 발생하면 **대화로그 엔트리에 결정·근거·영향 3요소 기록** (구 P22 결정로그 3요소 동일) -- 결정·설계 엔트리는 **"기각안" 필드 필수** (P24 기각안 필수화 정신) -- 별도 결정로그 파일(`공유/소통/{부서}→PM/`) 발행은 **선택 사항**이며 대화로그 엔트리만으로도 요건 충족 -- 자기 송신 채널 결정로그 파일이 필요한 경우(타 부서 영향 명시적 공지 등) 대화로그 + 결정로그 병행 가능 - ## P29. 코어 코드 프레임워크 프로젝트 규칙 (2026-04-18 PD님 직접 지시) > **적용 범위**: **코어 코드 프레임워크** 프로젝트 (`코어코드/NerdNavis.Framework/`·`프로젝트/코어프레임워크/`) 전용 규칙. 본 규칙은 프로젝트 단위 고유 규칙으로 P17(수상한잡화점 전용)과 동일 층위. @@ -1667,6 +1653,22 @@ PD님 직접 선언: **"이 문제는 우리 조직의 사활이 걸린 매우 --- +## C32. 대화로그 기록 의무 (2026-04-18 PD님 직접 지시로 **P24에서 헌법급 승격**) + +> **승격 근거**: 2026-04-18 PD님 직접 지시. "P24·P27도 코어룰로 승격 시켜." 본 규칙이 **조직 노하우 축적의 핵심 도구**로 확인되어 프로젝트 규칙에서 헌법급으로 상향. **구 P24·구 P22(결정로그) 흡수** (상세: [폐기 규칙 아카이브](../../../공유/조직공지/폐기_규칙_아카이브.md)). +> +> 본 C32 본문은 기존 P24 본문을 그대로 승격한 것이며, 아래 상세 조항(기록 시점·형식·기각안 필수화·읽기 의무 등) 전체가 헌법급 의무로 격상되었다. + +### C32-통합 안내. 구 P22 결정로그 기능 흡수 + +**구 P22 결정로그 발행 의무**(2026-04-18 C32에 흡수)는 다음과 같이 대화로그 체계로 통합한다: +- 의미 있는 결정이 발생하면 **대화로그 엔트리에 결정·근거·영향 3요소 기록** (구 P22 결정로그 3요소 동일) +- 결정·설계 엔트리는 **"기각안" 필드 필수** (P24 기각안 필수화 정신) +- 별도 결정로그 파일(`공유/소통/{부서}→PM/`) 발행은 **선택 사항**이며 대화로그 엔트리만으로도 요건 충족 +- 자기 송신 채널 결정로그 파일이 필요한 경우(타 부서 영향 명시적 공지 등) 대화로그 + 결정로그 병행 가능 + +--- + ## C34. PC 로컬 실시간 공유 중앙화 체계 — Live + memory (🏆 조직 핵심 자산, 2026-04-18 P25 승격 + 2026-04-19 memory 편입) > **승격·격상·확장 근거**: 2026-04-18 worktree 격리로 P25 체계 실패 실증. PD님 직접 선언 — **"이 문제가 해결되지 않으면 앞으로 우리 조직은 유지될 수 없어"** · **"철저히 검토해서 관련 문서에 일괄 반영하고 재발되지 않도록 가능한 모든 수단을 써서 개선해"**. 2026-04-19 PD님 추가 선언 — **"근본 해결이 아닌 임시 방편은 코어 룰 위반. C34와 동급의 생존성 이슈는 '권고' 수준이 아니었어"** → memory junction 경계 이슈도 C34 패턴으로 근원 해결(옵션 A) 확장. 헌법 제1원칙 ⑤(세션·PC 연속성 보장)의 근본 위협 차단. 구 P25 경위: [폐기 규칙 아카이브](../../../공유/조직공지/폐기_규칙_아카이브.md). diff --git a/프로젝트/수상한잡화점/개발/13_Phase3_재개로드맵_확정_v1.md b/프로젝트/수상한잡화점/개발/13_Phase3_재개로드맵_확정_v1.md new file mode 100644 index 0000000..066a95b --- /dev/null +++ b/프로젝트/수상한잡화점/개발/13_Phase3_재개로드맵_확정_v1.md @@ -0,0 +1,220 @@ +--- +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 |