# Workspace System

**Status:** ✅ Complete (Feb 9, 2026)

Self-contained demo workspaces. Select with `cmake -B build -DDEMO_WORKSPACE=<name>`.

## Directory Layout

```
workspaces/
  main/           # Main production demo
    timeline.seq  # Visual effects
    music.track   # Audio patterns
    assets.txt    # Asset list
    music/*.spec  # Audio samples
    weights/*.bin # CNN weights
    obj/*.obj     # 3D models
    shaders/      # Workspace-specific shaders only
  test/           # Test demo (same structure)

src/shaders/      # Shared common shaders (math/, render/, compute/)
```

## Usage

```bash
# Main demo (default)
cmake -S . -B build -DDEMO_WORKSPACE=main && cmake --build build -j4

# Test demo
cmake -S . -B build_test -DDEMO_WORKSPACE=test && cmake --build build_test -j4
```

Shared shaders in `src/shaders/` are referenced as `../../src/shaders/...` in `assets.txt`.

See `doc/archive/WORKSPACE_SYSTEM.md` for full design and implementation history.