diff --git a/docs/2-handbook/swarm/knowledge.md b/docs/2-handbook/swarm/knowledge.md
index 0b7d9d29a..53e35e073 100644
--- a/docs/2-handbook/swarm/knowledge.md
+++ b/docs/2-handbook/swarm/knowledge.md
@@ -44,8 +44,9 @@ hive-c0re maintains the local clone at
 `/var/lib/hyperhive/knowledge` via two paths:
 
 1. **Swarm event** — the swarm controller holds the single push hook on
-   `internal/knowledge` (see `docs/2-handbook/swarm/README.md` § Swarm-wide forge
-   webhooks). On any push to main, including merge commits, it sends an
+   `internal/knowledge` (see
+   [swarm-wide forge webhooks](../../4-implementation/swarm/controller.md#swarm-wide-forge-webhooks)).
+   On any push to main, including merge commits, it sends an
    event to every hive over the swarm queue and each hive runs `git
 pull`, so agents see the new content on their next turn.