From c7f22fd199c8c31cf32a4594fcd092da9c119c4d Mon Sep 17 00:00:00 2001
From: tegwick <bernd.worsch@gmail.com>
Date: Mon, 2 Mar 2026 11:16:08 +0100
Subject: [PATCH] docs(onboarding): mention /init to trigger integration in
 step 3

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 dashboard/src/docs/repo-integration.md | 7 ++++---
 dashboard/src/repos.md                 | 4 ++--
 2 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/dashboard/src/docs/repo-integration.md b/dashboard/src/docs/repo-integration.md
index 499f019..56dd4d0 100644
--- a/dashboard/src/docs/repo-integration.md
+++ b/dashboard/src/docs/repo-integration.md
@@ -56,15 +56,16 @@ What happens automatically:
    onboarding tasks
 6. A progress event is logged
 
-### Step 3 — Open the repo in Claude Code
+### Step 3 — Open the repo in Claude Code and run /init
 
 ```bash
 cd /path/to/repo
 claude
 ```
 
-The repo agent starts, calls `get_domain_summary("<domain>")`, and sees the
-Repo Integration workstream. It works through the 4 onboarding tasks
+Once Claude starts, run `/init` to trigger the integration. The repo agent
+reads `CLAUDE.custodian.md`, calls `get_domain_summary("<domain>")`, sees the
+Repo Integration workstream, and works through the 4 onboarding tasks
 autonomously. No human interaction is needed unless the agent has a question.
 
 ### Step 4 — Monitor on the Repos page
diff --git a/dashboard/src/repos.md b/dashboard/src/repos.md
index e8a7086..c03130c 100644
--- a/dashboard/src/repos.md
+++ b/dashboard/src/repos.md
@@ -255,9 +255,9 @@ custodian register-project --domain &lt;slug&gt;</pre>
   <div class="onboard-step">
     <span class="onboard-num">3</span>
     <div>
-      <strong>Open the repo in Claude Code</strong>
+      <strong>Open the repo in Claude Code and run /init</strong>
       <pre>cd /path/to/repo && claude</pre>
-      <p class="onboard-note">The repo agent sees the Repo Integration workstream at session start and integrates autonomously — no manual interaction needed.</p>
+      <p class="onboard-note">Once Claude starts, run <code>/init</code> to trigger the integration. The repo agent reads <code>CLAUDE.custodian.md</code>, picks up the onboarding tasks, and integrates autonomously.</p>
     </div>
   </div>
   <div class="onboard-step">