diff --git a/README-FreeBSD.md b/README-FreeBSD.md
index b9062c44b..72642cefc 100644
--- a/README-FreeBSD.md
+++ b/README-FreeBSD.md
@@ -2,6 +2,12 @@
 
 This is a clean-room FreeBSD compatibility layer for [Hermes Agent](https://github.com/NousResearch/hermes-agent), built from the MIT-licensed upstream. No LGPL code, no Autolycus dependency.
 
+**Role in the Clawdie collective:** hermes-bsd is the **agent harness** — the
+layer you talk to (CLI, Telegram, skills, memory, cron). Colibri is the
+**control plane** — the layer that supervises agents, runs the task board, and
+tracks cost. They connect via Colibri's glasspane observation and MCP bridge;
+they do not duplicate each other.
+
 ## What's patched
 
 Three targeted changes for FreeBSD native support: