From 65f7d74cbd4b34640dda73100c45f25ad468349d Mon Sep 17 00:00:00 2001
From: skal <pascal.massimino@gmail.com>
Date: Fri, 13 Feb 2026 08:36:09 +0100
Subject: Documentation: Update for file hierarchy reorganization

Updated docs to reflect February 13, 2026 changes:

- doc/FILE_HIERARCHY_CLEANUP_2026-02-13.md: Complete summary
- doc/WORKSPACE_SYSTEM.md: Current structure, workspace.cfg format
- doc/SHADER_REUSE_INVESTIGATION.md: Implementation status
- PROJECT_CONTEXT.md: Workspace and shader system updates

Key changes documented:
- src/app/ application structure
- workspaces/{music,weights,obj,shaders}/ layout
- common/shaders/ shared shader system
- Eliminated 36 duplicate shaders
- Asset packer path normalization

handoff(Claude): Documentation updated for hierarchy cleanup
---
 doc/WORKSPACE_SYSTEM.md | 60 +++++++++++++++++++++++++++++++++++--------------
 1 file changed, 43 insertions(+), 17 deletions(-)

(limited to 'doc/WORKSPACE_SYSTEM.md')

diff --git a/doc/WORKSPACE_SYSTEM.md b/doc/WORKSPACE_SYSTEM.md
index e8e2615..9362da6 100644
--- a/doc/WORKSPACE_SYSTEM.md
+++ b/doc/WORKSPACE_SYSTEM.md
@@ -46,7 +46,7 @@ This makes it hard to:
 4. Shaders hard to categorize (shared vs demo-specific)
 5. Adding new demos requires scattered changes
 
-## Proposed Structure
+## Current Structure (Implemented)
 
 ### Workspace Directory Layout
 
@@ -57,10 +57,10 @@ This makes it hard to:
     timeline.seq             # Visual effects
     music.track              # Audio patterns
     assets.txt               # Asset list
-    /assets/
-      /music/*.spec          # Demo-specific audio
-      /meshes/*.obj          # Demo-specific meshes
-    /shaders/                # Demo-specific shaders
+    /music/*.spec            # Audio samples
+    /weights/*.bin           # CNN binary weights
+    /obj/*.obj               # 3D models
+    /shaders/                # Workspace-specific shaders only
       custom_effect.wgsl
 
   /test/                     # Test/validation demo
@@ -68,23 +68,41 @@ This makes it hard to:
     timeline.seq
     music.track
     assets.txt
-    /assets/
+    /music/
+    /weights/
+    /obj/
     /shaders/
 
-  /experiments/              # Experimental demos
-    /demo2024_revision/
-      workspace.cfg
-      ...
-
-/assets/common/              # Shared resources
+/common/                     # Shared resources
   /shaders/
     /math/                   # Shared math utilities
       common_utils.wgsl
-      sdf.wgsl
-    /common_uniforms/        # Shared uniforms
-      common.wgsl
-  /audio/
-    standard_drums.spec      # Shared samples
+      noise.wgsl
+      sdf_shapes.wgsl
+      sdf_utils.wgsl
+    /render/                 # Shared rendering helpers
+      lighting_utils.wgsl
+      scene_query_bvh.wgsl
+      scene_query_linear.wgsl
+      shadows.wgsl
+    /compute/                # Shared compute shaders
+      gen_blend.wgsl
+      gen_grid.wgsl
+      gen_mask.wgsl
+      gen_noise.wgsl
+      gen_perlin.wgsl
+    common_uniforms.wgsl
+    lighting.wgsl
+    passthrough.wgsl
+    ray_box.wgsl
+    ray_triangle.wgsl
+    sdf_primitives.wgsl
+    skybox.wgsl
+
+/tools/
+  originals/                 # Source audio files (.wav, .aif)
+  test_demo.seq              # Test demo timeline
+  test_demo.track            # Test demo music
 ```
 
 ### Workspace Configuration
@@ -96,6 +114,14 @@ name = "Main Demo"
 description = "Production 64k demo"
 version = "1.0"
 
+[build]
+target = "demo64k"
+timeline = "timeline.seq"
+music = "music.track"
+assets = "assets.txt"
+asset_dirs = ["music/", "weights/", "obj/"]
+shader_dirs = ["shaders/"]
+
 [build]
 # Output binary name
 target = "demo64k"
-- 
cgit v1.2.3