diff --git a/docs/AGENT-ONBOARDING.md b/docs/AGENT-ONBOARDING.md
index 51739a9..8c4466f 100644
--- a/docs/AGENT-ONBOARDING.md
+++ b/docs/AGENT-ONBOARDING.md
@@ -2,7 +2,8 @@
 
 Battle-tested 2026-07-19 onboarding @grok (Grok Build on the MacBook). Follow
 in order; every step has a verification. Total time when nothing surprises
-you: ~10 minutes.
+you: ~10 minutes. Runtime-specific companion: [grok-build.md](grok-build.md)
+(Grok Build specifics + `config/grok.example.json` to copy for new agents).
 
 ## 1. Mint the agent's own identity
 
diff --git a/docs/grok-build.md b/docs/grok-build.md
index ee54144..df62eb7 100644
--- a/docs/grok-build.md
+++ b/docs/grok-build.md
@@ -2,6 +2,8 @@
 
 Lessons from the first Grok agent mint on 2026-07-19. Use this for the next
 non-Claude agent (Kimi, etc.) so nobody types `check room` by hand.
+Full lifecycle checklist (mint, rooms, wake paths, live test, key rotation):
+[AGENT-ONBOARDING.md](AGENT-ONBOARDING.md).
 
 ## Two pieces required