docs: add project status, deferred items, and CLAUDE.md

- STATUS.md: completed phases, crate structure, test counts, next steps
- DEFERRED.md: simplified/postponed items per phase
- CLAUDE.md: build rules, wgpu quirks, project conventions

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-03-24 21:42:49 +09:00
parent 080ac92fbb
commit 7d59b1eed5
3 changed files with 170 additions and 0 deletions

27
CLAUDE.md Normal file
View File

@@ -0,0 +1,27 @@
# Voltex Engine
Rust 게임 엔진 프로젝트. wgpu 28.0 + winit 0.30 기반.
## 작업 현황
- `docs/STATUS.md` — 완료된 Phase, crate 구조, 테스트 현황, 다음 작업
- `docs/DEFERRED.md` — 간소화/미뤄진 항목 목록
## 스펙
- `docs/superpowers/specs/2026-03-24-voltex-engine-design.md` — 전체 엔진 설계
## 구현 계획
- `docs/superpowers/plans/` — 각 Phase별 상세 구현 계획
## 빌드/테스트
```bash
cargo build --workspace
cargo test --workspace
```
## 규칙
- Cargo path: `export PATH="$HOME/.cargo/bin:$PATH"` (Windows bash)
- wgpu 28.0 API: `immediate_size`, `multiview_mask`, `TexelCopyTextureInfo` 등 28.0 전용 필드 사용
- WGSL vec3 alignment: Rust struct에서 vec3 뒤에 padding 필요 (16바이트 정렬)
- max_bind_groups=4 (group 0~3). 리소스를 합쳐서 4개 이내로 유지
- Dynamic UBO 패턴: per-entity uniform은 aligned staging buffer + dynamic offset 사용
- 기존 예제(triangle, model_viewer 등)는 mesh_shader.wgsl(Blinn-Phong) 사용 — PBR 변경에 영향 없음