From 17a255c0f02285d5a5278db1ab2b83790b70340e Mon Sep 17 00:00:00 2001
From: Victor Giers <mail@victorgiers.com>
Date: Tue, 31 Mar 2026 01:16:55 +0200
Subject: [PATCH] Update architecture.md with WorldSettings and entity types

---
 architecture.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/architecture.md b/architecture.md
index 7fa22708..2d8e9e9c 100644
--- a/architecture.md
+++ b/architecture.md
@@ -341,6 +341,15 @@ interface SceneDocument {
 }
 ```
 
+`WorldSettings` is the correct home for:
+
+- background mode and background color/gradient
+- global ambient light settings
+- one authored global directional light / sun for early slices
+- fog settings where supported
+
+Do not model global world lighting as ad hoc hidden viewport state.
+
 ---
 
 ## `commands`
@@ -558,6 +567,8 @@ Early entity types:
 
 Later entity types may include:
 
+- `PointLight`
+- `SpotLight`
 - `Door`
 - `Waypoint`
 - `AmbientZone`
@@ -656,6 +667,7 @@ Imported assets should become one or more of:
 - placed model instances
 - reusable prefab inputs
 - material/texture records where useful
+- environment/sky assets where useful
 
 Do not treat imported assets as opaque blobs forever.
 Extract useful metadata and register them meaningfully.