메뉴
wgpu 28.0 GPU rendering — render passes, shadow mapping, PBR shaders, pipeline management, texture/buffer resources, Vulkan validation, and frame lifecycle (begin_frame/end_frame). Use for any GPU, shader, or rendering task.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | wgpu-rendering |
| description | wgpu 28.0 GPU rendering — render passes, shadow mapping, PBR shaders, pipeline management, texture/buffer resources, Vulkan validation, and frame lifecycle (begin_frame/end_frame). Use for any GPU, shader, or rendering task. |
| license | Apache-2.0 |
| allowed-tools | cargo-build cargo-test |
| metadata | {"author":"eraflo","version":"1.0.0","category":"rendering"} |
When working on the GPU rendering subsystem:
Backend location: crates/khora-infra/src/graphics/wgpu/
system.rs — WgpuRenderSystem: frame lifecycle, swapchain managementdevice.rs — WgpuDevice: resource creation, command submission, GPU pollingcontext.rs — WgpuGraphicsContext: surface/device/queue ownershipcommand.rs — WgpuCommandEncoder: render pass encodingbackend.rs — adapter selection, backend preferenceFrame lifecycle (single acquire per frame):
begin_frame() — poll + wait_for_last_submission + acquire swapchain texturerender_with_encoder() — encode commands to the shared swapchain targetend_frame() — present + update statshandle_frame() in crates/khora-sdk/src/lib.rsAbstract resource IDs — all GPU resources use typed IDs:
TextureId, TextureViewId, BufferId, PipelineId, BindGroupId, etc.WgpuDevice methodswgpu::Texture in public APIsShaders (WGSL): crates/khora-lanes/src/render_lane/shaders/
lit_forward.wgsl — PBR lit shader with shadow sampling (PCF 3×3)shadow_depth.wgsl — depth-only shadow passsimple_unlit.wgsl — basic unlit materialShadow system:
ShadowPassLane — renders depth to a 2048×2048 shadow atlas (4 layers)calculate_shadow_view_proj() — directional/spot/point light matricesDepth32Float, comparison samplerwgpu version: 28.0 — uses PollType::Wait with SubmissionIndex
Vulkan validation: Must never produce validation errors. Common pitfalls:
get_current_texture()base_array_layer must be correct for texture array views| Type | Crate | Purpose |
|---|---|---|
WgpuRenderSystem | khora-infra | Frame lifecycle, swapchain |
WgpuDevice | khora-infra | Resource management, submission |
WgpuCommandEncoder | khora-infra | Render pass encoding |
RenderSystem trait | khora-core | Abstract render system interface |
GraphicsDevice trait | khora-core | Abstract device interface |
CommandEncoder trait | khora-core | Abstract encoder interface |
CRPECS ECS architecture — archetype-based Column-Row Partitioned Entity Component System with SoA storage, parallel queries, component registration, and entity lifecycle management. Use when working on ECS, World, components, queries, or archetypes.
Lane pipeline architecture — unified Lane trait, LaneContext type-map, Slot<T>/Ref<T> ephemeral access, LaneRegistry, and all concrete lane implementations (render, shadow, physics, audio, asset, ECS). Use when working on lane execution, context passing, or pipeline orchestration.
General Rust game engine development — build systems, workspace management, dependency resolution, proc macros, unsafe auditing, and performance profiling. Use for any Rust compilation, testing, or workspace-level task.
Symbiotic Adaptive Architecture (SAA) and CLAD layering — Control/Lanes/Agents/Data architecture, DCC orchestration, GORNA protocol, agent lifecycle, budget system, and inter-agent communication. Use for architectural decisions, agent implementation, or DCC/GORNA work.