diff --git a/internal/ui/AGENTS.md b/internal/ui/AGENTS.md
index 7fce65ce12d69d2d1be0268c9acbd45fd7605851..9bb2ceaf20da8b75df3a40390111b2a8be7f94c2 100644
--- a/internal/ui/AGENTS.md
+++ b/internal/ui/AGENTS.md
@@ -4,7 +4,7 @@
 - Never use commands to send messages when you can directly mutate children or state.
 - Keep things simple; do not overcomplicate.
 - Create files if needed to separate logic; do not nest models.
-- Always do IO in commands
+- Never do IO or expensive work in `Update`; always use a `tea.Cmd`.
 - Never change the model state inside of a command use messages and than update the state in the main loop
 
 ## Architecture