diff --git a/CLAUDE.md b/CLAUDE.md
index bdbec28..2d458bc 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -20,6 +20,15 @@ card on turn boundaries automatically; call `task_start` /
 `task_update` / `task_wait` / `task_complete` MCP tools to set the
 activity subheader and post meaningful log entries.
 
+When you launch a `Bash` tool with `run_in_background: true` (or any
+long-running shell / monitor / poll loop), call `task_set_shells`
+with one short description per active background shell — and call it
+again with the updated list (or `[]`) when one completes. The board
+flips a waiting card to **orange** while the list is non-empty so the
+user can tell at a glance the session is parked on background work,
+not stalled on them. Hooks have no way to enumerate the bg-task list
+externally, so this is on the assistant.
+
 ## Purpose
 
 - Inventory of servers and their state