docs: move the agent tool docs to 4-implementation/agent-tools

docs/README.md

@@ -29,13 +29,13 @@ later work.
 - **What does the dashboard look like, and how to use it?** →
   [`2-handbook/web-ui/`](2-handbook/web-ui/README.md) — the operator-facing starting point,
   with [`dashboard`](2-handbook/web-ui/dashboard.md) and [`agent`](2-handbook/web-ui/agent.md).
-- **What tools does an agent (or the operator) have available?** →
-  [`2-handbook/tools/`](2-handbook/tools/README.md) — `hivectl` (yours) plus every agent's MCP
-  tool surface (bash, forge, lifecycle, matrix).
+- **What tools does the operator have?** →
+  [`2-handbook/tools/`](2-handbook/tools/README.md) — `hivectl` and `swarmctl`. The agents' own tool
+  surface is in [`4-implementation/agent-tools/`](4-implementation/agent-tools/README.md).
 - **What does `hivectl` do? Provisioning, gateway users, container
   shells?** → [`2-handbook/tools/hivectl.md`](2-handbook/tools/hivectl.md) (the curated guide);
   [`2-handbook/tools/hivectl-cli.md`](2-handbook/tools/hivectl-cli.md) for the exhaustive,
-  autogenerated flag reference. The other command-line references sit beside it in
+  autogenerated flag reference. The `swarmctl` reference sits beside it in
   [`2-handbook/tools/`](2-handbook/tools/README.md).
 
 ### Agent lifecycle
@@ -59,11 +59,11 @@ later work.
 
 - **How do per-agent forge accounts work? What does `forge_notify` poll,
   and how does it format wake messages?** → [`2-handbook/integrations/forge.md`](2-handbook/integrations/forge.md)
-  (the swarm's Forgejo); [`2-handbook/tools/forge.md`](2-handbook/tools/forge.md) for the
+  (the swarm's Forgejo); [`4-implementation/agent-tools/forge.md`](4-implementation/agent-tools/forge.md) for the
   `hive-forge` CLI verbs agents actually call.
 - **How does the matrix-tuwunel container work? Multiple accounts per
   agent?** → [`2-handbook/integrations/matrix.md`](2-handbook/integrations/matrix.md) (the homeserver);
-  [`2-handbook/tools/matrix.md`](2-handbook/tools/matrix.md) for the MCP tool surface and
+  [`4-implementation/agent-tools/matrix.md`](4-implementation/agent-tools/matrix.md) for the MCP tool surface and
   `services.hyperhive.agent.matrixAccounts`.
 - **How to give an agent a GitHub account (`gh` + `git push`)? how's
   the PAT injected?** → [`2-handbook/integrations/github.md`](2-handbook/integrations/github.md)
@@ -101,6 +101,12 @@ Nothing of it sits in this tree.
 
 ## 4. Implementation
 
+### Agent tools
+
+- **What can an agent do inside its container? bash, subagent, forge, matrix, and the
+  `hive-forge`, `swarm-logs` and `swarm-metrics` CLI references?** →
+  [`4-implementation/agent-tools/`](4-implementation/agent-tools/README.md).
+
 ### Turn loop, scheduler, CI, observability
 
 - **How does claude get its prompt, and what tools does it have?** →