Sprint 01 W2 Importer Precheck — D+0 PRINT-AND-CHECK 진입 게이트

작성: 2026-05-02 (code-lead 정현우) · 옵션 A 채택본 입력 자료 (이전 정독 완료, 자기충족): - designs/sprint-01-w2-importer-design.md v1.0 APPROVED (4 결정 + §9 11체크 본문) - designs/scaffold-sync-audit-2026-04-21.md v1.0 (D1·D4 정합) - designs/sp04_w1_preflight.md v1.2 (어픽스 v1.3 흡수, AFX_36 신규) - designs/affix_pool_sp04_supplement_v1.md v1.3 (변동 4건 원본) - sprints/sprint-01.md D-2 확정본 (W2 #W2-01~10 + 가드 6건 인라인) - Unity6/Assets/Editor/GodBlade.Editor.asmdef (rootNs GodBlade.EditorTools) - Unity6/Assets/_Project/Scripts/Data/GodBlade.Data.asmdef (references 빈 배열) - Unity6/Assets/_Project/Scripts/Runtime/GodBlade.Runtime.asmdef (Unity.ResourceManager line 7) - Unity6/Packages/manifest.json line 10 test-framework 1.4.5 (lock builtin 1.6.0 자동 해석) - graphify-out/GRAPH_REPORT.md (god nodes Top 10 + Community 0~30 헤드) 목적: 2026-05-11 (월) 오전 W2 진입 PRINT-AND-CHECK 양식 1쪽. 책상 위 출력 → 11 게이트 체크 → GO/NO-GO 판정. 패치 1~2h 버퍼 명시. PD 결정 확인: 옵션 A 채택 + 신규 폴더 3개 경로 사전 승인 완료 (2026-05-02).

§1. 4 결정 vs 설계 정합 (정합 점수 4/4)

정합 점수: 4/4 (PD 승인 결정 4건 ↔ 설계 본문 ↔ sprint-01.md W2 작업표 = 1:1:1 매핑 무드리프트)

§2. §9 11체크리스트 W2 작업 단계 매핑 (CP9-1 ~ CP9-11)

커버리지: 11/11 (전 항목이 W2 #W2-01~10 중 1건 이상에 매핑됨)

§3. 신규 파일 14개 + 신규 폴더 3개 명세 (PD 경로 승인 완료)

3.1 신규 폴더 3개 (PD 사전 승인 완료 2026-05-02)

3.2 Data 어셈블리 신규 4 파일 (GodBlade.Data namespace)

3.3 Editor 어셈블리 신규 4 Importer (GodBlade.EditorTools namespace)

3.4 Runtime 어셈블리 신규 1 파일 (GodBlade.Runtime.Rewards namespace)

3.5 Tests 어셈블리 신규 1 asmdef + 3 테스트 파일 (GodBlade.Tests.Editor namespace)

3.6 SO 에셋 자동 생성 3 파일 (Importer 첫 실행 시)

총합: 신규 코드 파일 13개 (D 4 + E 4 + R 1 + T 4) + asmdef 1개 + SO 에셋 3개 = 17 entry, 신규 폴더 3개.

§4. namespace 컨벤션 (CP9-5 단일 진실)

가드 규칙:

• Editor 측 4 Importer 저장 직후 → namespace GodBlade.EditorTools 명시 그렙 1회 (#가드-네임스페이스, sprint-01.md #W2-05 직후)
• rootNamespace 자동 삽입 비신뢰 (R-DR-03) — 파일 최상단 명시 강제

§5. 오늘(2026-05-02) ALL IN 사이클 변동 흡수 영향 표

총평: 오늘 사이클 변동 5건 모두 Sp04+ 영역 흡수, W2 (Sp01) 범위 무영향. PD가 W2 진입 GO 판정 시 변동 흡수 부담 0.

§6. Sp00 회귀 2건 재발 방지 가드

6.1 회귀 A — CS0246 (Unity.ResourceManager 누락)

• 재현 조건: AsyncOperationHandle<T> 사용 + asmdef references에 Unity.ResourceManager 누락
• 현 scaffold 상태: GodBlade.Runtime.asmdef:7 "Unity.ResourceManager" 유지 / GodBlade.Editor.asmdef:9 "Unity.ResourceManager" 유지 (scaffold-sync-audit §1.3 / §1.4 실사 확인)
• W2 신규 영향: #W2-06 신규 GodBlade.Tests.Editor.asmdef 생성 시 references에 Unity.ResourceManager 처음부터 포함 (CP9-1 / sprint-01.md #W2-06 명세)
• 가드: 4 신규 SO + 1 Granter는 AsyncOperationHandle<T> 직접 사용 0건 (Granter는 SO 의존성 주입 받음, Addressables 로드는 별도 RewardBootstrap Sp02 이월) → references 누락 시에도 컴파일 안전

6.2 회귀 B — CS0579 (InternalsVisibleTo 중복 선언)

• 재현 조건: 신규 SO 파일 상단에 [assembly: InternalsVisibleTo("GodBlade.Editor")] 중복 부착
• 현 scaffold 상태: TranscendentStageSO.cs:22 단일 선언 유지 (Unity6/Assets/ 전체 grep 결과 1건 — scaffold-sync-audit §1.5 실사 확인)
• W2 신규 영향: 4 신규 SO (GradeRemap.cs 제외, 단 enum public이라 부착 불요) 작성 시 부착 충동 발생 가능 — sprint-01.md #W2-01 명세에 "InternalsVisibleTo 부착 금지 (public enum)" 명시
• 가드 4회 그렙 (sprint-01.md L77/80/84/87 인라인 편입):
• #가드-CS0579-1 — #W2-01 (GradeRemap.cs) 저장 직후 [assembly: InternalsVisibleTo 그렙 히트 1건 (TranscendentStageSO.cs:22) 유지 확인
• #가드-CS0579-2 — #W2-02 (DropRateTableSO.cs) 저장 직후 동일 그렙
• #가드-CS0579-3 — #W2-03 (MilestoneRewardCatalogSO.cs) 저장 직후 동일 그렙
• #가드-CS0579-4 — #W2-04 (AffixPoolSO.cs) 저장 직후 동일 그렙 (3회 연속 동일 패턴 = 피로도 축적 ⚠)

그렙 명령 1줄 (Windows PowerShell): Get-ChildItem -Recurse -Filter *.cs Unity6\Assets | Select-String "\[assembly: InternalsVisibleTo" 기대 결과: 히트 1건 (TranscendentStageSO.cs:22), 외 0건.

§7. graphify Communities 매핑 (메인 분석 결과 흡수)

7.1 god nodes Top 10 (W2 직접 의존도)

assert() (2314) / Neon (1114, 1099) / ToArray() (774) / ContainsKey() (682) / IsValid() (664) / Max() (629) / Equals() (522) / ToList (493) / Min() (485)

해석: Top 10 = 라이브러리 / Burst Intrinsics / LINQ / Dictionary 표준 메서드. W2 신규 13 코드 파일 직접 의존 0건 (단, ContainsKey() / Equals() 는 DropRateTableSO.GetDropRate 내부 Dictionary lookup에서 간접 사용 — 이는 무해, Sp00 TranscendentStageCatalogSO._byCode 패턴과 동일).

7.2 W2 핵심 의존 Communities (Addressables 4개 + Tests 1개)

7.3 모니터 대상 결론

• 모니터 대상 = Addressables 4 community (4·5·14·22) + Tests 1 community (1)
• god node 직접 의존 0 = 위험도 LOW
• Cohesion 0.0 일관 = monorepo 패턴 (Unity packages + 원본 server 50K LOC), W2 신규 17 entry는 격리 영역 — 다른 community에 직접 영향 0
• W2 PR 머지 후 graphify update . 1회 실행 권장 (코드 변경 반영, AST-only 비용 0)

§8. D+0 (2026-05-11 월요일 오전) PRINT-AND-CHECK 게이트 11/11

사용법: 이 페이지 책상에 출력. 11 체크박스 진행 → GO/NO-GO 판정 표 작성. 패치 1~2h 버퍼 포함.

+--------------------------------------------------------------+
|  Sprint 01 W2 D+0 진입 게이트 (2026-05-11 Mon, 오전)         |
+--------------------------------------------------------------+

[ ] G-W2.1 (CP9-1) : GodBlade.Tests.Editor.asmdef 신설 시 references 6종
                     (UnityEngine.TestRunner / UnityEditor.TestRunner /
                      GodBlade.Data / GodBlade.Runtime / GodBlade.Editor /
                      Unity.ResourceManager) 처음부터 포함 준비
                     → 검증: #W2-06 작업 직후 Test Runner 창 인식 확인

[ ] G-W2.2 (CP9-2) : GodBlade.Editor.asmdef line 8 "Unity.Addressables.Editor"
                     변경 0 (read-only)
                     → 검증: Get-Content GodBlade.Editor.asmdef | Select-String
                       "Unity.Addressables.Editor"
                     → 기대: 1건 히트

[ ] G-W2.3 (CP9-3) : InternalsVisibleTo 단일 선언 유지
                     → 검증: TranscendentStageSO.cs:22 1건만, 신규 4 SO 0건
                     → 가드 4회 (CS0579-1~4) 인라인 편입 완료
                     → 기대: 그렙 히트 1건

[ ] G-W2.4 (CP9-5) : 네임스페이스 - 4 Importer 모두 GodBlade.EditorTools /
                     1 Granter는 GodBlade.Runtime.Rewards 명시
                     → 검증: #W2-05 직후 #가드-네임스페이스 그렙 5회

[ ] G-W2.5 (CP9-6) : TSV Trim() 적용 - CRLF/LF 잔여 0
                     → 검증: 3 Importer 첫 실행 후 콘솔 BOM/CRLF 경고 0

[ ] G-W2.6 (CP9-8) : Dictionary 직렬화 0 - List 저장 + [NonSerialized] Dict
                     OnEnable lazy build
                     → 검증: 3 SO 에셋 Inspector에서 Dict 필드 표시 0

[ ] G-W2.7 (CP9-11): Addressables Rewards 그룹 단일 - FindGroup 후 CreateGroup
                     → 검증: Addressables 창에서 Rewards 그룹 1개만, 중복 0

[ ] G-W2.8 (DropRate 합) : 드롭률 합 1.000 ± 0.001 (10 버킷 x mob)
                     → 검증: #W2-02 첫 Import 후 콘솔 SUM 로그 OK
                     → FAIL: TSV 60행 재검수 (game-designer 회수)

[ ] G-W2.9 (TBD 14건)    : MilestoneRewardCatalog TBD_* prefix 14행 IsPlaceholder=true
                     → 검증: #W2-03 첫 Import 후 콘솔 Warn 14건

[ ] G-W2.10 (Tests Green): 5~8개 Edit 모드 테스트 Green
                     → 검증: Test Runner Run All → Pass 5+ / Fail 0
                     → 핵심: GradeRemap_RareLegacy_MapsToEpic_NotRare 통과

[ ] G-W2.11 (Console 0)  : Unity 에디터 연 상태 모든 파일 저장 후
                     Console 새 에러 0
                     → 검증: Console Clear -> 4 SO + 4 Importer + 1 Granter +
                       3 Tests 저장 -> 새 에러 0
                     → FAIL: §6 회귀 A/B 또는 §9 11체크 누락 점검 +
                       1~2h 패치 버퍼 활용

+--------------------------------------------------------------+
|  GO/NO-GO 판정                                              |
+--------------------------------------------------------------+
| 11/11 통과       : [ ] GO -> #W2-01 착수                    |
| 9~10/11 통과     : [ ] CONDITIONAL GO -> 1~2h 패치 버퍼 +   |
|                       FAIL 항목 1~2건 보강 후 재진입       |
| 8/11 이하 통과    : [ ] NO-GO -> PD 에스컬레이션 +          |
|                       sprint-01.md #PM-01 D+7 점검 연기    |
+--------------------------------------------------------------+
| 결정자  : code-lead (정현우) 자체 판정 + PM 보고            |
| 결정일  : 2026-05-11 (Mon) 오전                             |
| 패치 버퍼: 1~2h (sprint-01.md #W2-10 명시,                 |
|            메모리 feedback_codelead_review_compile_verify) |
+--------------------------------------------------------------+

§9. 잔여 미해결 / 인계 사항

9.1 W2 내 인지만 (조치 없음)

1. TSV 경로 차이 인지 (D4 drift, scaffold-sync-audit §4.3)

• Sp00 = data_extracted/transcendent_stage.tsv
• Sp01 W2 = designs/transcendent_drop_table.tsv 등 3종
• 각 Importer 상단 const string TSV_PATH 명시 (sprint-01.md L72~74 경로 상수 정정 반영)
• 첫 Import 실행 시 EditorUtility.DisplayDialog("TSV Not Found") 팝업 0 가드 (#가드-경로-1)

1. AffixPool TSV 파일명 재확인 (#W2-04 시작 시)

• affix_pool.tsv vs transcendent_affix_pool.tsv 둘 다 designs/ 존재
• game-designer 박세린에게 1줄 확인 요청 (D+0 오전, sprint-01.md L74 명시)

9.2 Sprint 02 인계 사항 (DQ3 이월)

1. TsvReader 공통화 = R-W2-2 회피 이월

• W2 1차 PR은 신규 3 Importer 단독 구현 (Sp00 TranscendentStageImporter 손대지 않음)
• sprint-02.md 킥오프 (sprint-01.md #PM-02, 2026-05-18) W1 또는 W2에서 별도 PR
• W2 말 회귀 0 확인 후 공통화 리팩터 PR 발주

1. MilestoneGranter.Award(200) 활성화 = Sp02 이월

• W2는 TODO 주석만 (sprint-01-w2-importer-design.md §10.4)
• Sp02 W1 프레스티지 PP GrantMilestone(200) 연쇄 이벤트 활성화

9.3 packages-lock 자동 해석 (D2 drift, 영향 0)

1. com.unity.test-framework 1.4.5 → 1.6.0 builtin 자동 해석

• manifest.json 요청 = 1.4.5
• lock 해석 = 1.6.0 builtin (Unity 6 LTS 정책)
• 기능 호환 (1.6.0은 1.4.5 superset) — 영향 0
• sprint-01-w2-importer-design.md §8.1 표기 "1.4.5 이상 (Unity 6 builtin)"으로 인지

§10. dots-platform 인수인계

본 W2 PR 범위 내 인계 사항 = 0건

측정 트리거 (Sp02 이후 dots-platform 호출 조건):

• Profiler DropRateTableSO.GetDropRate 호출 빈도 > 10K/frame (방치형 100배 가속 시)
• 또는 Dict GC alloc > 1KB/sec
• 둘 다 미충족 시 Dictionary 유지 (sprint-01-w2-importer-design.md §1.2 "DOTS는 Sprint 02 이후 측정 기반 재검토" 원칙 준수)

(끝, 2026-05-02 code-lead 정현우)