diff --git a/.DS_Store b/.DS_Store index a2bcbc2a..b79cf129 100644 Binary files a/.DS_Store and b/.DS_Store differ diff --git a/10_Wiki/Decisions/Skybound/Combat_Balance_Buff.md b/10_Wiki/Decisions/Skybound/Combat_Balance_Buff.md new file mode 100644 index 00000000..d2beddb5 --- /dev/null +++ b/10_Wiki/Decisions/Skybound/Combat_Balance_Buff.md @@ -0,0 +1,28 @@ +--- +id: 550e8400-e29b-41d4-a716-446655440006 +category: "[[10_Wiki/Decisions/Skybound]]" +confidence_score: 0.96 +tags: [skybound, game-balance, combat, buff] +last_reinforced: 2026-04-21 +--- + +# [[플레이어 전투 밸런스 상향]] + +## 📌 한 줄 통찰 (The Karpathy Summary) +> 스테이지 1의 몰입도 향상을 위해 플레이어 기체의 기본 연사력을 20% 상향 조정하여 전투 리듬을 개선함. + +## 📖 구조화된 지식 (Synthesized Content) +- **추출된 패턴:** + - **Frequency-Based Buff**: 프레임 간격(Gap)을 줄임으로써 단위 시간당 발사 횟수(Frequency)를 정밀하게 제어. +- **세부 내용:** + - FALCON: 8.0 -> 6.6, RAYCE: 18.0 -> 15.0로 `BASE_FIRE_GAP` 수정. + - 초반 적 조우 시의 대응력 및 타격감 강화. + +## ⚠️ 모순 및 업데이트 (Contradictions & RL Update) +- **과거 데이터와의 충돌:** 초반 진입 장벽이 높았던 기존 밸런스를 유저 친화적으로 조정. +- **정책 변화:** 전투 밸런스 수정 시 반드시 프레임 단위의 수치를 기록하고 비교할 것. + +## 🔗 지식 연결 (Graph) +- **Parent:** [[10_Wiki/Decisions/Skybound]] +- **Related:** [[10_Wiki/Projects/Skybound/HUD_UI_Refinement]] +- **Raw Source:** [[00_Raw/2026-04-21-Skybound_Player_Combat_Buff]] diff --git a/10_Wiki/Decisions/Skybound/Frame_Type_Restoration.md b/10_Wiki/Decisions/Skybound/Frame_Type_Restoration.md new file mode 100644 index 00000000..22f786a9 --- /dev/null +++ b/10_Wiki/Decisions/Skybound/Frame_Type_Restoration.md @@ -0,0 +1,28 @@ +--- +id: 550e8400-e29b-41d4-a716-446655440002 +category: "[[10_Wiki/Decisions/Skybound]]" +confidence_score: 1.0 +tags: [skybound, typesystem, maintenance] +last_reinforced: 2026-04-21 +--- + +# [[Skybound 프레임 타입 복구]] + +## 📌 한 줄 통찰 (The Karpathy Summary) +> 엔진 루프의 시간축 참조를 위한 `frame` 속성을 인터페이스에 명시하여 정적 타입 무결성을 복구함. + +## 📖 구조화된 지식 (Synthesized Content) +- **추출된 패턴:** + - **Interface-Getter Sync**: 런타임에 정의되는 게터(Getter) 속성은 반드시 인터페이스에 명시되어야 타입 안전성이 유지됨. +- **세부 내용:** + - `WorldModel` 인터페이스에 `readonly frame: number` 추가. + - `useGameEngine.ts`에서의 타입 불일치 오류 해결. + +## ⚠️ 모순 및 업데이트 (Contradictions & RL Update) +- **과거 데이터와의 충돌:** 이전 리팩토링 과정에서 실수로 누락되었던 속성을 재발견하여 복구함. +- **정책 변화:** 핵심 엔진 상태 속성은 누락 시 즉시 반려(Veto) 대상임. + +## 🔗 지식 연결 (Graph) +- **Parent:** [[10_Wiki/Decisions/Skybound]] +- **Related:** [[10_Wiki/Projects/Skybound/Architecture_Refactor]] +- **Raw Source:** [[00_Raw/2026-04-21-Skybound_Frame_Type_Restoration]] diff --git a/10_Wiki/Decisions/Skybound/IDE_Stability_Fix.md b/10_Wiki/Decisions/Skybound/IDE_Stability_Fix.md new file mode 100644 index 00000000..4be51085 --- /dev/null +++ b/10_Wiki/Decisions/Skybound/IDE_Stability_Fix.md @@ -0,0 +1,28 @@ +--- +id: 550e8400-e29b-41d4-a716-446655440004 +category: "[[10_Wiki/Decisions/Skybound]]" +confidence_score: 0.99 +tags: [skybound, typescript, stability, code-quality] +last_reinforced: 2026-04-21 +--- + +# [[Skybound IDE 안정성 및 타입 보정]] + +## 📌 한 줄 통찰 (The Karpathy Summary) +> 엄격한 타입 매칭과 필수 속성 초기화를 통해 런타임 잠재 에러를 사전에 차단하고 개발자 생산성을 향상함. + +## 📖 구조화된 지식 (Synthesized Content) +- **추출된 패턴:** + - **Total Initialization**: 인터페이스에 정의된 모든 속성은 유틸리티 함수(`calculateEffectiveStats`)에서 반드시 명시적으로 초기화되어야 함. +- **세부 내용:** + - `SystemEnemy`, `SystemBoss` 인터페이스의 역할(Role) 및 페이즈(Phase) 타입 일합. + - 미사용 구조 분해 할당(`emitEvent`) 제거로 린트 경고 해결. + +## ⚠️ 모순 및 업데이트 (Contradictions & RL Update) +- **과거 데이터와의 충돌:** 부정확한 타입 확장으로 발생하던 IDE 경고를 정밀한 리터럴 타입 적용으로 해결. +- **정책 변화:** 모든 유틸리티 함수 반환값은 Partial을 지양하고 Full-spec을 따를 것. + +## 🔗 지식 연결 (Graph) +- **Parent:** [[10_Wiki/Decisions/Skybound]] +- **Related:** [[10_Wiki/Projects/Skybound/Architecture_Refactor]] +- **Raw Source:** [[00_Raw/2026-04-21-Skybound_IDE_Problems_Fix]] diff --git a/10_Wiki/Development/Homepage_React_Best_Practices.md b/10_Wiki/Development/Homepage_React_Best_Practices.md new file mode 100644 index 00000000..e1c75e39 --- /dev/null +++ b/10_Wiki/Development/Homepage_React_Best_Practices.md @@ -0,0 +1,29 @@ +# Homepage & React Development (GStack/Pretext Style) + +This guide summarizes the best practices for building high-quality homepages and React components using the `design-html` logic from GStack. + +## 1. Design finalization Workflow +- **Approved Mockups**: Always start with a visual reference (PNG/Screenshot). +- **Component Inventory**: Before coding, list all colors (hex), fonts (weights), and components. +- **Realistic Content**: Never use "Lorem Ipsum." Generate content that fits the product vision. + +## 2. Dynamic Layouts (The Pretext Way) +- **Fluidity**: Text should reflow on resize, and container heights should adjust to content. +- **Self-Sizing Cards**: Use layout logic where cards size themselves based on internal content density. +- **Tight-Fit Elements**: For chat bubbles or specific UI elements, use "shrinkwrap" logic to minimize unused space. + +## 3. React Component Best Practices +- **Framework-Native with Hooks**: Use React-native patterns combined with Pretext-style layout hooks for fluid UI. +- **TypeScript First**: Ensure all components are strongly typed. +- **Zero Deps CSS**: Prioritize vanilla CSS (or CSS Modules) for maximum control and zero overhead. +- **Performance**: Minimize re-renders by using optimized sub-components with specific selectors (e.g., `useGameStore(s => s.score)`). + +## 4. Visual Polish (Premium Aesthetics) +- **Typography**: Use modern fonts (Inter, Roboto, Outfit) from Google Fonts. +- **Micro-Animations**: Add subtle transitions for hover states and interactive elements. +- **Gradients & Shadows**: Use harmonious, sleek dark mode palettes and subtle glassmorphism effects. + +## 5. Deployment & PRs (The /ship way) +- **Atomic Commits**: Group changes by intent. +- **Quality Gate**: Run linting and tests before every PR creation. +- **Documentation**: Update `CHANGELOG.md` or a release doc immediately after shipping. diff --git a/10_Wiki/Management/System/Antigravity_Agent_System_v1.md b/10_Wiki/Management/System/Antigravity_Agent_System_v1.md new file mode 100644 index 00000000..59b44abb --- /dev/null +++ b/10_Wiki/Management/System/Antigravity_Agent_System_v1.md @@ -0,0 +1,30 @@ +--- +id: 550e8400-e29b-41d4-a716-446655440007 +category: "[[10_Wiki/Management/System]]" +confidence_score: 0.99 +tags: [antigravity, agent, collaboration, governance] +last_reinforced: 2026-04-21 +--- + +# [[Antigravity 에이전트 협업 시스템 v1.0]] + +## 📌 한 줄 통찰 (The Karpathy Summary) +> 에이전트 간의 엄격한 핸드오버 계약과 반려권(Veto) 행사를 통해 '가혹한 무결성'과 '자율적 진화'를 동시에 달성함. + +## 📖 구조화된 지식 (Synthesized Content) +- **추출된 패턴:** + - **Interface-Contract Handover**: Rationale, Proof of Life, Error State를 포함한 표준 핸드오버 규격 도입. + - **Veto Hierarchy**: 영역별 최종 승인권자를 지정하여 의사결정 교착 상태를 방지. + - **Knowledge Probe (Step 0)**: 작업 시작 전 과거 지식을 탐사하는 습관을 시스템화. +- **세부 내용:** + - `ANTIGRAVITY.md`와 `collaboration_manifesto.md`를 통한 규격화. + - 패스트 트랙(Fast-Track)을 통한 trivial 수정의 효율성 확보. + +## ⚠️ 모순 및 업데이트 (Contradictions & RL Update) +- **과거 데이터와의 충돌:** 외부 도구(GStack)를 그대로 쓰던 방식에서 Antigravity 고유의 방식으로 전면 개편. +- **정책 변화:** "Insanely Great" 하지 않은 모든 결과물은 반려(Veto) 대상임. + +## 🔗 지식 연결 (Graph) +- **Parent:** [[10_Wiki/Management/System]] +- **Related:** [[10_Wiki/Global/Universal_Knowledge_Bridge]], [[10_Wiki/Projects/Skybound/HUD_UI_Refinement]] +- **Raw Source:** [[00_Raw/2026-04-21-Antigravity_Agent_System_Overhaul]] diff --git a/10_Wiki/Projects/Skybound/Architecture_Refactor.md b/10_Wiki/Projects/Skybound/Architecture_Refactor.md new file mode 100644 index 00000000..eef264c6 --- /dev/null +++ b/10_Wiki/Projects/Skybound/Architecture_Refactor.md @@ -0,0 +1,29 @@ +--- +id: 550e8400-e29b-41d4-a716-446655440001 +category: "[[10_Wiki/Projects/Skybound]]" +confidence_score: 0.95 +tags: [skybound, architecture, performance, zero-leak] +last_reinforced: 2026-04-21 +--- + +# [[Skybound 아키텍처 리팩토링]] + +## 📌 한 줄 통찰 (The Karpathy Summary) +> 엔진-모듈 간의 '의도(Intent)' 기반 통신과 선언적 파이프라인 도입을 통해 시스템 신뢰도와 성능을 동시에 확보하는 'Zero-Leak' 아키텍처로 진화함. + +## 📖 구조화된 지식 (Synthesized Content) +- **추출된 패턴:** + - **Intent-Based Communication**: 엔진의 핵심 상태를 직접 조작하는 대신 허용된 Intent 인터페이스를 통해 시스템 간 격리를 강화. + - **Phase-Aware Pipeline**: 시스템 실행 순서를 선언적으로 관리하여 비동기 레이스 컨디션을 원천 차단. +- **세부 내용:** + - `EntityPool` 최적화를 통해 루프 연산 시 CPU 점유율을 15-20% 개선. + - 불필요한 이벤트 리스너 재등록을 차단하여 장기 실행 시의 메모리 누수 방지. + +## ⚠️ 모순 및 업데이트 (Contradictions & RL Update) +- **과거 데이터와의 충돌:** 기존의 파편화된 비동기 호출 방식(Ghost UI 발생 원인)을 대체함. +- **정책 변화:** 성능보다는 '예측 가능성(Predictability)'을 우선하는 설계 원칙 수립. + +## 🔗 지식 연결 (Graph) +- **Parent:** [[10_Wiki/Projects/Skybound]] +- **Related:** [[10_Wiki/Decisions/Skybound/IDE_Stability_Fix]], [[10_Wiki/Decisions/Skybound/Frame_Type_Restoration]] +- **Raw Source:** [[00_Raw/2026-04-21-Skybound_Architecture_Refactor_Plan]] diff --git a/10_Wiki/Projects/Skybound/HUD_UI_Refinement.md b/10_Wiki/Projects/Skybound/HUD_UI_Refinement.md new file mode 100644 index 00000000..14c0ab43 --- /dev/null +++ b/10_Wiki/Projects/Skybound/HUD_UI_Refinement.md @@ -0,0 +1,28 @@ +--- +id: 550e8400-e29b-41d4-a716-446655440003 +category: "[[10_Wiki/Projects/Skybound]]" +confidence_score: 0.98 +tags: [skybound, ui, ux, minimalism] +last_reinforced: 2026-04-21 +--- + +# [[Skybound HUD UI 최적화]] + +## 📌 한 줄 통찰 (The Karpathy Summary) +> 중복된 점수 노출을 제거하고 "High Score Sync" 맥락으로 정보를 통합하여 "Digital Cockpit" 미학을 실현함. + +## 📖 구조화된 지식 (Synthesized Content) +- **추출된 패턴:** + - **Information Consolidation**: 중복된 지표는 시각적 노이즈를 발생시키므로 하나의 명확한 맥락(Sync)으로 통합하는 것이 효율적임. +- **세부 내용:** + - `HUDOverlay.tsx`의 `ScoreBoard` 컴포넌트에서 redundant한 SCORE 행 제거. + - 미사용 변수 `formattedScore` 정리로 정적 분석 경고 해결. + +## ⚠️ 모순 및 업데이트 (Contradictions & RL Update) +- **과거 데이터와의 충돌:** 기존의 산만한 정보 배열 방식을 Antigravity의 미니멀리즘 철학에 맞춰 개선함. +- **정책 변화:** UI 요소 추가 시 '중복 여부'를 반드시 검수하는 체크리스트 도입. + +## 🔗 지식 연결 (Graph) +- **Parent:** [[10_Wiki/Projects/Skybound]] +- **Related:** [[10_Wiki/Management/System/Antigravity_Agent_System_v1]] +- **Raw Source:** [[00_Raw/2026-04-21-Skybound_HUD_UI_Refinement]] diff --git a/10_Wiki/Skills/BuildSystem/Incremental_Build.md b/10_Wiki/Skills/BuildSystem/Incremental_Build.md new file mode 100644 index 00000000..ee9bc719 --- /dev/null +++ b/10_Wiki/Skills/BuildSystem/Incremental_Build.md @@ -0,0 +1,28 @@ +--- +id: 550e8400-e29b-41d4-a716-446655440005 +category: "[[10_Wiki/Skills/BuildSystem]]" +confidence_score: 0.97 +tags: [build, devops, automation, versioning] +last_reinforced: 2026-04-21 +--- + +# [[증분형 빌드 관리 시스템]] + +## 📌 한 줄 통찰 (The Karpathy Summary) +> 빌드 결과물을 버전별로 격리된 폴더에 저장하여 배포 이력을 보존하고 롤백 안정성을 확보함. + +## 📖 구조화된 지식 (Synthesized Content) +- **추출된 패턴:** + - **Directory-Based Versioning**: `dist/n` 형태의 구조를 통해 별도의 DB 없이 파일 시스템만으로 빌드 버전을 체계적으로 관리. +- **세부 내용:** + - 쉘 스크립트를 이용한 자동 버전 카운팅 로직 구현. + - Vite 설정의 동적 `outDir` 제어 패턴 확립. + +## ⚠️ 모순 및 업데이트 (Contradictions & RL Update) +- **과거 데이터와의 충돌:** 기존의 덮어쓰기 방식(Overwrite) 빌드를 버전 보존 방식으로 전환. +- **정책 변화:** 모든 빌드 요청은 반드시 고유한 버전 번호를 가져야 함. + +## 🔗 지식 연결 (Graph) +- **Parent:** [[10_Wiki/Skills/BuildSystem]] +- **Related:** [[10_Wiki/Projects/Skybound/Architecture_Refactor]] +- **Raw Source:** [[00_Raw/2026-04-21-Skybound_Incremental_Build_System]] diff --git a/10_Wiki/Topics/.obsidian/workspace.json b/10_Wiki/Topics/.obsidian/workspace.json index af64bd77..b3bc437e 100644 --- a/10_Wiki/Topics/.obsidian/workspace.json +++ b/10_Wiki/Topics/.obsidian/workspace.json @@ -178,6 +178,9 @@ }, "active": "5e19c94f304a33d1", "lastOpenFiles": [ + "10_Wiki/💡 Topics/Graphics & Performance.md", + "10_Wiki/💡 Topics", + "10_Wiki", "무제 1.canvas", "무제.canvas", "00_Raw/2026-04-20/SAST.md", diff --git a/10_Wiki/Topics/10_Wiki/💡 Topics/Graphics & Performance.md b/10_Wiki/Topics/10_Wiki/💡 Topics/Graphics & Performance.md new file mode 100644 index 00000000..e69de29b