feat: WGSL Uniform Buffer Validation & Consolidation (Task #75)

- Added  to validate WGSL/C++ struct alignment.
- Integrated validation into .
- Standardized uniform usage in , , , .
- Renamed generic  to specific names in WGSL and C++ to avoid collisions.
- Added  and updated .
- handoff(Gemini): Completed Task #75.

1 files changed, 7 insertions, 0 deletions

diff --git a/TODO.md b/TODO.md
index 4b5819b..ca755ec 100644
--- a/TODO.md
+++ b/TODO.md
@@ -6,6 +6,13 @@ This file tracks prioritized tasks with detailed attack plans.
 
 ## Recently Completed (February 9, 2026)
 
+- [x] **WGSL Uniform Buffer Validation & Consolidation (Task #75)**:
+  - **Standardization**: Refactored `DistortEffect` and others to use `CommonPostProcessUniforms` (binding 2) + `EffectParams` (binding 3).
+  - **Validation Tool**: Created `tools/validate_uniforms.py` to parse C++ and WGSL (including embedded strings) and verify size/alignment.
+  - **Integration**: Added validation step to CMake build system.
+  - **Cleanup**: Renamed generic `EffectParams` to specific names (`FadeParams`, `CircleMaskParams`, etc.) in WGSL and C++.
+  - **Documentation**: Added `doc/UNIFORM_BUFFER_GUIDELINES.md` and updated `CONTRIBUTING.md`.
+
 - [x] **Uniform Buffer Alignment (Task #74)**: Fixed WGSL struct alignment issues across multiple shaders:
   - `circle_mask_compute.wgsl`: Changed `_pad: vec3<f32>` to three `f32` fields
   - `fade_effect.cc`: Changed EffectParams padding from `vec3<f32>` to `_pad0/1/2: f32`