diff --git a/docs/terminal-rendering.md b/docs/terminal-rendering.md
index a7eb5f23..d535cc3c 100644
--- a/docs/terminal-rendering.md
+++ b/docs/terminal-rendering.md
@@ -122,8 +122,15 @@ suffix, so the terminal degrades cleanly against older event shapes.
      custom renderings); on miss fall through to a flat
      `.tool-use` row with `fmtToolUse → fmtArgsGeneric`.
      `fmtToolUse` surfaces the salient arg per built-in tool
-     (see table below); `fmtArgsGeneric` handles everything
-     else.
+     (see [`fmtToolUse` patterns](#fmttooluse-patterns) below);
+     `fmtArgsGeneric` handles everything else.
+4. `type == "user"` → walk `message.content[]` for
+   `tool_result`; `renderToolResult` correlates via
+   `tool_use_id → toolNameById` to default-open `recv`
+   results with a markdown body, else short = flat /
+   long = collapsed details.
+5. Unrecognised shape → `.sys` row (amber, `!` glyph).
+
 ### `fmtToolUse` patterns
 
 The `short` name strips the `mcp__hyperhive__` / `mcp__bash__` /
@@ -180,13 +187,6 @@ name as-is.
 | `download_file*` | `download_file* room` |
 | **Everything else** | `fmtArgsGeneric` — see [Extra-MCP tools](#extra-mcp-tools) |
 
-4. `type == "user"` → walk `message.content[]` for
-   `tool_result`; `renderToolResult` correlates via
-   `tool_use_id → toolNameById` to default-open `recv`
-   results with a markdown body, else short = flat /
-   long = collapsed details.
-5. Unrecognised shape → `.sys` row (amber, `!` glyph).
-
 ## Markdown
 
 `mdNode(text)` wraps `marked.parse(text)` (the `marked` v4.x npm