docs: Plan Shader Asset Integration (Task #24)

Updates ASSET_SYSTEM.md to describe shader asset handling. Adds Task #24 to TODO.md and PROJECT_CONTEXT.md to extract hardcoded shaders and integrate them with the AssetManager and ShaderComposer.

3 files changed, 26 insertions, 2 deletions

diff --git a/PROJECT_CONTEXT.md b/PROJECT_CONTEXT.md
index a0dd4a6..19e704a 100644
--- a/PROJECT_CONTEXT.md
+++ b/PROJECT_CONTEXT.md
@@ -34,6 +34,12 @@ Style:
     - [ ] Consolidate WebGPU header inclusions.
     - [ ] Remove `std::map`/`std::vector` from hot paths.
 
+- **Task #24: Shader Asset Integration**
+    - [ ] Extract hardcoded WGSL strings into `assets/final/shaders/`.
+    - [ ] Register shader assets in `demo_assets.txt`.
+    - [ ] Update `ShaderComposer` to load snippets from `AssetManager`.
+    - [ ] Refactor `Renderer3D` and `demo64k` to use asset-based shaders.
+
 - **Task #18: 3D System Enhancements**
     - [ ] **Blender Exporter**: Create script to export scenes to internal binary format.
     - [ ] **Asset Pipeline**: Update `asset_packer` and runtime loader for 3D scenes.
diff --git a/TODO.md b/TODO.md
index d874bb1..1cb6196 100644
--- a/TODO.md
+++ b/TODO.md
@@ -9,13 +9,20 @@ This file tracks prioritized tasks with detailed attack plans.
 - [ ] **Attack Plan - Unified Poll:** Incorporate `platform_get_time()` and `platform_get_aspect_ratio()` updates into `platform_poll()`.
 - [ ] **Attack Plan - Standard Container Removal:** Replace `std::map`, `std::string`, and `std::vector` in performance-critical or size-sensitive paths with simpler C-style alternatives.
 
-## Priority 2: 3D System Enhancements (Task #18)
+## Priority 2: Shader Asset Integration (Task #24)
+**Goal:** Treat shader snippets as regular assets managed by `AssetManager` and `ShaderComposer`.
+- [ ] **Attack Plan - Extract Shaders:** Move hardcoded WGSL strings (from `renderer.cc`, `gpu.cc`) into `assets/final/shaders/*.wgsl`.
+- [ ] **Attack Plan - Asset Entry:** Add new shader files to `assets/final/demo_assets.txt` and `test_assets_list.txt`.
+- [ ] **Attack Plan - ShaderComposer Update:** Update `ShaderComposer` to optionally register snippets from `AssetId`.
+- [ ] **Attack Plan - Integration:** Update `Renderer3D` and `demo64k` to use `ShaderComposer` with asset-based snippets.
+
+## Priority 3: 3D System Enhancements (Task #18)
 **Goal:** Establish a pipeline for importing complex 3D scenes to replace hardcoded geometry.
 - [ ] **Attack Plan - Blender Exporter:** Create a Python script (`tools/blender_export.py`) to export meshes/cameras/lights to a binary asset format.
 - [ ] **Attack Plan - Asset Ingestion:** Update `asset_packer` to handle the new 3D binary format.
 - [ ] **Attack Plan - Runtime Loader:** Implement a minimal C++ parser to load the scene data into the ECS/Renderer.
 
-## Priority 3: Shader Optimization (Task #21)
+## Priority 4: Shader Optimization (Task #21)
 **Goal:** Improve GPU performance and reduce shader source bloat.
 - [ ] **Attack Plan - Normal Factorization:** Create a standard WGSL helper for normal calculation to avoid duplicate code in every effect.
 - [ ] **Attack Plan - Tri-planar Mapping:** Implement bi/tri-planar mapping for procedural textures to improve visual quality on complex SDFs.
diff --git a/doc/ASSET_SYSTEM.md b/doc/ASSET_SYSTEM.md
index 250be07..bd5a266 100644
--- a/doc/ASSET_SYSTEM.md
+++ b/doc/ASSET_SYSTEM.md
@@ -55,3 +55,14 @@ we need a simple tool that:
   * generates the assets_data.cc file with all the data
   * put these in the source tree
   * this process needs a script for automation
+
+# Shader Snippets
+
+Shader code (WGSL) can also be managed as assets.
+1. Create `.wgsl` files in `assets/final/shaders/` (or similar).
+2. Add them to `assets/final/demo_assets.txt` with compression `NONE`.
+   Example: `SHADER_COMMON, shaders/common.wgsl, NONE`
+3. In C++, retrieve them using `GetAsset()`. Since they are binary blobs,
+   construct a `std::string` or `std::string_view` using the returned pointer
+   and size.
+4. Register them with the `ShaderComposer`.