docs(wiki): cleanup orphan documents, delete 32 stubs and archive 121 for future merge

This commit is contained in:
Antigravity Agent
2026-05-04 15:36:31 +09:00
parent d9b5337388
commit a9a2bcb239
154 changed files with 21 additions and 331 deletions
@@ -1,26 +0,0 @@
# [LOG] Skybound Asset Purity & Transparency Synchronization
- **Timestamp**: 2026-04-23 22:52 (KST)
- **Status**: Completed
- **Lead**: Steve (Executive Director)
## 1. 작업 내용 (Task Summary)
- **스프라이트 자산 교체**: 사용자 기체(Falcon, Rayce), 일반 적기(Normal), 엘리트 적기(Elite), 보스 적기(Boss)의 이미지를 배경이 제거된 고해상도 PNG로 전면 교체.
- **렌더링 로직 최적화**: `SpriteUtils.ts``loadTransparentSprite` 함수 내에서 해당 에셋들이 'Fake Transparency Removal' 로직을 거치지 않고 원본 알파 채널을 그대로 사용하도록 화이트리스트 업데이트.
## 2. 작업 이유 (Rationale)
- **미학적 완성도**: 대표님(Yesung)께서 직접 가공하신 배경 없는 고해상도 에셋의 무결성을 100% 보존하기 위함.
- **성능 최적화**: 픽셀 단위의 색상 비교 및 배경 제거 연산(Flood-fill style algorithm)은 CPU 자원을 소모함. 이미 투명 배경이 확보된 에셋에 대해 이를 수행하는 것은 'Shit'이며, 이를 제거함으로써 로딩 속도와 런타임 효율성을 확보함.
## 3. 수정된 코드 (Code Changes)
- **Target File**: `/Volumes/Data/project/Antigravity/Skybound/src/features/game/utils/SpriteUtils.ts`
- **변경 사항**: `trueTransparencyAssets` 배열에 `'normal_enemy'`, `'elite_enemy'`, `'boss'` 키워드 추가. 이를 통해 해당 경로를 포함하는 모든 에셋은 원본 투명도를 신뢰하고 즉시 로딩됨.
## 4. 왜 했는가 (Why It Matters)
- **Zero-Tolerance for Mediocrity**: 도구가 창작자의 의도를 훼손하게 두지 않기 위함. 엔진은 창작자가 제공한 완벽한 재료를 가장 순수한 상태로 유저에게 전달해야 함.
- **System Integrity**: 에셋의 상태(Transparent vs Solid)에 따라 처리 파이프라인을 분기함으로써 시스템의 유연성과 전문성을 강화함.
## 5. 관련 토픽 (Linked Topics)
- Skybound: 프로젝트 전체 에셋 관리 표준 수립.
- Graphics & Performance: 불필요한 이미지 프로세싱 오버헤드 제거.
- Design & Experience: 픽셀 퍼펙트한 실루엣을 통한 게임 몰입감 증대.
@@ -1,21 +0,0 @@
# [LOG] Skybound Enemy Orientation Fix (Crab Movement Bug)
- **Timestamp**: 2026-04-23 23:13 (KST)
- **Status**: Resolved
- **Lead**: Steve (Executive Director)
## 1. 버그 내용 (Bug Description)
- **현상**: 적기가 화면 상단에서 등장할 때 정면(아래)을 보지 않고 오른쪽을 바라본 채 하강하는 '꽃게 이동' 현상 발생.
- **원인**: 적기 생성 시 `rotation` 초기값이 `0`이었으며, 등장 단계(Entrance)에서 플레이어를 조준하는 로직이 조기 종료(Early Return)로 인해 실행되지 않아 렌더링 오프셋(`+PI/2`)만 적용되어 오른쪽을 바라보게 됨.
## 2. 해결 방법 (Resolution)
- **초기화 강화**: `SpawnerSystem`에서 적기 생성 시 `rotation: Math.PI / 2`를 기본값으로 명시적 할당.
- **로직 순서 재조정**: `CombatSystem`의 업데이트 루프에서 회전값 계산을 등장 단계 분기점 이전으로 전진 배치하여, 어떤 상태에서도 적기가 플레이어 방향(또는 아래 방향)을 유지하도록 보장.
## 3. 결과 (Expected Result)
- 적기가 생성되는 즉시 플레이어를 향해 정면을 유지하며 하강함.
- 시각적 직관성 및 전투 몰입도 향상.
## 4. 관련 토픽 (Linked Topics)
- Skybound: 엔진 렌더링 무결성 확보.
- Graphics & Performance: 스프라이트 회전 행렬 최적화.