Progress on documentation

rooms/kq4-009-shady-wooded-area/kq4-009-shady-wooded-area.md

@@ -0,0 +1,48 @@
+# Room 9: Shady Wooded Area
+
+A transitional room in the wooded region, featuring a clearing with a large boulder, scattered flowers, and a distant pool to the north. Random birds may be visible in the trees depending on player state.
+
+## Look Description
+
+"You have entered a shady wooded area, with birds calling from the many trees. You notice a pool in the distance to the north." (Print 9 4)
+
+## Interactions
+
+| Status | Behavior Type | Command | Response |
+|--------|--------------|---------|----------|
+| TODO | Look | `look/look around/look [at][/room]` | "You have entered a shady wooded area, with birds calling from the many trees. You notice a pool in the distance to the north." (Print 9 4) |
+| TODO | Look | `look/pool/water` | "It's too far in the distance to see it clearly." (Print 9 1) |
+| TODO | Look | `look/boulder/rock` | "A large rock dominates the clearing." (Print 9 2) |
+| TODO | Look | `look/blossom/flower/flowers` | "There are flowers here and there." (Print 9 3) |
+| TODO | Action | `climb/boulder/climb/rock` | "It's too difficult to climb while wearing that dress." (Print 9 0) |
+
+## Scripts
+
+| Status | Behavior Type | Name | Trigger | Behavior |
+|--------|--------------|------|---------|----------|
+| TODO | Background | `bird1Actions` | Random 50% chance on room entry (when `is_fairy_form = false`) | Creates animated bird prop at position (283, 17) with view 342, loop 5. Cycles forward, waits 1-12 seconds, returns to cel 0, waits 1-8 seconds, repeats. |
+| TODO | Background | `bird2Actions` | Random 50% chance on room entry (when `is_fairy_form = false`) | Creates animated bird prop at position (58, 30) with view 342, loop 4. Cycles forward, waits 1-12 seconds, returns to cel 0, waits 1-8 seconds, repeats. |
+
+## Technical Notes
+
+- **Room Number**: 9
+- **Picture**: 9
+- **Region**: 507, 514 (region scripts not found)
+- **Exits**: North→3, South→15, East→10, West→8
+- **Music**: Not specified
+- **Horizon**: 75
+- **Synonyms**: `water` = `pool`
+
+### State Variables
+
+| Variable | Values | Description |
+|----------|--------|-------------|
+| `global101` | `0` | Room state flag (set to 0 in this room) |
+| `global100` (is_fairy_form) | `0` (false), `1` (true) | Player is in fairy form. When true, overlay 109 is shown and birds do not appear. |
+
+### Entry Conditions
+
+- Player y-position constrained to below horizon+1 (y > 76)
+- Player x-position constrained to minimum 93
+- Overlay 109 applied when `global100 = 1` (fairy form)
+- Two bird props spawn with 50% probability each when `global100 = 0`