G5: docs/hooks.md architecture umbrella + loop_limit clamp

Cherry-picked onto current main; plan-doc G table conflict resolved to
keep the G5-landed rows.

Co-authored-by: Jonathan Kingston <jonathanKingston@users.noreply.github.com>

Author: cursoragent

docs/claude-hooks.md

@@ -5,7 +5,9 @@
 handlers) so repos that already ship Claude Code policy hooks work without a Cursor-format
 `hooks.json`. Tracks issue #639.
 
-This is the Claude counterpart to [`docs/cursor-hooks.md`](./cursor-hooks.md).
+This is the Claude counterpart to [`docs/cursor-hooks.md`](./cursor-hooks.md). For the
+dialect-agnostic architecture (registry, canonical events, async/budget/epoch, spine,
+sandbox, UI) see [`docs/hooks.md`](./hooks.md).
 
 ## On-disk layout
 

docs/copse-hooks.md

@@ -10,7 +10,9 @@ vendor translation layer. It also exposes Copse-native knobs the imported dialec
 
 Each hook is a process that receives a JSON payload on **stdin**, may print a JSON response
 on **stdout**, and can observe, block, or annotate the action that triggered it. Dialect is
-determined by source path (decision 8): `.copse/hooks.json` → the Copse adapter.
+determined by source path (decision 8): `.copse/hooks.json` → the Copse adapter. For the
+dialect-agnostic architecture (registry, canonical events, async/budget/epoch, spine,
+sandbox, UI) see [`docs/hooks.md`](./hooks.md).
 
 The official JSON schema is published at
 [`schemas/copse-hooks.schema.json`](../schemas/copse-hooks.schema.json)

docs/cursor-hooks.md

@@ -7,7 +7,9 @@ can observe, block, or annotate the action that triggered it.
 
 This document records the Cursor hooks contract, what Copse honours today, and what
 remains for fuller parity. It is the hooks counterpart to
-[`docs/cursor-plugins.md`](./cursor-plugins.md).
+[`docs/cursor-plugins.md`](./cursor-plugins.md). For the cross-cutting architecture — the
+unified registry, canonical events, executors, async/budget/epoch, spine, sandbox, and UI
+that are dialect-agnostic — see [`docs/hooks.md`](./hooks.md).
 
 ## On-disk layout
 
@@ -327,6 +329,7 @@ UPDATE_HOOK_PAYLOAD_SNAPSHOTS=1 npm test
 - `src/main/services/hooks/payload-snapshots.test.ts` — dialect wire payload snapshot tests (G4)
 - `src/main/services/hooks/__snapshots__/wire-payloads.json` — committed golden wire-payload fixture (G4)
 - `src/main/services/exec/child-process-env.ts` — secret-scrubbed env for hook processes
+- `docs/hooks.md` — dialect-agnostic hooks architecture umbrella
 - `docs/claude-hooks.md` — Claude Code hooks contract
 - `docs/cursor-plugins.md` — sibling exploration of Cursor plugin support
 - `docs/supply-chain-security.md` — trust boundaries for executed code