snow_trail/.pi/agent/skills/wgsl/SKILL.md

WGSL Shader Development

Reference for WGSL shader development, buffer alignment, uniform struct layout, and shader asset management. Load this skill when working on shader code, graphics pipelines, or buffer alignment issues.

WGSL Uniform Buffer Alignment

When creating uniform buffers for WGSL shaders, struct fields must be aligned:

Type	Alignment
f32	4 bytes
vec2<f32>	8 bytes
vec3<f32>	16 bytes (treated as vec4)
vec4<f32>	16 bytes
mat4x4<f32>	16 bytes (64 bytes total)

Use padding fields to match WGSL struct layout exactly. Prefer vec4 over individual floats to avoid alignment issues.

Shader Organization

Shaders live in src/shaders/ and are embedded via include_str!().