1 files changed, 6 insertions, 0 deletions
diff --git a/AGENTS.md b/AGENTS.md
index 6fdb497..cef1d79 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -153,3 +153,9 @@ Full field reference in `item/item.go`. Key fields: equip_slot, weapon_type, att
 1. Add `cmd_<name>.go` in `internal/game/` with `func (g *Game) executeXxx(sess *net.Session, args []string, rawInput string)`
 2. Register in `commandRegistry` in `cmd_registry.go`
 3. Add help YAML in `data/help/`
+
+## Known Gaps
+
+- **Tick subscriber ordering**: `AdvanceActions`, combat subscriptions, mob attack subscriptions,
+  and hazard ticks are independent subscribers without priority guarantees. A trigger completing
+  and a mob landing a hit on the same tick have non-deterministic ordering.