Skip to content

Commit 2baf272

Browse files
committed
feat: [ENG-2697] surface vc/sync/cross-agent controls in onboarding tour
Msg 1 closes with a teaser line ("Also version-controlled, cloud-syncable, and shareable across agents — more at the end") so users know more controls exist without diluting the local-only trust climax. Msg 3 Part 1 delivers on it with three short bullets covering brv vc, brv vc push/pull, and connector cross-agent sharing. Without this, the tour leaves users thinking ByteRover is local-only with no team or sync story — they discover the full surface area accidentally or not at all.
1 parent ed5fd7c commit 2baf272

1 file changed

Lines changed: 15 additions & 2 deletions

File tree

src/server/templates/skill/onboarding.md

Lines changed: 15 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -101,6 +101,7 @@ Saved:
101101
102102
Lives at .brv/context-tree/ — local-only.
103103
See it in your browser: http://localhost:7700
104+
Also version-controlled, cloud-syncable, and shareable across agents — more at the end.
104105
```
105106

106107
**The pain-naming + commitment paragraph** is the wow. It should:
@@ -127,6 +128,7 @@ stop re-explaining. You start where you left off.
127128
128129
Lives at .brv/context-tree/ — local-only.
129130
See it in your browser: http://localhost:7700
131+
Also version-controlled, cloud-syncable, and shareable across agents — more at the end.
130132
```
131133

132134
**If the user shared no pain** (after the one-nudge attempt), skip the pain-naming paragraph entirely. Don't manufacture one. Show the identity bullets, the location line, the URL, the pause invitation. The tour still works; just without the life-saving moment.
@@ -137,6 +139,8 @@ Do NOT tell the user to "run `brv webui`" — the daemon auto-starts the web ser
137139

138140
Do NOT ask "is this right?" — that turns the artifact into a form. Users who want to correct it will; users who don't, won't be slowed down.
139141

142+
The closing teaser line ("Also version-controlled, cloud-syncable, and shareable across agents — more at the end") plants a seed for Msg 3 Part 1. Keep it to one line. Do NOT explain `brv vc` or connectors here — the point is to signal "you have more controls when you want them" without diluting the local-only trust climax. The frame is *opt-in additions to the local default*, not contradictions to it.
143+
140144
Before the pause invitation, give the user a **2-beat concept map** so they know where they are in the flow and what's coming. Without this, "I'll show you retrieval next" is meaningless — the user has no idea what retrieval is or why it matters.
141145

142146
**Render this block with clear visual separation from the artifact above** — insert an extra blank line (or a horizontal rule `---`) before it. The concept map is its own distinct beat, not a continuation of the artifact. If it blurs into the artifact, the user reads it as more "saved" output and skims past.
@@ -209,11 +213,20 @@ Msg 3 is **not** a passive close. After Msg 2, the user has saved their persona
209213

210214
**Two parts:**
211215

212-
### Part 1 — Where memory lives (one sentence)
216+
### Part 1 — Where memory lives + the three controls
217+
218+
Start with the location line — still command-free, same reason as the trust opener (the user is being told *where* and *who controls it*, not how to run a command):
213219

214220
> "Your memory lives in `.brv/context-tree/` — all local, you control sync."
215221
216-
That's it. One sentence. Avoid command names in this line for the same reason as the trust opener — the user is being told *where* and *who controls it*, not how to run a command.
222+
Then deliver on Msg 1's "more at the end" promise with **three short bullets**. The trust-opener constraint applies only to the location line above; command names are appropriate here because we're naming capabilities, not establishing trust.
223+
224+
> "Three controls you have when you're ready:
225+
> **Version control**`brv vc status`, `diff`, `commit`, `branch`. Git-style, just for your memory.
226+
> **Cloud sync, on your terms**`brv vc push` / `brv vc pull` when you want it. Never automatic.
227+
> **Cross-agent sharing** — connectors let Claude, Codex, Amp, OpenCode, and other agents share the same memory."
228+
229+
Three bullets max. Do NOT walk through sub-commands, flags, or auth setup. If the user asks for details, point them at `brv vc --help` or `brv connectors --help` — those aren't tour material. The job here is to name what's available so the user knows the surface area exists; they can explore on their own time.
217230

218231
### Part 2 — Activation: seed project context now
219232

0 commit comments

Comments
 (0)