diff --git a/docs/2-handbook/agents/README.md b/docs/2-handbook/agents/README.md
index 71c8d0e53..d89ee52d7 100644
--- a/docs/2-handbook/agents/README.md
+++ b/docs/2-handbook/agents/README.md
@@ -1,9 +1,10 @@
 # Agents
 
-An **agent** is one Claude instance in its own NixOS container, with its own
-state directory, forge account and matrix accounts. This section covers
-running one: its identity, what survives a restart, how its config changes, what
-its own page shows and how far you can trust it.
+An **agent** is a model-driven worker in its own NixOS container, with its own
+state directory, forge account and matrix accounts. The operator chooses its
+runtime (Claude Code or any Agent Client Protocol agent) and its model. This
+section covers running one: its identity, what survives a restart, how its
+config changes, what its own page shows and how far you can trust it.
 
 - **[Roster](agent-roster.md)** — the agents of a hive, and who may do what
   to whom.