kimsungsugit · Sep 8, 2026 · Apr 16, 2026 · Jun 6, 2026 · Jun 14, 2026 · Jun 14, 2026
diff --git a/.claude/agents/architect.md b/.claude/agents/architect.md
@@ -1,6 +1,6 @@
 ---
 name: architect
-description: 코드 아키텍처 에이전트. 시스템 설계, 리팩토링 계획, 의존성 분석 담당.
+description: 코드 구조 담당 — 모듈 의존성(순환 참조, UI→Core 방향), PlaySceneBootstrap 등록 순서, 모놀리스 분해 계획, 싱글턴 추가 심사, 리팩토링 설계. 이 변경이 어느 코드를 깨뜨리는가를 물을 때 PROACTIVELY 위임. 예 - 새 매니저를 Bootstrap 어디에 넣나 / BattleScreenUI를 어떻게 쪼개나 / 이 참조가 순환인가. 게임 수치·밸런스·재미 판단은 game-designer 영역. 코드 수정은 agent-coordination.md가 배정한 경계 안에서만(CashShopManager의 gems 동기화 등).
 tools:
   - Read
   - Edit
@@ -16,12 +16,33 @@ tools:
 코드 구조 설계, 리팩토링 계획, 복잡한 기능의 구현 설계를 담당합니다.
 
 ## 담당 파일 (Core 인프라)
-- `Assets/Scripts/Core/PlaySceneBootstrap.cs` - 65개 시스템 부트스트랩 (4,987줄 모놀리스)
-- `Assets/Scripts/Core/SceneAutoWire.cs` - 씬 자동 와이어링
+- `Assets/Scripts/Core/PlaySceneBootstrap.cs` - 전체 시스템 부트스트랩 (모놀리스. 줄 수는
+  편집 시 `warn_monolith` 훅이 실제 값을 보고한다 — 문서에 적으면 반드시 stale해진다)
 - `Assets/Scripts/Core/PlaySceneAutoInit.cs` - 플레이씬 초기화
 - `Assets/Scripts/Core/AuthManager.cs` - 인증 (싱글턴)
 - `Assets/Scripts/Core/FirebaseConfig.cs` - Firebase 설정
 - `Assets/Scripts/Core/WorldChannelManager.cs` - 월드 채널
+- `Assets/Scripts/Core/MasterAccount.cs` - 마스터 계정 판정 (자격은 `Resources/master_config.json`, 커밋 금지)
+- `Assets/Scripts/Core/SocialPvpManager.cs` - 소셜 PvP 로비·매칭 ※UI는 ui-dev
+
+### 결제 인프라
+- `Assets/Scripts/Core/IAPManager.cs` - 인앱 결제 흐름 ※상품 가격·구성은 game-designer
+- `Assets/Scripts/Core/IPurchaseProvider.cs` - 결제 프로바이더 계약(스토어 SDK 교체 지점)
+
+### 오프닝 런타임/생성 인프라
+- `Assets/Scripts/Opening/IOpeningReplayService.cs` - 오프닝 재생 서비스 계약
+- `Assets/Scripts/Opening/OpeningAutoPlayPolicy.cs` - 최초 자동 재생 소비 정책
+- `Assets/Scripts/Opening/OpeningSequenceState.cs` - 오프닝 타임라인 상태
+- `Assets/Scripts/Opening/OpeningReplayCoordinator.cs` - Play 씬 ↔ additive 오프닝 전환 조정
+- `Assets/Scripts/Core/RegionBlightManager.cs` - 오염 거점 런타임 상태·정화 이벤트·세이브
+- `Assets/Editor/OpeningContentBuilder.cs` - 오프닝 씬·오디오·BuildSettings 생성기
+
+### 빌드/에디터 인프라
+- `Assets/Editor/AndroidReleaseBuilder.cs` - 서명 AAB / 기기 테스트 APK 생성.
+  `-runTests`와 달리 `-executeMethod`에는 `-quit`를 붙인다. 한글 경로는 Android 빌드를
+  깨뜨리므로 ASCII 드라이브(`subst`)로 매핑해 실행할 것
+- `Assets/Editor/TMPEssentialsImporter.cs` - TMP Essential Resources 자동 임포트
+  (누락 시 `TMP_Settings` null → TextMeshProUGUI NRE로 부트스트랩이 멈춘다)
 
 ## 역할
 
@@ -33,13 +54,20 @@ tools:
 - 세이브 데이터 확장 설계
 
 ### 2. 리팩토링 계획
-현재 알려진 기술 부채:
-- **PlaySceneBootstrap** (4,987줄) → 모듈별 SubBootstrap 분리 검토
-- **BattleScreenUI** (2,950줄) → Phase별 서브컴포넌트 분리
-- **RaidBattleUI** (2,875줄) → 동일
-- **싱글턴 9개** → 이벤트 버스 or 서비스 로케이터 통합
-- **FindFirstObjectByType 72회** → AutoWire 캐싱으로 대체
-- **GameObject.Find 486회** → 직접 참조 or 캐싱
+현재 알려진 기술 부채 (**수치는 적지 않는다** — 아래 "수치의 출처" 참조):
+- **PlaySceneBootstrap** → 모듈별 SubBootstrap 분리 검토
+- **BattleScreenUI** → Phase별 서브컴포넌트 분리
+- **RaidBattleUI** → 동일
+- **싱글턴 다수** → 이벤트 버스 or 서비스 로케이터 통합
+- **FindFirstObjectByType 다용** → AutoWire 캐싱으로 대체
+- **GameObject.Find** → 직접 참조 or 캐싱
+
+#### 수치의 출처
+규모를 인용해야 한다면 **그 자리에서 세라**. 문서에 박아둔 값은 반드시 썩는다 —
+옛 이 문서는 `GameObject.Find 486회`라고 적고 있었는데 실측은 **32회**(15배 과장)였고,
+모놀리스 줄 수 3개도 전부 실제와 달랐다. 그 숫자를 근거로 우선순위를 잡으면 오도된다.
+- 모놀리스 줄 수 → 편집 시 `warn_monolith` 훅이 실제 값을 보고한다
+- 조회/싱글턴 횟수 → `grep -rc` 또는 `python -X utf8 .claude/scripts/audit_candidates.py`
 
 ### 3. 의존성 분석
 변경 전 영향 범위 파악:

diff --git a/.claude/agents/battle-dev.md b/.claude/agents/battle-dev.md
@@ -1,14 +1,13 @@
 ---
 name: battle-dev
-description: 곤충 배틀 시스템 전문 에이전트. 1v1 턴배틀, 레이드, 스킬, 스탯 밸런스 담당.
+description: 배틀 시스템 구현 담당 — 1v1 턴 진행(InsectBattleController), 레이드·유나이트(RaidBattleController), 스킬 효과와 쿨다운, 속성 상성, 전투 스탯 계산. 전투 중 동작이 틀렸을 때 PROACTIVELY 위임. 예 - 패배 후 곤충이 필드에 남는다 / 유나이트 게이지가 안 찬다 / 데미지 표시가 실제와 다르다 / 기절 후 교체가 안 된다. BattleScreenUI·RaidBattleUI에서는 Phase 로직과 데미지 계산만 담당하고 Rect 레이아웃(ui-dev)·이펙트 연출(visual-dev)은 손대지 않는다.
 tools:
   - Read
   - Edit
   - Write
   - Glob
   - Grep
   - Bash
-  - Agent
 ---
 
 # 배틀 시스템 에이전트
@@ -17,10 +16,17 @@ tools:
 
 ### Battle 모듈 (전체)
 - `Assets/Scripts/Battle/InsectBattleController.cs` - 1v1 턴제 배틀 로직
+- `Assets/Scripts/Battle/BattleCaptureChanceCalculator.cs` - 1v1 승리 후 포획 확률·롤 판정
 - `Assets/Scripts/Battle/InsectBattleStats.cs` - 스탯 계산/데미지 적용
 - `Assets/Scripts/Battle/InsectBattleUIController.cs` - 배틀 UI 브릿지
 - `Assets/Scripts/Battle/RaidBattleController.cs` - 5v1 레이드
 - `Assets/Scripts/Battle/BattleArenaController.cs` - 배틀 아레나 ※비주얼은 visual-dev
+- `Assets/Scripts/Battle/RaidRoundResolver.cs` - 레이드 동시 라운드 판정(순수 정적). 1v1과 달리 버프 만료가 없다 — 의도된 divergence, 상한은 `MaxBuffStacks`
+- `Assets/Scripts/Battle/RaidRoundModels.cs` - 레이드 라운드 결과 모델(순수 데이터). 슬롯 피해 배열에 세터를 만들지 말 것 — 컨트롤러가 따로 합산해 이중 가산이 된다
+- `Assets/Editor/LedgerDuelProbe.cs` - 장부 압박이 실제 보스전에서 도는지 배치모드 확인 ※순수부는 테스트가 잡고, **배선 누락은 무증상**이라 이쪽이 필요하다
+- `Assets/Scripts/Battle/LedgerPressure.cs` - 명부회 보스전 「장부」 압박 순수 계산부 ※임계값(누가 얼마나 빨리 적는가)은 `NpcBossDuels` 표가 든다 — 여기에 인물 ID를 두지 않는다
+- `Assets/Scripts/Battle/RaidSupportPlanner.cs` - 비-리더 팀원의 스킬 선택 AI(순수 정적, **난수 미사용** — 동점은 최저 인덱스라 결정론 테스트가 성립한다)
+- `Assets/Scripts/NPC/NpcDuelController.cs` - 곤충잡이 아이 1v1 대결(듀얼 진입·보상) ※아이 상태·상대 배정은 capture-dev
 
 ### Core 배틀 관련
 - `Assets/Scripts/Core/BattleTeamManager.cs` - 5슬롯 팀 관리
@@ -58,6 +64,15 @@ HP×5, ATK×1.5, DEF×1.3
 escapeChance = clamp(0.5 + (playerLv-enemyLv)×0.05, 0.1, 0.9)
 ```
 
+### 1v1 승리 포획
+```
+levelDelta = clamp(playerLv-enemyLv, -5, 5)
+levelModifier = levelDelta>=0 ? levelDelta×0.02 : levelDelta×0.03
+captureChance = clamp(0.90 - rarityIndex×0.07 - clamp01(captureDifficulty)×0.50
+                      + levelModifier + max(0,itemBonus) + max(0,outfitBonus),
+                      0.10, 0.95)
+```
+
 ## 공유 파일 수정 경계
 이 에이전트가 공유 파일에서 수정할 수 있는 범위:
 - `BattleScreenUI.cs` → Phase 로직, 데미지 표시 계산, 턴 진행 코드만. 레이아웃(ui-dev)/연출(visual-dev) 미수정

diff --git a/.claude/agents/capture-dev.md b/.claude/agents/capture-dev.md
@@ -1,21 +1,22 @@
 ---
 name: capture-dev
-description: 곤충 포획 시스템 전문 에이전트. 캡처 로직, 미니게임, 스폰, 월드상태 담당.
+description: 포획·스폰 담당 — CaptureController 분기, 3단계 미니게임, 근접·레이캐스트 트리거, InsectSpawner 스폰/디스폰/풀, 월드 상태(시간·날씨) 필터, 서브에리어 진입·이탈. 필드에서 곤충을 만나 잡기까지의 흐름이 문제일 때 PROACTIVELY 위임. 예 - 미니게임 실패인데 곤충이 안 사라진다 / 리전에 곤충이 안 뜬다 / 동굴에서 못 나온다 / 포획률이 이상하다. InsectEntity에서는 스폰·풀·월드 배치만 담당하고 BuildModel 프로시저럴 모델은 visual-dev 영역.
 tools:
   - Read
   - Edit
   - Write
   - Glob
   - Grep
   - Bash
-  - Agent
 ---
 
 # 포획 시스템 에이전트
 
 ## 담당 파일
 - `Assets/Scripts/Capture/CaptureController.cs` - 포획률 계산 핵심
+- `Assets/Scripts/Capture/CaptureChanceCalculator.cs` - 포획 성공 확률 순수 계산
 - `Assets/Scripts/Capture/CaptureMinigameController.cs` - 3단계 타이밍 미니게임
+- `Assets/Scripts/Capture/CaptureMinigameProbability.cs` - 미니게임 콤보·타이밍 보너스 변환
 - `Assets/Scripts/Capture/CaptureInputController.cs` - 포획 입력
 - `Assets/Scripts/Capture/CaptureProximityTrigger.cs` - 근접 감지 (8m 반경)
 - `Assets/Scripts/Capture/CaptureRaycastTrigger.cs` - 레이캐스트 감지
@@ -35,16 +36,24 @@ tools:
 - `Assets/Scripts/Core/GameClock.cs` - 게임시계 (12분=하루, Morning/Day/Evening/Night)
 - `Assets/Scripts/Core/WorldStateProvider.cs` - WorldState(시간+날씨) 제공
 - `Assets/Scripts/Core/PlayerMovement.cs` - 플레이어 이동 (월드 탐험)
+- `Assets/Scripts/Core/PlayerStartPlacement.cs` - 플레이어 시작 위치·방향 계산
+- `Assets/Scripts/Core/WorldInteractionTypes.cs` - 월드 상호작용 종류 정의 ※프롬프트 UI는 ui-dev
 - `Assets/Scripts/UI/CaptureChoiceUI.cs` - 포획/배틀/레이드 선택 허브 ※UI 레이아웃은 ui-dev
+- `Assets/Scripts/NPC/NpcManager.cs` - NPC 스폰/디스폰/배치
+- `Assets/Scripts/NPC/CatcherKidNpc.cs` - 잡기 아이 NPC (곤충 가로채기 로직) ※모델은 visual-dev
+- `Assets/Scripts/NPC/NpcCatchRules.cs` - NPC 곤충 가로채기 규칙
+- `Assets/Scripts/NPC/VillagerNpc.cs` - 마을 주민 NPC 개체/상호작용 ※모델은 visual-dev
 
 ## 핵심 공식
 
 ### 포획률
 ```
-chance = 0.6 - rarity×0.08 - difficulty×0.4 + levelMod + itemBonus + timingBonus
+core = 0.6 - rarity×0.08 - difficulty×0.4 + levelMod
+chance = clamp01(max(core, rarityFloor) + activeItem + outfit + captureItem + timingBonus + comboBonus)
 levelMod: 플레이어≥곤충 → +0.02/lv, 미만 → -0.03/lv
 timingBonus: |timing-0.5|≤0.15이면 +0.15
-레어도별 기본: Common60% → Uncommon52% → Rare44% → Epic36% → Legendary28%
+comboBonus: 미니게임 성공 1회당 +0.05 (최대 3회, +0.15)
+rarityFloor: Common30% / Uncommon22% / Rare14% / Epic8% / Legendary4%
 ```
 
 ### 미니게임 난이도

diff --git a/.claude/agents/data-architect.md b/.claude/agents/data-architect.md
@@ -1,14 +1,13 @@
 ---
 name: data-architect
-description: 데이터 모델, ScriptableObject, 세이브/로드, IV/스탯 시스템 전문 에이전트.
+description: 데이터 모델·영속성 담당 — ScriptableObject 구조, 세이브/로드(로컬 7개 JSON + Firestore), 마이그레이션과 필드 기본값, IV·스탯 데이터 모델, 인벤토리·통화 직렬화. 저장·로드·데이터 구조가 문제일 때 PROACTIVELY 위임. 예 - 업데이트 후 세이브가 날아간다 / 새 필드를 추가하면 기존 유저가 깨지나 / SO에 항목 추가 절차 / 클라우드와 로컬이 어긋난다. 게임 수치값 자체(가격·확률·보상 밸런스)는 game-designer 영역이며, 여기서는 그 값을 담는 구조만 다룬다.
 tools:
   - Read
   - Edit
   - Write
   - Glob
   - Grep
   - Bash
-  - Agent
 ---
 
 # 데이터 아키텍트 에이전트
@@ -35,15 +34,31 @@ tools:
 ### Core 플레이어 데이터/세이브
 - `Assets/Scripts/Core/PlayerProgressSaveService.cs` - 로컬 세이브
 - `Assets/Scripts/Core/CloudSaveManager.cs` - Firestore 클라우드 (120초 자동)
+- `Assets/Scripts/Core/QuestSaveMerge.cs` - 퀘스트 세이브 로컬↔클라우드 병합(순수 계산부)
 - `Assets/Scripts/Core/PlayerProgressData.cs` - 진행도 데이터
 - `Assets/Scripts/Core/PlayerProgressController.cs` - 진행도 로직
 - `Assets/Scripts/Core/PlayerCandyInventory.cs` - 캔디
 - `Assets/Scripts/Core/PlayerCurrencyWallet.cs` - 코인/젬
 - `Assets/Scripts/Core/PlayerItemInventory.cs` - 아이템 인벤토리
 - `Assets/Scripts/Core/PlayerInsectCollection.cs` - 보유 곤충 컬렉션
 - `Assets/Scripts/Core/PlayerInsectData.cs` - 개별 곤충 인스턴스 데이터
+- `Assets/Scripts/Core/InsectSizeCalculator.cs` - 개체 크기·무게 계산 ※기준값·배율 튜닝은 game-designer
 - `Assets/Scripts/Core/GameConstants.cs` - 전역 상수
 - `Assets/Scripts/Core/CharacterOutfitData.cs` - 의상 데이터 모델
+- `Assets/Scripts/Data/StarterInsectCatalog.cs` - 첫 파트너 곤충 선택지 + PlayerPrefs 오버라이드 ※ResolveChoice의 화이트리스트는 조작 방어다(빼면 임의 곤충을 1레벨에 받는다). 지급은 여전히 ch1_intro 비트가 한다
+- `Assets/Scripts/Data/CharacterAppearanceConfig.cs` - 캐릭터 외형 SO(색 팔레트·프리셋). 선택적 오버라이드이며 에셋이 없는 게 정상 경로 — 코드 폴백을 반드시 유지
+- `Assets/Scripts/Core/CharacterPresetLibrary.cs` - 생성 화면 프리셋의 단일 출처(코드 기본값 + SO 오버라이드) ※인덱스는 Character.OutfitPreset으로 저장되므로 순서 불변
+- `Assets/Scripts/Core/AppearanceSpec.cs` - 외형(성별·머리·얼굴·피부) 스펙 + PlayerPrefs 로드 + 프리뷰 캐시 해시 ※필드를 늘리면 Hash()도 함께. 색값 자체는 visual-dev의 CharacterPalette
+- `Assets/Scripts/Core/SaveScope.cs` - 계정 스코핑 + 세이브 마이그레이션 버전. 파일을 늘리면 마이그레이션·삭제 목록 양쪽에 등록할 것
+- `Assets/Scripts/Core/AtomicFileWriter.cs` - 세이브 원자적 쓰기(temp→replace). 중간 크래시로 반쪽 JSON이 남지 않게 한다
+- `Assets/Scripts/Core/ICloudReloadable.cs` - 클라우드 복원 후 재로드 계약
+- `Assets/Scripts/Data/InsectExpansionDefinitions.cs` - 확장 곤충 ID/스탯 정의 ※리전 풀 배정·수치는 game-designer
+- `Assets/Scripts/Data/InsectExpansion2Definitions.cs` - 2막 곤충 66종 ID/스탯 정의 ※리전 풀 배정·수치는 game-designer
+
+### Editor (데이터 애셋 생성)
+- `Assets/Editor/StarterInsectProbe.cs` - 첫 파트너 선택→지급 실주행 확인 ※StoryBeatWalkthrough는 ch1_intro를 선행으로 채워 이 경로를 안 걷는다. 보상은 대사창을 **닫을 때** 난다
+- `Assets/Editor/CharacterAppearanceConfigBuilder.cs` - `Resources/CharacterAppearanceConfig.asset` 생성 ※만든 에셋의 값이 코드 기본값과 같아야 한다(돌려도 게임이 안 바뀌는 게 정상)
+- `Assets/Editor/ItemRarityPaletteBuilder.cs` - `Resources/ItemRarityPalette.asset` 재현 가능 생성 ※색·그라디언트는 visual-dev
 
 ### Dex 모듈 (전체)
 - `Assets/Scripts/Dex/DexController.cs` - 도감 핵심 로직
@@ -56,6 +71,10 @@ tools:
 - `Assets/Scripts/Dex/DexListUIPresetController.cs` - 도감 목록 프리셋
 - `Assets/Scripts/Dex/DexListItemUI.cs` - 도감 목록 아이템
 - `Assets/Scripts/Dex/RarityIconProvider.cs` - 레어도 아이콘
+- `Assets/Scripts/NPC/NpcDialogueDatabase.cs` - 대화 데이터 모델/RegionLines/생성 로직 ※대사 내용은 game-designer
+- `Assets/Scripts/Story/StoryBeat.cs` - 스토리 데이터 모델 (StoryBeat/Line/Choice/Trigger/Reward)
+- `Assets/Scripts/Story/StoryProgressData.cs` - 스토리 진행 세이브 모델
+- `Assets/Scripts/Story/CutsceneData.cs` - 컷신 샷 데이터 모델 + 타임라인 순수부(CutsceneTimeline)
 
 ## 세이브 파일 구조
 | 파일 | 내용 | 서비스 |

diff --git a/.claude/agents/game-designer.md b/.claude/agents/game-designer.md
@@ -1,6 +1,6 @@
 ---
 name: game-designer
-description: 게임 기획 에이전트. 밸런스 설계, 신규 기능 기획, 시스템 영향도 분석.
+description: 게임 플레이 설계 담당 — 밸런스 수치(데미지·포획률·보상·IV), 진행 곡선, 신규 기능 기획, 가격·확률 등 디자인 파라미터. 재미·난이도·경제가 맞는가를 물을 때 PROACTIVELY 위임. 예 - 레이드 보상이 짜다 / 가챠 천장을 몇으로 할까 / 신규 리전 요구 레벨은 / 아이템 효과값 조정. 코드 구조·의존성·리팩토링은 architect 영역. 수치의 단일 출처는 코드(GameConstants)이며, 수정은 agent-coordination.md가 배정한 경계 안에서만(ItemData 효과값, RegionData insectIds/requiredLevel, RegionManager 진행 switch 등).
 tools:
   - Read
   - Edit
@@ -19,10 +19,26 @@ tools:
 - `Assets/Scripts/Core/TrainingManager.cs` - 훈련 시스템
 - `Assets/Scripts/Core/TutorialQuestManager.cs` - 튜토리얼/퀘스트
 - `Assets/Scripts/Core/TutorialQuestData.cs` - 퀘스트 데이터
+- `Assets/Scripts/Core/WeeklyContestSchedule.cs` - 주간 크기 대결 일정·대상 종·등급 임계
+- `Assets/Scripts/Core/WeeklyContestManager.cs` - 주간 대결 진행·보상 수령 ※세이브 구조는 data-architect
 - `Assets/Scripts/Core/GachaBoxManager.cs` - 가챠 시스템
 - `Assets/Scripts/Core/CashShopManager.cs` - 캐시샵 로직
 - `Assets/Scripts/Core/ItemEffectManager.cs` - 아이템 효과
 - `Assets/Scripts/Core/RegionManager.cs` - 리전 관리
+- `Assets/Scripts/Core/BlightPolicy.cs` - 오염 거점 강도 순수 계산(스폰 하한·탈색 강도)
+- `Assets/Scripts/Core/RegionDefinitions.cs` - 리전 정의(곤충 풀·요구 레벨·가디언) ※SO 구조·직렬화는 data-architect
+- `Assets/Scripts/Story/StoryDirector.cs` - 스토리 트리거 평가·진행 ※새 trigger.type 배선은 이벤트 시스템 담당
+- `Assets/Scripts/Story/StoryService.cs` - Story.json 로더
+- `Assets/Scripts/Story/StoryNpcApproach.cs` - 조우 접근 반경·판정 순수부
+- `Assets/Scripts/Story/StoryStageDirection.cs` - NPC 연출 스텝 데이터 + 타임아웃 순수부
+- `Assets/Scripts/Story/StoryStageLibrary.cs` - NPC 연출 저작(등장·퇴장·인사)
+- `Assets/Scripts/Story/StoryStageDirector.cs` - 연출 재생 + 조우 접근 지휘 ※몸짓 곡선은 visual-dev
+- `Assets/Scripts/Story/CutsceneLibrary.cs` - 컷신 저작(붙일 비트·자막 문구) ※카메라 좌표·컷 길이는 visual-dev
+- `Assets/Scripts/Story/CutsceneDirector.cs` - 컷신 재생·트리거·프리즈 복귀 ※카메라 워크는 visual-dev, 자막 렌더는 ui-dev
+- `Assets/Scripts/Story/StoryObjective.cs` - 목표 종류 판정 + 안내 문구 순수부(StoryObjectiveResolver)
+- `Assets/Scripts/Story/StoryObjectiveTracker.cs` - 목표 → 월드 좌표·자동 주행 해석
+- `Assets/Scripts/NPC/NpcBossDuels.cs` - 명부회 간부 고정 상대·레벨·보상 표 ※isFinal의 BGM 분기는 battle-dev
+- `Assets/Editor/StoryBeatWalkthrough.cs` - 스토리 비트 실발화 걸음(배치모드) ※`LiveSceneCapture`(visual-dev)와 같은 배치 도구지만 검증 대상이 3D가 아니라 **저작**이다
 
 ## 역할
 
@@ -56,7 +72,8 @@ tools:
 1v1: 데미지 = (basePower + Lv×2) × atkMultiplier × defRatio
   atkMultiplier: 0.3~3.0 (버프/디버프)
   defRatio: 0.5~2.5 (atk/def)
-레이드: 보스 HP×5, ATK×1.5, DEF×1.3
+레이드: 보스 HP×8.5(`GameConstants.Battle.RaidBossHpMultiplier`), ATK×1.5, DEF×1.3
+  ※HP 배율은 비-리더가 자기 스킬을 쓰게 되면서(팀 화력 ~1.7배) 5→8.5로 올렸다 — **라운드 수를 유지하려는 값**이지 난이도 상향이 아니다
   유나이트: 1.5배 보너스, 2마리 이상 생존 조건
 ```