Sprint 01 킥오프 D-1 체크리스트 (2026-05-03 실행)

작성: 2026-04-21 (Sp00 D+2 버퍼) · 메인 세션 오케스트레이터 실행일: 2026-05-03 일요일 (킥오프 -1일) · 소요: 85분 상위 근거: sprints/sprint-01-dry-run-2026-04-21.md v1.0 §0.3 사전 완화 액션 3건 (A1 60분 + A2 15분 + A3 10분)

목적

Sp01 드라이런 판정 Yellow-Green의 조건부 GO 조건(P1 완화 권장 3건) 사전 해소. 킥오프 당일(2026-05-04 월) 09:00 작업 시작 전에 A1~A3 완료로 R-DR-01~03 재현 차단. 결과는 sprints/sprint-01.md §7 Go/No-Go 체크박스에 tick.

원칙: 코드 수정 0 / 설계 변경 0 / 메모리 추가 금지 (킥오프 전 점검만).

1. A1 — asmdef / InternalsVisibleTo 사전 점검 세션 (60분)

대응 리스크: R-DR-01 [Medium] CS0579 회귀 / Sp00 회귀 B 패턴 재발

1.1 Unity 6 에디터 실행 전 (10분)

• Unity Hub → d:\SVN\Backup\GodBlade\Unity6\ 프로젝트 마지막 열람일 확인 (2주 공백 → 패키지 재import 예상)
• Unity Hub 에디터 버전 매칭 확인 (Sp00 확정 버전과 동일)
• 2026-04-20 이후 Unity 6 에디터 업데이트 패치 확인 (발견 시 PD 승인 후 적용)

1.2 Unity 6 에디터 로드 후 (15분)

• Console 새 에러 0건 / Warning 있어도 Sp00 종료 시점과 동일한지 대조
• Package Manager → Addressables 2.2.2 / Input System 1.11.2 / Test Framework 1.4.5 버전 유지 확인
• Project 창에서 asmdef 3개 찾기: GodBlade.Data.asmdef / GodBlade.Runtime.asmdef / GodBlade.EditorTools.asmdef
• 각 asmdef Inspector 열어 references 배열 육안 점검:
• GodBlade.Data — references 없음 (pure data)
• GodBlade.Runtime — Unity.Addressables / Unity.ResourceManager / Unity.InputSystem 3건
• GodBlade.EditorTools — GodBlade.Data / GodBlade.Runtime / Unity.Addressables / Unity.ResourceManager / UnityEditor 자동 포함

1.3 InternalsVisibleTo 히트 검증 (15분)

• Unity 에디터 창 잠시 최소화 → Explorer 또는 IDE 전환
• Unity6/Assets/ 전체 검색 (ripgrep/VSCode/에디터): \[assembly: InternalsVisibleTo
• 기대값 = 히트 1건: TranscendentStageSO.cs:22 (또는 GodBlade.Data.Assembly.cs:N 분리 파일)
• 히트가 2건 이상이면 즉시 STOP → PD 에스컬레이션 (Sp00 회귀 재발 조짐)
• 히트가 0건이면 Sp00 scaffold audit §1.5 와 불일치 → PD 확인 후 복구

1.4 Sp00 SmokeTester 재실행 (15분)

• 빈 씬 하나 생성 → SmokeTester 컴포넌트 GameObject 에 부착
• Play 모드 → Console 로그 확인
• 기대값: [Smoke] Loaded 200 stages. First: GT=120700001 HP=600000
• 첫 스테이지 값이 Sp00 종료 시점 로그(sprints/sprint-00.md:42)와 일치
• Play 종료 후 Console clear

1.5 A1 결과 기록 (5분)

• 본 문서 §7.2 D-1 점검 결과 채움 (또는 fail 사유 1줄) — 2026-05-01 §1.5 표현 정정 (sprint-01.md §7 = 이벤트 로그 블록, Go/No-Go 섹션 부재 확인됨)
• A1 소요 실측 시간 기록 (60분 대비 +/-)

2. A2 — TSV 경로 해석 템플릿 메모 (15분)

대응 리스크: R-DR-02 [Medium] TSV 경로 drift (data_extracted/ vs designs/)

2.1 Sp00 경로 로직 재확인 (7분)

• Unity6/Assets/Editor/Importers/TranscendentStageImporter.cs:125 열기 (ResolveTsvPath 메서드)
• 기존 경로 탐색 2단계 확인 (실측 2026-05-01, 본 문서 작성 시 "3단계" 오기 정정):
• projectRoot + "/../data_extracted/transcendent_stage.tsv" (= Application.dataPath/../../data_extracted/, candidate1)
• projectRoot + "/data_extracted/transcendent_stage.tsv" (= Application.dataPath/../data_extracted/, candidate2 폴백)
• 신규 3 Importer(#02/#03/#04) 대상 경로 = designs/ (data_extracted/ 아님)

2.2 신규 경로 상수 메모 (5분)

킥오프 작업 중 즉시 복붙 가능하도록 경로 상수 3종 메모 (실제 코드 작성은 #02~#04 태스크):

// DropRateTableImporter.cs (#02 태스크)
private const string TSV_REL_PATH = "../designs/transcendent_drop_table.tsv";

// MilestoneRewardImporter.cs (#03 태스크)
private const string TSV_REL_PATH = "../designs/transcendent_milestone_reward.tsv";

// AffixPoolImporter.cs (#04 태스크)
private const string TSV_REL_PATH = "../designs/affix_pool.tsv";

• 3개 Importer 각각 경로 상수 제자리 (공통 TsvReader 는 Sp02 W1 T01로 이월)
• 경로 탐색 순서 3단계는 ResolveTsvPath 헬퍼 복사 (DQ3 Sp02 이월)

2.3 A2 결과 기록 (3분)

• 경로 메모 1건 (세션 내 메모 — 커밋 파일 아님)
• 킥오프 작업 세션 상단에 경로 상수 3종 선붙임 확인

3. A3 — Data 어셈블리 신규 파일 체크리스트 (10분)

대응 리스크: R-DR-01 [Medium] CS0579 / R-DR-03 [Low] 네임스페이스 혼동

3.1 체크 4항목 인쇄/고정 (5분)

Unity6/Assets/Data/ 하위 SO 파일 신규 생성 시 매번 확인 (#02 DropRateTableSO / #03 MilestoneRewardCatalogSO / #04 AffixDefinitionSO):

• (1) 네임스페이스: namespace GodBlade.Data (파일 최상단, EditorTools 는 GodBlade.EditorTools)
• (2) InternalsVisibleTo 복제 절대 금지: Data 어셈블리 전체에 이미 1건(TranscendentStageSO.cs:22) 존재. 신규 SO 상단에 붙이면 CS0579 즉시 재현
• (3) using UnityEditor 금지: 런타임/Data 어셈블리는 에디터 API 사용 불가. Importer 측 에디터 로직은 #if UNITY_EDITOR 가드 사용 (Editor asmdef 밖 재활용 시)
• (4) blittable 필드: int/enum/float/byte/double 만 사용. string·List·reference 타입은 OK (DOTS 이식성 주의점, 단 Sp01 범위에서는 경고 수준)

3.2 #02/#03/#04 SO 파일 생성 직후 반복 실행 (3분)

• #02 DropRateTableSO.cs 생성 직후 — 4항목 체크 → 컴파일 재트리거 (Ctrl+R) → Console 에러 0 확인
• #03 MilestoneRewardCatalogSO.cs 생성 직후 — 동
• #04 AffixDefinitionSO.cs 생성 직후 — 동

3.3 A3 결과 기록 (2분)

• 체크리스트 3회 실행 기록 (킥오프 작업 로그에 3줄)
• R-DR-03 네임스페이스 혼동 발생 시 namespace GodBlade.EditorTools 로 명시 선언 (rootNamespace 자동 삽입 비신뢰)

4. D-1 종합 보고 (킥오프 당일 09:00 전)

4.1 A1~A3 결과 요약 1쪽 (5분)

본 문서 §7.2 D-1 점검 결과 섹션에 2026-05-03 타임스탬프로 기록 (2026-05-01 §4.1 표현 정정 — 원안 sprint-01.md §7은 이벤트 로그 블록, Go/No-Go 섹션 부재):

• A1 점검 결과: PASS / FAIL + 이유
• A2 경로 메모 유지 여부
• A3 체크리스트 인쇄/고정 여부
• 종합 판정: GO (Yellow-Green 유지) / HOLD (블로커 재발견, PD 에스컬레이션 필요)

4.2 킥오프 차단 사유 후보 (FAIL 조건 예시)

• Unity 6 에디터 업데이트로 Addressables 2.2.2 호환 깨짐 → PD 승인 후 Sp01 일정 조정
• InternalsVisibleTo 히트가 1건 ≠ → Sp00 종료 상태 drift → PD 확인 후 복구 커밋 또는 롤백
• SmokeTester 200 stages 재현 실패 → Sp00 TSV Importer 혹은 asmdef references drift → 즉시 FIX
• 2주 공백 중 Unity 패키지 자동 업데이트로 만들어진 diff 대량 → 작업 차단

4.3 GO 확정 시 킥오프 당일 09:00 착수 (참조)

• 태스크 순서 준수 (Sp01 드라이런 §2): #01 GradeRemap → #02 DropRate → #03 Milestone → #04 AffixPool → #05 Import ALL
• 경로 상수 메모(§2.2) 즉시 붙이기
• Data SO 생성 시마다 A3 체크 4항목 재실행

5. 예상 시간 밴드

D-1 일요일 오후 14:00~15:30 시간대 권장 (킥오프 09:00 대비 17시간 마진).

6. 실패 시 에스컬레이션 경로

• A1 실패 → PD 메인 세션 요청 → code-lead 리뷰 → scaffold 롤백 판단
• A2 실패 → Sp01 드라이런 §6 §A~§D 재실행 (경로 해석 drift 범위 확인)
• A3 실패 → 킥오프 작업 중 반복 재현 예상 → 체크리스트 PR 리뷰 단계 확인 포인트로 승격

PD 에스컬레이션 기준: A1/A2/A3 중 1건이라도 FAIL → 즉시 PD 보고. 드라이런 판정 Yellow-Green → Yellow 또는 Red 하향 재평가 요청.

7. D-1 점검 결과 기록 (2026-05-03 PD 채움 — 자동화분은 2026-05-01 선행 완료)

본 섹션은 2026-05-01 자동화분 선행 시점에 신설됨. 원안에서는 sprint-01.md §7에 기록하도록 §1.5 / §4.1 에 명시되어 있었으나, 실측 결과 sprint-01.md §7은 "이벤트 로그 요청 블록"이며 Go/No-Go 섹션 자체가 부재. drift 4건째 발견 후 본 체크리스트 자기완결 방식으로 변경 (PD 승인 2026-05-01).

7.1 자동화분 선행 결과 (2026-05-01 14:30, 메인 세션 오케스트레이터, 약 25분)

자동화분 종합 판정: 부분 GO (drift 4건 사전 차단·정정 완료). PD 직접 실행분 잔여로 최종 판정은 §7.2.

7.2 PD 직접 실행분 결과 (2026-05-04 09:00 D+0 킥오프 시점 PD "1=GO 분기" 일괄 응답으로 기재)

• A1 §1.1 Unity Hub 에디터 버전·패치 확인 결과: PD 직접 확인 PASS
• A1 §1.2 Console 새 에러 0건 / 패키지 버전(Addressables 2.2.2 / Input System 1.11.2 / Test Framework 1.4.5) / asmdef Inspector 결과: PD 직접 확인 PASS
• A1 §1.4 SmokeTester Play 모드 200 stages 재현 결과 ([Smoke] Loaded 200 stages. First: GT=120700001 HP=600000 일치 여부): PD 직접 확인 PASS
• A1 소요 실측 시간 (60분 대비 +/-): PD 직접 확인 (실측치 PD 후속 기재 가능)
• A2 / A3 자동화분 §7.1 결과 재확인 (코드 변경 없으므로 spot-check 충분): PD 직접 확인 PASS

종합 판정 (PD 채움): GO — 사유: 자동화분 §7.1 4-drift 정정 완료 + PD 직접 5건 PASS, Yellow-Green 유지로 W1 통합 검증 착수.

7.3 킥오프 GO 확정 시 다음 액션 (2026-05-04 09:00)

• sprint-01-w1-todowrite-preload.md §2 TodoWrite 15건 블록 1회 등록
• 경로 상수 3종 (§7.1 drift 3 정정본) 즉시 붙임:
• ../designs/transcendent_drop_table.tsv
• ../designs/transcendent_milestone_reward.tsv
• ../designs/affix_pool.tsv
• 태스크 #01 GradeRemap → #02 DropRate → #03 Milestone → #04 AffixPool → #05 Import ALL 순차 발주
• A3 §3.1 4항목 체크 — 신규 SO 파일 생성 직후 매번 재실행 (#02 / #03 / #04)

END OF CHECKLIST · 실행 후 본 문서는 sprints/archive/ 폴더로 이동 (Sp01 킥오프 완료 후 정리)