Scaffold Sync Audit — 2026-04-21

작성: 2026-04-21 (code-lead) · 대상: Unity6/ scaffold ↔ designs/sprint-{01-w2-importer,02-w2-prestige-tech-sketch,03-idle-research}-design.md v1.0 APPROVED × 3 감사 종류: 읽기 전용. 코드 수정 없음. 2026-05-04 Sprint 01 킥오프 Go/No-Go 판정용. 감사 방법: Unity6/ 실제 파일 내용 인용 + 설계 3건 요구사항 교차 → 3축(설계/실제/gap) 명시. 문서 상태: v1.0

§0. TL;DR (PD 1분)

판정: Sprint 01 킥오프 (2026-05-04) GO

• 블로커 없음. 핵심 자산(asmdef 3개, manifest, Addressables, Sprint 00 구현물)은 설계 3건 전제와 정합.
• 단 P1 4건 중 최소 2건(D1 rootNamespace, D3 Tests.Editor 신설)은 버퍼 기간(D+2~D+13) 선제 해소 권장. 나머지 2건은 Sprint 01 W1 Day 1 자연 흡수 가능.
• Sprint 00 회귀 재발 방지 레이어는 이미 코드에 박혀 있다 — TranscendentStageSO.cs:22 InternalsVisibleTo · GodBlade.Runtime.asmdef:7 Unity.ResourceManager · GodBlade.Editor.asmdef:9 Unity.ResourceManager 3지점 실사 확인.

§1. asmdef 감사

§1.1 실제 asmdef 전수 (3개, Tests.Editor 미존재 정상)

Unity6/Assets/Editor/GodBlade.Editor.asmdef                                   (22줄, rootNamespace=GodBlade.EditorTools)
Unity6/Assets/_Project/Scripts/Data/GodBlade.Data.asmdef                      (14줄, rootNamespace=GodBlade.Data)
Unity6/Assets/_Project/Scripts/Runtime/GodBlade.Runtime.asmdef                (18줄, rootNamespace=GodBlade.Runtime)

§1.2 GodBlade.Data.asmdef 실제 내용

{
  "name": "GodBlade.Data",
  "rootNamespace": "GodBlade.Data",
  "references": [],
  ...
  "autoReferenced": true,
  "noEngineReferences": false
}

(경로: Unity6/Assets/_Project/Scripts/Data/GodBlade.Data.asmdef:1-14)

§1.3 GodBlade.Runtime.asmdef 실제 내용

{
  "name": "GodBlade.Runtime",
  "rootNamespace": "GodBlade.Runtime",
  "references": [
    "GodBlade.Data",
    "Unity.Addressables",
    "Unity.ResourceManager"
  ],
  ...
}

(경로: Unity6/Assets/_Project/Scripts/Runtime/GodBlade.Runtime.asmdef:1-18)

§1.4 GodBlade.Editor.asmdef 실제 내용

{
  "name": "GodBlade.Editor",
  "rootNamespace": "GodBlade.EditorTools",
  "references": [
    "GodBlade.Data",
    "GodBlade.Runtime",
    "Unity.Addressables",
    "Unity.Addressables.Editor",
    "Unity.ResourceManager"
  ],
  "includePlatforms": ["Editor"],
  ...
}

(경로: Unity6/Assets/Editor/GodBlade.Editor.asmdef:1-22)

§1.5 InternalsVisibleTo 실제 위치

// Unity6/Assets/_Project/Scripts/Data/TranscendentStageSO.cs:21-23
#if UNITY_EDITOR
[assembly: System.Runtime.CompilerServices.InternalsVisibleTo("GodBlade.Editor")]
#endif

§1.6 GodBlade.Tests.Editor.asmdef — 미존재 (정상, Sprint 01 W2 신설)

§2. 네임스페이스 / 폴더 구조 감사

§2.1 실제 폴더 트리

Unity6/
└── Assets/
    ├── AddressableAssetsData/
    │   ├── AddressableAssetSettings.asset
    │   ├── AssetGroups/
    │   │   ├── Default Local Group.asset
    │   │   └── TranscendentStages.asset   ← Sprint 00 그룹
    │   └── DataBuilders/, Schemas/, AssetGroupTemplates/
    ├── Editor/
    │   ├── GodBlade.Editor.asmdef
    │   └── Importers/
    │       └── TranscendentStageImporter.cs   (Sprint 00)
    ├── _Project/
    │   ├── Data/                              ← SO 에셋 저장소
    │   │   ├── TranscendentStageCatalog.asset
    │   │   └── TranscendentStages/            (200개 Stage SO + meta)
    │   └── Scripts/
    │       ├── Data/                          ← GodBlade.Data 어셈블리
    │       │   ├── GodBlade.Data.asmdef
    │       │   ├── TranscendentStageSO.cs
    │       │   └── TranscendentStageCatalogSO.cs
    │       └── Runtime/                       ← GodBlade.Runtime 어셈블리
    │           ├── GodBlade.Runtime.asmdef
    │           └── SmokeTester.cs
    ├── Scenes/, InputSystem_Actions.inputactions, ...

Tests 폴더 없음 (Sprint 01 W2 신설 예정).

§2.2 네임스페이스 정책 실사

§2.3 서브 네임스페이스 충돌 검증

§2.4 D1 상세 분석: rootNamespace vs 설계 문서 표기

• 실제 (GodBlade.Editor.asmdef:3): "rootNamespace": "GodBlade.EditorTools"
• Sprint 00 컨벤션 (TranscendentStageImporter.cs:24): namespace GodBlade.EditorTools
• Sprint 01 W2 설계 §8.3 "asmdef 파일명 = GodBlade.Editor" 이지만 §9 CP9-5 에서 "GodBlade.EditorTools.Rewards(X, 평탄 유지)" 언급 → 설계 문서 내부에서도 EditorTools 인정
• Sprint 02 W2 설계 §2.1 "GodBlade.Editor asmdef" — 설계 문서는 asmdef 이름을 가리킴, 네임스페이스 아님
• 실제 구조: asmdef 이름 = GodBlade.Editor, rootNamespace = GodBlade.EditorTools, 파일 내 네임스페이스 = GodBlade.EditorTools
• 결론: asmdef 이름과 rootNamespace/네임스페이스가 다름. 혼동 유발 but 컴파일 상 문제 없음.

권장: Sprint 01 W2 W1 Day 1에 설계 문서 3건의 각주에 "asmdef 이름=GodBlade.Editor, 파일 내 네임스페이스=GodBlade.EditorTools" 1줄 추가 (문서만 수정, 코드 불변).

§3. manifest.json / packages-lock 감사

§3.1 manifest.json 실제 (9 dependencies)

{
  "com.unity.addressables": "2.2.2",
  "com.unity.inputsystem": "1.11.2",
  "com.unity.render-pipelines.universal": "17.0.3",
  "com.unity.textmeshpro": "3.2.0-pre.10",
  "com.unity.ugui": "2.0.0",
  "com.unity.ide.rider": "3.0.31",
  "com.unity.ide.visualstudio": "2.0.22",
  "com.unity.test-framework": "1.4.5",
  "com.unity.timeline": "1.8.7"
}

(경로: Unity6/Packages/manifest.json:1-18)

§3.2 packages-lock.json 해석 버전 (Unity 6 LTS가 실제로 로드하는 것)

§3.3 lock 자동 해석된 간접 의존 (설계 체크용)

§3.4 누락 패키지 (설계 3건에서 요구했지만 manifest에 없는 것)

없음. 설계 3건 모두 "scaffold manifest 이미 포함 가정" 원칙 준수.

§4. 기존 구현물 vs 설계 스펙 drift

§4.1 Sprint 00 산출물 실사

§4.2 Addressables 그룹 상태

AddressableAssetSettings.asset                (4033B)  — 전역 설정
AssetGroups/
  Default Local Group.asset                   (874B)   — 기본 그룹
  TranscendentStages.asset                    (41066B) — Sprint 00 그룹 (200 entries 내포)
  Schemas/
    Default Local Group_BundledAssetGroupSchema.asset
    Default Local Group_ContentUpdateGroupSchema.asset
    TranscendentStages_BundledAssetGroupSchema.asset
    TranscendentStages_ContentUpdateGroupSchema.asset

§4.3 TSV 입력 경로 drift (Sprint 00 convention vs Sprint 01 W2 TSV 위치)

Sprint 00 Importer 경로 해석 (TranscendentStageImporter.cs:129-137):
  candidate1 = <ProjectRoot>/../data_extracted/transcendent_stage.tsv
  candidate2 = <ProjectRoot>/data_extracted/transcendent_stage.tsv
실제 존재:
  d:/SVN/Backup/GodBlade/data_extracted/transcendent_stage.tsv           (Sprint 00)
  d:/SVN/Backup/GodBlade/designs/transcendent_drop_table.tsv             (Sprint 01 W2 대상)
  d:/SVN/Backup/GodBlade/designs/transcendent_milestone_reward.tsv       (Sprint 01 W2 대상)
  d:/SVN/Backup/GodBlade/designs/transcendent_affix_pool.tsv             (Sprint 01 W2 대상)
  d:/SVN/Backup/GodBlade/designs/prestige_items.tsv                      (Sprint 02 W1 대상)
  d:/SVN/Backup/GodBlade/designs/prestige_pp_cost.tsv                    (Sprint 02 W1 대상)
  d:/SVN/Backup/GodBlade/designs/prestige_effect_matrix.tsv              (Sprint 02 W1 대상)

§4.4 기존 그룹명 TranscendentStages — 설계 3건 신규 그룹과 충돌?

§5. 이벤트 훅 그래프 (발화자 × 구독자 매트릭스)

§5.1 설계 3건 선언 훅 7개

§5.2 발화·구독 순서 불변식

Sprint 03 §4.5 FlushCatchUp 순서:
  1. elapsed 계산 + cap + 역전 가드
  2. IdleRewardCalculator.Calculate → IdleRewardBundle
  3a. bundle.MilestonesReached.ForEach(floor => MilestoneGranter.Award(floor))
       └ floor==100 → PlayerPrestigeState.Unlock() 연쇄
       └ floor==200 → PrestigePpAccumulator.GrantMilestone(200) 연쇄
  3b. KillsTotal/DropsCompact → 로그만 (Sprint 04 실제 인벤토리)
  3c. PrestigePpAccumulator.GrantIdleDrip(elapsed, maxFloor)
         → PlayerPrestigeState.AddPermanentPp(amount) (내부)
  3d. OnIdleReward?.Invoke(bundle)  ← UI 알림용, State 반영 완료 후
  4. IdleSaveService.Save()

§5.3 MigrateSeasonalToPermanent(retainRatio) 구독자 현황

체크: Sprint 02 W2 §6.2 "W2는 구독자만 등록, 발화자 없음" — 설계 일관. 실제 코드 작성 시점에 OnSeasonEnd 이벤트는 정의만 (public static event Action OnSeasonEnd;), 어디서도 Invoke 호출 없음을 컴파일러/리뷰어가 확인해야 함 → P2 체크리스트 §7 추가.

§5.4 훅 그래프 이상 감지

§6. 발견된 Drift / Blocker / Gap 목록

우선순위 범례

• P0 Blocker — 2026-05-04 킥오프 전 반드시 해소, 미해소 시 Sprint 01 W2 코딩 불가
• P1 Warning — 버퍼 기간(D+2~D+13) 선제 해소 강력 권장, 미해소 시 W1 Day 1에 혼동·재작업 유발
• P2 Note — Sprint 01 W1 초입 2~4시간 자연 흡수 가능
• P3 Info — 문서 주석만 추가, 코드 변경 불요

P0 Blocker = 0건

판정: 2026-05-04 Sprint 01 W2 킥오프에 직접 차단되는 항목 없음.

Sprint 00 회귀 2건 재발 방지 레이어 — 실사 확인

Sprint 01 W2/02 W2/03 모두 이 레이어를 요구(각 §9/§8). 현 scaffold에서 이미 해소됨 → 신규 파일 작성 시 이 두 위치를 건드리지만 않으면 재발 없음.

§7. Sprint 01 킥오프 Go/No-Go 체크리스트 (2026-05-04)

PD가 킥오프 시점에 1분 내 확인. 7개 bullet. 6개 이상 ✅면 GO.

• §A. asmdef 3개 실존 + Unity 에디터 열어서 Console 에러 0

— Unity6/Assets/Editor/GodBlade.Editor.asmdef / Unity6/Assets/_Project/Scripts/Data/GodBlade.Data.asmdef / Unity6/Assets/_Project/Scripts/Runtime/GodBlade.Runtime.asmdef 각자 내용 정상

• §B. Unity.ResourceManager 참조 유지 (CS0246 재발 방지)

— Runtime asmdef line 7 / Editor asmdef line 9 변경 없음 확인

• §C. InternalsVisibleTo("GodBlade.Editor") 단일 선언 유지 (CS0579 재발 방지)

— TranscendentStageSO.cs:22 외 중복 grep 결과 0건

• §D. Sprint 00 Smoke Test 통과 유지

— 빈 씬에 SmokeTester 컴포넌트 붙이고 Play → 콘솔 [Smoke] Loaded 200 stages. First: GT=120700001 HP=600000 출력 확인

• §E. 설계 3건 각주 추가 여부 (D1 해소)

— Sprint 01 W2 §9 CP9-5 각주 또는 별도 "네임스페이스 규약" 메모: "asmdef 이름=GodBlade.Editor, 네임스페이스=GodBlade.EditorTools" 1줄 존재

• §F. TSV 3종 실존 (designs/ 폴더)

— designs/transcendent_drop_table.tsv / transcendent_milestone_reward.tsv / transcendent_affix_pool.tsv 각각 존재

• §G. Sprint 01 W2 TodoWrite (PM 작성) 준비 완료

— PM이 Sprint 01 W2 킥오프 문서에 설계 §2/§3/§4/§5/§7/§8 기반 TodoWrite 10~12건 작성

§8. 권장 후속 조치 (버퍼 기간 ~ Sprint 01 W1 착수)

§8.1 버퍼 기간(D+2~D+13 = 2026-04-22 ~ 2026-05-03)에 선제 해소 권장 (2건)

1. D1 해소 — 설계 3건(sprint-01-w2-importer-design.md §9 CP9-5 / sprint-02-w2-prestige-tech-sketch.md §8.1 CP9-5 / sprint-03-idle-research.md §9.2)에 각주 1줄씩 추가

• 예: // NOTE: asmdef 파일명은 "GodBlade.Editor"이나, rootNamespace/네임스페이스는 "GodBlade.EditorTools"이다 (Sprint 00 scaffold 컨벤션 유지).
• 작업량 30분. 문서만 변경, 코드 무변경.

1. D6 해소 — PM에게 합본 체크리스트 1쪽 요청 (§9 총 38개 → 유니크 23개 정도)

• 스프린트별 서브셋 라벨 (W1/W2/Idle) 부착
• PR 머지 전 자체 체크 원칙 유지
• 작업량 1~2시간 (PM 영역)

§8.2 Sprint 01 W1 Day 1 (2026-05-04~06) 자연 흡수 가능 (4건)

1. D4 해소 — 3개 신규 Importer 파일 상단에 TSV 경로 상수 명시

   const string TSV_PATH = "designs/transcendent_drop_table.tsv";  // 각 Importer 별

1. D7 해소 — GodBlade.Tests.Editor.asmdef 신설 시 references 에 처음부터 5종 포함: UnityEngine.TestRunner, UnityEditor.TestRunner, GodBlade.Data, GodBlade.Runtime, GodBlade.Editor
2. D8 검증 — Sprint 02 W2 착수(Sprint 02 W1 말미) 전 PrestigeCalculator.BuildSummary 필드 리스트 확정. 현 시점엔 Sprint 01 W2 범위 외 — 체크리스트 추적만
3. D9 노트 — Sprint 03 착수 시점에 해당. 현 시점엔 메모 수준

§8.3 그대로 둬도 되는 건 (문서 주석만, 3건)

1. D2 — test-framework 버전 불일치는 Unity 6 builtin 정책. 기능 호환.
2. D3 — URP 17.0.3 → 17.4.0 upgrade는 builtin 정책. 호환.
3. D5 — Tests.Editor.asmdef 미존재는 Sprint 01 W2 범위 내 신설 예정. 정상.

§8.4 PM·game-designer 에스컬레이션 권장

• PM에게:
• D6 합본 체크리스트 작성 요청
• Sprint 01 W2 TodoWrite에 "§7 Go/No-Go 체크 7개"를 D+0 킥오프 블록에 포함
• Sprint 02 W2 D-2 시점 "D8/D9 재확인 태스크" 1건 예약
• game-designer에게:
• D8 관련 prestige_items.tsv (Sprint 02 W1 산출물) 의 stat_key 컬럼에 IdleRateMul 해당 항목 존재 여부 확인 요청 (스펙 §3.2 C 방치 드립 수식 일관성)

§9. 결론 (1줄)

2026-05-04 Sprint 01 W2 킥오프 GO. P0 블로커 없음, Sprint 00 회귀 2건 방어 레이어 실사 확인. 버퍼 2주 동안 D1/D6 문서 정돈 2건만 선제 해소 권장.

§10. 감사 메타

• 감사 파일 수: Unity6/ 하위 asmdef 3 + manifest 2 + SO 2 + Importer 1 + Runtime 1 + AddressableAssetsData 그룹 확인 = 읽기 11건
• 설계 문서 교차: 3건 (v1.0 APPROVED 각)
• drift 총 9건 (P0=0, P1=4, P2=4, P3=1)
• 코드 수정: 0건 (읽기 전용 원칙 준수)
• 보고서 생성 Write 호출: 1회 (본 파일)
• 감사 소요 시간: 약 40분
• 차기 감사 예정: Sprint 01 W2 종료 D+14 (2026-05-17) — 실구현물 vs 설계 drift 재확인