diff --git a/docs/README.md b/docs/README.md
index 62f0b23a..196e6571 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -31,7 +31,7 @@ declarations.
 - **What state survives destroy / purge / restart?** →
   [`agent-lifecycle/persistence.md`](agent-lifecycle/persistence.md).
 - **Who can do what to whom — the agent roster and privilege?** →
-  [`agent-lifecycle/agent-hierarchy.md`](agent-lifecycle/agent-hierarchy.md).
+  [`agent-lifecycle/agent-roster.md`](agent-lifecycle/agent-roster.md).
 - **How does claude get its prompt, and what tools does it have?** →
   [`turn-loop/`](turn-loop/README.md) — the loop, binary shape, turn
   outcomes; sub-pages: [`claude-invocation`](turn-loop/claude-invocation.md),
diff --git a/docs/agent-lifecycle/agent-hierarchy.md b/docs/agent-lifecycle/agent-roster.md
similarity index 100%
rename from docs/agent-lifecycle/agent-hierarchy.md
rename to docs/agent-lifecycle/agent-roster.md
diff --git a/docs/scheduler/coordinator.md b/docs/scheduler/coordinator.md
index b9d7fbdb..42f187ae 100644
--- a/docs/scheduler/coordinator.md
+++ b/docs/scheduler/coordinator.md
@@ -578,4 +578,4 @@ which is almost never desired. Leave off on non-x86 hosts.
 - `docs/agent-lifecycle/approvals.md` — approval flow + scheduled prompts
 - `docs/agent-lifecycle/persistence.md` — SQLite schema, state-dir layout
 - `docs/process/conventions.md` — wire protocol, recipient sentinels
-- `docs/agent-lifecycle/agent-hierarchy.md` — the agent roster and privilege
+- `docs/agent-lifecycle/agent-roster.md` — the agent roster and privilege
diff --git a/docs/turn-loop/config.md b/docs/turn-loop/config.md
index e50213da..3dc01a58 100644
--- a/docs/turn-loop/config.md
+++ b/docs/turn-loop/config.md
@@ -59,7 +59,7 @@ sudo rejection rather than silently succeeding — easier to audit.
 
 `services.hyperhive.agent.user.uid`, `services.hyperhive.agent.user.gid`, and
 `services.hyperhive.agent.user.name` are the companion options; see
-`docs/agent-lifecycle/agent-hierarchy.md` — "Harness systemd unit shape" for the full
+`docs/agent-lifecycle/agent-roster.md` — "Harness systemd unit shape" for the full
 `user.*` surface.
 
 ## Dashboard links
diff --git a/nix/agent-modules/agent-service.nix b/nix/agent-modules/agent-service.nix
index c8738397..ef2cfb03 100644
--- a/nix/agent-modules/agent-service.nix
+++ b/nix/agent-modules/agent-service.nix
@@ -455,7 +455,7 @@ in
 
     # Harness systemd unit. Unit shape (PATH wrapper-dir trick, env vars,
     # RuntimeDirectory, User=, standalone-eval fallbacks):
-    # docs/agent-lifecycle/agent-hierarchy.md::Harness systemd unit shape. PATH /bin
+    # docs/agent-lifecycle/agent-roster.md::Harness systemd unit shape. PATH /bin
     # auto-append behaviour: docs/process/gotchas.md::systemd.services.*.path
     # appends /bin to every entry.
     systemd.services.hive-agent =