feat: batch wikify raw data into Master Archive and specialized categories

Processed 70+ files covering Skybound mechanics, Frontend mastery, and Business strategy.
2026-04-26 09:43:15 +09:00
parent 714e10c994
commit 7dc7e0436c
127 changed files with 3968 additions and 0 deletions
@@ -0,0 +1,116 @@
+# Skybound Vampire Survivors Loop and Stage Curve Preparation
+
+작성일: 2026-04-25 23:52 KST
+
+## 요청 요약
+
+- Skybound가 뱀파이어 서바이벌 계열 게임처럼 느껴지도록 재미 요소와 스테이지별 레벨 구조를 준비한다.
+- 단순히 적을 많이 내보내는 것이 아니라, 성장 선택, 밀도 상승, 진화 완성, 보스 체크포인트가 자연스럽게 이어지도록 만든다.
+
+## 핵심 방향
+
+Skybound는 탑다운 생존 슈터이지만, 기존 구조는 스테이지 시간이 짧고 보스 진입이 빨라 빌드가 완성되기 전에 전투가 끊기는 문제가 있었다. 뱀서류 재미를 만들려면 다음 루프가 안정적으로 반복되어야 한다.
+
+1. 초반: 첫 무기 선택 후 약한 적을 많이 처치하며 빠르게 1-2회 성장한다.
+2. 중반: 적 밀도와 엘리트 압박이 올라가며 광역/관통/방어 선택의 의미가 생긴다.
+3. 후반: 스웜과 미니보스가 들어오며 빌드 조합과 진화 무기가 필요해진다.
+4. 보스: 완성된 빌드가 제대로 작동하는지 검증한다.
+5. 다음 스테이지: 같은 빌드를 이어가되 적 밀도, 패턴, 보스 기믹이 상승한다.
+
+## 적용한 변경
+
+### 8스테이지 Survivor 프로필 추가
+
+`CombatTimeline.ts`에 `SURVIVOR_STAGE_PROFILES`를 추가했다. 각 스테이지는 아래 정보를 가진다.
+
+- 스테이지 이름
+- 스테이지 길이
+- 기본 난이도 배율
+- 동시 적 수 기준
+- 스폰 템포
+- 오프닝 웨이브
+- 압박 엘리트 웨이브
+- 스웜 웨이브
+- 클라이맥스 엘리트 웨이브
+- 미니보스 체크포인트
+
+### 스테이지별 구조
+
+- Stage 1 `First Contact`: 첫 무기와 기본 생존 학습
+- Stage 2 `Fast Lanes`: 빠른 적과 이동 압박
+- Stage 3 `Ruined Circuit`: 혼합 편대와 엘리트 압박
+- Stage 4 `Crossfire Grid`: 길막/라인 클리어 압박
+- Stage 5 `Magma Forge`: 고밀도 스웜 시작
+- Stage 6 `Storm Foundry`: 빌드 완성 요구
+- Stage 7 `Arcane Collapse`: 진화 무기 권장
+- Stage 8 `Final Singularity`: 완성 빌드 검증
+
+### 스테이지 시간 조정
+
+기존 Standard 스테이지는 약 165초부터 시작해 빌드업 시간이 부족했다. 새 구조에서는 Stage 1이 240초, Stage 8이 420초까지 증가한다.
+
+이렇게 하면 플레이어는 한 스테이지 안에서 다음 리듬을 경험할 수 있다.
+
+- 0-25%: 세팅과 첫 성장
+- 25-48%: 엘리트 압박
+- 48-72%: 스웜 압박
+- 72%-보스 전: 클라이맥스와 미니보스
+- 마지막 35초 전후: 보스전 진입
+
+### 스폰 밀도 조정
+
+- 적 하드캡을 56에서 76으로 올렸다.
+- 스웜 배치 단위를 6에서 8로 올렸다.
+- 기본 절차 스폰 간격을 96프레임에서 84프레임으로 줄였다.
+
+목표는 “가만히 있어도 클리어”가 아니라, 점점 밀려오는 압박을 움직임과 빌드 선택으로 해결하게 만드는 것이다.
+
+### Tac EXP 커브 조정
+
+바닥 EXP 젬을 다시 뿌리지는 않고, 처치 즉시 Tac EXP를 지급하는 현재 방향을 유지했다. 다만 뱀서류 성장 리듬을 만들기 위해 처치 경험치를 조정했다.
+
+- 일반 적: `+2 TAC`
+- 엘리트 적: `+10 TAC`
+- 미드보스: `+30 TAC`
+
+초기 요구 EXP는 `90`에서 `80`으로 낮췄다. 대신 레벨업 후 초과 EXP carryover는 25%만 유지해 연속 레벨업 폭주는 막는다.
+
+레벨 요구량 배율은 아래처럼 조정했다.
+
+- Level 1-4: `x1.34`
+- Level 5-8: `x1.42`
+- Level 9-14: `x1.52`
+- Level 15+: `x1.62`
+
+## 설계 의도
+
+이번 변경은 “Vampire Survivors의 재미”를 다음 요소로 해석했다.
+
+- 적은 점점 많아진다.
+- 플레이어는 더 자주 선택하고 강해진다.
+- 선택에는 빌드 방향성이 있다.
+- 중반 이후에는 광역, 관통, 방어, 기동 중 최소 하나가 부족하면 압박을 느낀다.
+- 보스는 단절된 엔딩이 아니라 빌드 검증 구간이다.
+- 다음 스테이지는 새 게임이 아니라 이전 빌드의 확장 시험이다.
+
+## 수정 파일
+
+- `/Volumes/Data/project/Antigravity/Skybound/src/features/game/config/CombatTimeline.ts`
+- `/Volumes/Data/project/Antigravity/Skybound/src/features/game/systems/SpawnerSystem.ts`
+- `/Volumes/Data/project/Antigravity/Skybound/src/features/game/systems/CombatSystem.ts`
+- `/Volumes/Data/project/Antigravity/Skybound/src/features/game/systems/ProgressionSystem.ts`
+- `/Volumes/Data/project/Antigravity/Skybound/src/features/game/systems/types.ts`
+- `/Volumes/Data/project/Antigravity/Skybound/src/features/game/store/useGameStore.ts`
+
+## 검증
+
+- `npm run build` 성공
+- Vite 경고: `/sprites/player.png referenced in /sprites/player.png didn't resolve at build time`
+- 위 경고는 기존 런타임 경로 경고이며 이번 변경으로 인한 빌드 실패는 아니다.
+
+## 후속 작업 제안
+
+- 각 스테이지별 고유 몬스터 역할 비중을 더 명확히 분리한다.
+- 스테이지별 보스 패턴을 현재보다 더 강하게 차별화한다.
+- 진화 무기별 화면 가독성과 성능을 플레이테스트로 검증한다.
+- 미니보스 처치 시 보물상자/카드 선택 보상을 확정 지급하는 구조를 추가하면 뱀서류 보상감이 더 강해진다.
@@ -0,0 +1,109 @@
+# Skybound Miniboss Treasure Cache Reward Loop
+
+작성일: 2026-04-26 09:32 KST
+
+## 요청 요약
+
+- 뱀파이어 서바이벌 계열의 재미를 더 강하게 만들기 위한 다음 단계로, 미니보스 처치 보상 루프를 추가한다.
+- 단순 EXP 성장만 반복되는 구조가 아니라, 중간 강적을 잡았을 때 빌드 방향을 강화하는 확정 보상을 제공한다.
+- 보상은 기존 Tac Level Up 화면을 재사용하되, 보물상자 성격의 `Emergency Supply` 카드 선택으로 연결한다.
+
+## 핵심 방향
+
+Skybound의 현재 전투 루프는 적을 처치하면 Tac EXP를 바로 얻고, 일정 EXP에 도달하면 업그레이드를 선택하는 구조다. 이 방식은 화면 가독성에는 좋지만, 플레이 중간에 “강적을 잡아서 특별한 보상을 얻었다”는 뱀서류 특유의 보상감이 부족했다.
+
+이번 변경의 목표는 미니보스를 다음 역할로 재정의하는 것이다.
+
+1. 전투 흐름 중간의 압박 체크포인트
+2. 플레이어 빌드가 충분히 강한지 확인하는 작은 검증 구간
+3. 처치하면 현재 빌드를 더 선명하게 만드는 확정 업그레이드 보상
+4. 보스 전 진화/EVO 경로를 완성할 기회를 주는 중간 보물상자
+
+## 적용한 변경
+
+### 미니보스 식별 플래그 추가
+
+기존 `MINI_BOSS` 스폰은 내부적으로 `ELITE` 적을 생성했기 때문에, 처치 시 일반 엘리트와 구분되는 보상 처리가 어려웠다. `SystemEnemy`에 아래 플래그를 추가했다.
+
+- `isMiniBoss`
+- `rewardClaimed`
+
+`SpawnerSystem`의 `MINI_BOSS` 스폰에서는 이제 `isMiniBoss: true`를 부여한다.
+
+### 미니보스 HP 스케일링
+
+미니보스가 후반 스테이지에서도 너무 빨리 녹지 않도록 스테이지와 난이도 배율을 반영했다.
+
+- 기본 HP: `620`
+- 스테이지당 증가: `+22%`
+- 현재 `difficultyMult` 반영
+
+의도는 미니보스가 보스만큼 길지는 않지만, 플레이어가 위치와 공격 방향을 신경 써야 하는 짧은 전투 목표가 되게 하는 것이다.
+
+### 처치 보상 인텐트 추가
+
+`EngineProtocol`에 `MINIBOSS_REWARD` 인텐트를 추가했다. `CombatSystem`은 미니보스 처치 시 직접 UI를 열지 않고, 엔진 인텐트를 통해 보상 처리를 요청한다.
+
+이렇게 한 이유는 다음과 같다.
+
+- 전투 시스템이 UI 상태를 직접 제어하지 않게 한다.
+- 기존 `LEVEL_UP` 이벤트와 `LevelUpModal` 흐름을 재사용한다.
+- 추후 보물상자 연출, 룰렛, 보상 티어를 추가하기 쉽다.
+
+### 빌드 우선 보상 카드 생성
+
+`ProgressionSystem`에 `generateMiniBossRewardCards`를 추가했다. 이 보상은 일반 레벨업 카드보다 더 전략적으로 구성된다.
+
+우선순위는 다음과 같다.
+
+1. 이미 보유한 무기/스킬의 레벨업
+2. Lv.3 이상 무기의 EVO에 필요한 서포트 패시브
+3. 스웜/압박 구간 대응용 `isSpikeCounter` 스킬
+4. 부족한 자리는 기존 3카드 생성 규칙으로 보충
+
+이 구조는 플레이어가 아무 카드나 고르는 것이 아니라, “내 빌드를 완성해가는 선택”을 하도록 유도한다.
+
+### 보상 UI 연결
+
+미니보스 처치 시 아래 흐름으로 동작한다.
+
+1. 미니보스 사망
+2. `CombatSystem`이 `MINIBOSS_REWARD` 인텐트 발행
+3. `useGameEngine`이 현재 스킬 상태를 기반으로 보상 카드 생성
+4. 게임 일시정지
+5. `LEVEL_UP` 이벤트를 `isChest: true`로 발행
+6. 기존 `Emergency Supply` 카드 선택 UI 표시
+7. `COMMAND CACHE UNLOCKED` 피드백 텍스트 출력
+
+## 설계 의도
+
+이 변경은 Skybound의 목적성을 더 명확하게 만들기 위한 작업이다.
+
+- 일반 적 처치: Tac EXP를 쌓는 기본 성장
+- 엘리트 처치: 더 많은 EXP와 재료/장비 가능성
+- 미니보스 처치: 확정 빌드 강화 선택
+- 스테이지 보스 처치: 다음 스테이지 진행과 영구 보상
+
+즉, 전투 중 목표가 “그냥 버티기”에서 “위험한 타이밍을 넘기고 빌드를 완성하기”로 바뀐다.
+
+## 수정 파일
+
+- `/Volumes/Data/project/Antigravity/Skybound/src/features/game/hooks/useGameEngine.ts`
+- `/Volumes/Data/project/Antigravity/Skybound/src/features/game/systems/CombatSystem.ts`
+- `/Volumes/Data/project/Antigravity/Skybound/src/features/game/systems/EngineProtocol.ts`
+- `/Volumes/Data/project/Antigravity/Skybound/src/features/game/systems/ProgressionSystem.ts`
+- `/Volumes/Data/project/Antigravity/Skybound/src/features/game/systems/SpawnerSystem.ts`
+- `/Volumes/Data/project/Antigravity/Skybound/src/features/game/systems/types.ts`
+
+## 검증
+
+- `npm run build` 성공
+- Vite 경고: `/sprites/player.png referenced in /sprites/player.png didn't resolve at build time`
+- 위 경고는 기존 런타임 경로 경고이며 이번 변경으로 인한 빌드 실패는 아니다.
+
+## 후속 작업 제안
+
+- 미니보스 처치 순간에 실제 상자/코어가 열리는 0.6초 전용 연출을 추가한다.
+- 보상 카드에 `EVO READY`, `BUILD CORE`, `SURVIVAL PICK` 같은 태그를 붙여 선택 이유를 더 명확하게 보여준다.
+- 스테이지별 미니보스 외형과 탄막 패턴을 분리해 “이번 스테이지의 중간 위협” 정체성을 강화한다.
+- 보물상자 보상을 1장 선택에서 3장 순차 오픈 또는 희귀도 보상으로 확장할지 플레이테스트 후 결정한다.
@@ -0,0 +1,104 @@
+# Skybound Reward Card Clarity and Command Cache UI
+
+작성일: 2026-04-26 09:40 KST
+
+## 요청 요약
+
+- 미니보스 보상 루프 다음 단계로, 보상 카드가 왜 좋은 선택인지 사용자가 즉시 이해할 수 있게 개선한다.
+- 미니보스 처치 보상과 위기 보급 보상을 같은 화면처럼 보이지 않게 구분한다.
+- Stylized Casual Magitech 톤앤매너 안에서 보상감 있는 카드 선택 UI를 강화한다.
+
+## 핵심 방향
+
+이전 단계에서 미니보스 처치 시 확정 업그레이드 선택 보상이 추가되었다. 하지만 카드 3장이 뜨는 것만으로는 사용자가 “왜 이 보상이 지금 내 빌드에 좋은지” 바로 이해하기 어렵다.
+
+이번 변경의 목표는 보상 화면을 단순 선택지가 아니라, 플레이어에게 다음 메시지를 전달하는 UI로 만드는 것이다.
+
+1. 이 카드는 현재 주력 빌드를 강화한다.
+2. 이 카드는 EVO 진화 경로에 필요하다.
+3. 이 카드는 스웜/압박 상황에서 생존에 도움이 된다.
+4. 이 카드는 새로운 공격 패턴을 열어준다.
+
+## 적용한 변경
+
+### 보상 출처 타입 추가
+
+`LEVEL_UP` 이벤트에 `rewardSource`를 추가했다.
+
+- `STARTER`
+- `LEVEL_UP`
+- `POWER_SPIKE`
+- `MINIBOSS`
+
+기존에는 `isChest`만 있어서 미니보스 보상과 위기 보급 보상이 모두 같은 `Emergency Supply`처럼 보였다. 이제 보상 출처에 따라 헤더, 문구, 카드 태그를 다르게 표시할 수 있다.
+
+### 미니보스 보상 헤더 차별화
+
+미니보스 보상은 이제 `Emergency Supply`가 아니라 `Command Cache`로 표시된다.
+
+- Badge: `Cache`
+- Title: `Command Cache`
+- Subtitle: `Choose one build-defining reward`
+
+위기 보급은 기존 의도대로 `Emergency Supply`를 유지한다.
+
+### 카드 선택 이유 태그 추가
+
+각 카드 상단에 보상 이유 태그를 추가했다.
+
+- `FIRST CORE`: 첫 무기 선택, 런의 시작 방향 결정
+- `CORE UPGRADE`: 현재 주력 무기 강화
+- `MODULE BOOST`: 보유 패시브/모듈 강화
+- `EVO LINK`: 현재 무기의 진화 조건을 지원
+- `EVO READY`: 진화 조건 완성
+- `SURVIVAL PICK`: 스웜/압박 구간 대응
+- `NEW WEAPON`: 새로운 공격 패턴 개방
+- `UTILITY MOD`: 기본 성능 강화
+
+이 태그는 단순 라벨이 아니라, 카드가 “왜 지금 의미 있는 선택인지”를 설명하는 짧은 문장과 함께 표시된다.
+
+### Command Cache 연출 추가
+
+보상 화면 상단에 작은 마법공학 캐시 코어를 추가했다.
+
+- 팝 인 애니메이션
+- 회전하는 점선 링
+- 미니보스 캐시는 청록/라임 계열 빛
+- 일반 보급은 오렌지/시안 계열 빛
+
+실제 게임 시간을 더 지연시키지는 않지만, 화면이 뜨는 순간 보상 상자가 열린다는 감각을 강화한다.
+
+## 설계 의도
+
+뱀파이어 서바이벌 계열의 재미는 단순히 레벨업을 많이 하는 것이 아니라, “내가 고른 선택 때문에 빌드가 강해지고 있다”는 확신에서 나온다.
+
+이번 변경은 그 확신을 UI로 보강한다.
+
+- 미니보스 처치: `Command Cache`
+- 위기 보급: `Emergency Supply`
+- 일반 레벨업: `Tactical Upgrade`
+- 시작 선택: `Choose First Weapon`
+
+이제 각 성장 이벤트는 같은 카드 선택이라도 서로 다른 의미를 가진다.
+
+## 수정 파일
+
+- `/Volumes/Data/project/Antigravity/Skybound/src/features/game/hooks/useGameEngine.ts`
+- `/Volumes/Data/project/Antigravity/Skybound/src/features/game/systems/ProgressionSystem.ts`
+- `/Volumes/Data/project/Antigravity/Skybound/src/features/game/systems/types.ts`
+- `/Volumes/Data/project/Antigravity/Skybound/src/features/game/ui/GameSceneRenderer.tsx`
+- `/Volumes/Data/project/Antigravity/Skybound/src/features/game/ui/LevelUpModal.tsx`
+- `/Volumes/Data/project/Antigravity/Skybound/src/features/game/ui/LevelUpModal.css`
+
+## 검증
+
+- `npm run build` 성공
+- Vite 경고: `/sprites/player.png referenced in /sprites/player.png didn't resolve at build time`
+- 위 경고는 기존 런타임 경로 경고이며 이번 변경으로 인한 빌드 실패는 아니다.
+
+## 후속 작업 제안
+
+- 스테이지별 미니보스 패턴을 분리해 `Command Cache`를 얻는 과정 자체를 더 재미있게 만든다.
+- 보상 카드에 실제 EVO 결과 미리보기 아이콘을 추가한다.
+- 보물상자 보상을 1장 선택에서 희귀도 기반 다중 보상으로 확장할지 플레이테스트한다.
+- Command Cache가 열리는 짧은 0.5초 전용 컷인/상자 오픈 애니메이션을 Canvas 위에 추가한다.