diff --git a/docs/builder-manual.md b/docs/builder-manual.md
index e08a240..d3a157b 100644
--- a/docs/builder-manual.md
+++ b/docs/builder-manual.md
@@ -241,7 +241,7 @@ name = "punch"
 description = "a close-range strike with the fist, quick but predictable"
 move_type = "attack"
 stamina_cost = 5.0
-timing_window_ms = 1800
+hit_time_ms = 1800
 damage_pct = 0.15
 
 [variants.left]
@@ -266,7 +266,8 @@ name = "dodge"
 description = "a quick sidestep to evade incoming attacks"
 move_type = "defense"
 stamina_cost = 3.0
-timing_window_ms = 800
+active_ms = 800
+recovery_ms = 2700
 
 [variants.left]
 
@@ -279,7 +280,9 @@ timing_window_ms = 800
 - `description` - shown in help/skills
 - `move_type` - "attack" or "defense"
 - `stamina_cost` - stamina consumed per use
-- `timing_window_ms` - how long the window is open (attacks: time to defend, defenses: commitment time)
+- `hit_time_ms` - (attacks) time in ms from initiation to impact
+- `active_ms` - (defenses) how long defense blocks once activated, in ms
+- `recovery_ms` - (defenses) lockout after active window ends, in ms
 - `damage_pct` - fraction of attacker's PL dealt as damage (attacks only)
 - `[variants.X]` - each variant becomes a separate command: "punch left", "punch right"
 - POV templates: `{attacker}`, `{defender}`, `{s}` (third person s), `{es}`, `{his}`, `{him}`, `{y|ies}` (irregular conjugation)