1 files changed, 30 insertions, 40 deletions
diff --git a/doc/SCENE_FORMAT.md b/doc/SCENE_FORMAT.md
index 679ab5e..fcf5e16 100644
--- a/doc/SCENE_FORMAT.md
+++ b/doc/SCENE_FORMAT.md
@@ -1,59 +1,49 @@
 # Scene Binary Format (SCN1)
 
-This document describes the binary format used for 3D scenes exported from Blender.
+Binary format for 3D scenes exported from Blender.
 
-## Overview
+## File Layout
 
 - **Extension:** `.bin` or `.scene`
 - **Endianness:** Little Endian
-- **Layout:** Header followed by sequential blocks.
+- **Structure:** Header + Object Blocks
 
-## Header (16 bytes)
+## Format Specification
 
-| Offset | Type     | Description |
-|--------|----------|-------------|
-| 0      | char[4]  | Magic bytes "SCN1" |
-| 4      | uint32_t | Number of objects |
-| 8      | uint32_t | Number of cameras (reserved) |
-| 12     | uint32_t | Number of lights (reserved) |
-
-## Object Block
-
-Repeated `num_objects` times.
+```cpp
+// Header (16 bytes)
+struct Header {
+  char magic[4];        // "SCN1"
+  uint32_t num_objects;
+  uint32_t num_cameras; // Reserved
+  uint32_t num_lights;  // Reserved
+};
 
-| Offset | Type     | Description |
-|--------|----------|-------------|
-| 0      | char[64] | Object Name (UTF-8, null-padded) |
-| 64     | uint32_t | Object Type (Enum) |
-| 68     | vec3     | Position (x, y, z) - 12 bytes |
-| 80     | quat     | Rotation (x, y, z, w) - 16 bytes |
-| 96     | vec3     | Scale (x, y, z) - 12 bytes |
-| 108    | vec4     | Color (r, g, b, a) - 16 bytes |
-| 124    | uint32_t | Mesh Name Length (N) |
-| 128    | char[N]  | Mesh Asset Name (if N > 0) |
-| 128+N  | float    | Mass |
-| 132+N  | float    | Restitution |
-| 136+N  | uint32_t | Is Static (0=Dynamic, 1=Static) |
+// Object Block (repeated num_objects times)
+struct ObjectBlock {
+  char name[64];        // UTF-8, null-padded
+  uint32_t type;        // ObjectType enum
+  vec3 position;        // 12 bytes
+  quat rotation;        // 16 bytes (x, y, z, w)
+  vec3 scale;           // 12 bytes
+  vec4 color;           // 16 bytes (r, g, b, a)
+  uint32_t mesh_len;    // Mesh name length (N)
+  char mesh_name[N];    // If N > 0
+  float mass;
+  float restitution;
+  uint32_t is_static;   // 0=Dynamic, 1=Static
+};
+```
 
 ### Object Types
 
 ```cpp
 enum class ObjectType {
-  CUBE = 0,
-  SPHERE = 1,
-  PLANE = 2,
-  TORUS = 3,
-  BOX = 4,
-  SKYBOX = 5,
-  MESH = 6
+  CUBE = 0, SPHERE = 1, PLANE = 2, TORUS = 3,
+  BOX = 4, SKYBOX = 5, MESH = 6
 };
 ```
 
-## Coordinate System
-
-- **Position**: Blender coordinates (Z-up) should be converted to engine coordinates (Y-up) by the exporter or loader. Currently raw export.
-- **Rotation**: Blender quaternions are (w, x, y, z). Exporter writes (x, y, z, w). Engine uses (x, y, z, w).
-
 ## Asset Resolution
 
-Mesh assets are referenced by name string (e.g., "MESH_CUBE"). The loader uses `GetAssetIdByName` to resolve this to a runtime `AssetId`.
+Mesh names (e.g., "MESH_CUBE") resolve to runtime `AssetId` via `GetAssetIdByName`.