docs: add shared session handoff guide (en/zh)

[zxch3n]

Why

Lody’s main SEO narrative is handoff: invite a teammate into an existing coding agent session to continue — conversation, diffs, and worktree — not a read-only transcript share (ChatGPT / Lore / SpecStory / export).

This is the dedicated docs pillar for that story. Team Features already mentions sharing sessions; it does not own a URL or comparison that can rank for “share claude code session.”

URL paths

• English: /docs/session-handoff/
• Chinese: /zh/docs/session-handoff/
• Files: site-docs/content/docs/{en,zh}/(features)/session-handoff.mdx
• Nav: Features, immediately after Team Features (both locales)
• Cross-link: short paragraph on Team Features → this page

Parenthesized (features) folder does not appear in the URL (existing Fumadocs convention).

Keyword intent

• Primary: share claude code session (~56 US/mo) — used once as the existing workflow people search for, then distinguished from Lody.
• Secondary: coding agent session handoff (not generic “agent handoff”).
• Title/description stay product-accurate and multi-agent; Claude Code is not the page title.
• Head title is branded via existing brandTitle (Share a Coding Agent Session | Lody / 共享并交接 Agent 会话 | Lody). Visible DocsTitle stays unbranded.

How to preview

corepack pnpm install
corepack pnpm --filter @lody/site-docs dev
# http://127.0.0.1:3002/docs/session-handoff/
# http://127.0.0.1:3002/zh/docs/session-handoff/

Or corepack pnpm --filter @lody/site-docs build and inspect site-docs/out/client.

Verification

Ran locally after corepack pnpm install (ACP extension submodules required for workspace install):

Check	Result
pnpm --filter @lody/site-docs generate	Pass (74 docs in search; title/description validation in generate-llms)
Dev GET /docs/session-handoff/	200 — <title>Share a Coding Agent Session | Lody</title>
Dev GET /zh/docs/session-handoff/	200 — <title>共享并交接 Agent 会话 | Lody</title>
Description meta	Matches frontmatter (en + zh)
Production build + prerender	Both paths crawled; out/client/docs/session-handoff/index.html and zh counterpart exist
Sitemap	https://lody.ai/docs/session-handoff/ and /zh/docs/session-handoff/
Docs search index	en:session-handoff and zh:session-handoff
Sidebar	Features → after Team Features, label matches title, no wrap
Internal links	Sessions, Team Features, Agent Config, heading anchors on team/session
Team Features cross-link	Present and clickable (en + zh)
Tables / callouts / FAQ	Render correctly in browser (en + zh)

Browser walkthrough:

EN comparison table and sidebar
EN permissions and FAQ
Team Features cross-link and nav
Chinese session-handoff page

Adversarial notes / assumptions

Product accuracy (from existing docs + UI copy, not invented click-paths):

• Share flow: session ... menu or desktop Private control → Share with team… (label may be device/project-specific). Only the device owner can share. Machines default private.
• Confirmation can share the machine and/or local project; other conversations on that device may become visible. Documented as a warning.
• Finding the session: copied link, or home-page GitHub Worktree filter → all team sessions.
• “Continue” is capability-level: open the same session and keep chatting. No claim of simultaneous presence, mid-turn takeover, or real-time co-editing.
• Fork is called out as a new session, not a teammate handoff.
• Copy Session URL ≠ granting team access. Copy as Markdown is the transcript path.

Competitor table: Lore and SpecStory rows are capability-level from their public docs (rendered/exported thread or viewer link; Lore fork seeds a new agent session). They are not claimed to be feature-identical to Lody. If positioning drifts, update the table — do not treat those rows as a contractual product matrix.

Out of scope (later PRs): parallel-agents page, blog post, FAQ JSON-LD / llms.txt extras, soft-404 (#383), loro.dev.

Chinese: written to match existing zh docs tone (product terms kept in English where those pages already do: Session, Agent, Worktree, steer). Not a literal machine translation.

Nav: “Share a Coding Agent Session” is longer than some Feature titles; placed next to Team because that is the existing share-sessions home. Verified it does not wrap in the desktop sidebar. Open to shortening if needed.

H1: Fumadocs DocsTitle is the visible H1 (frontmatter). MDX # is aligned to the same string so the TOC first item is not a second wording.

Related

Independent of draft #383 (soft-404). Branched from latest main. Draft only — do not merge.

_{To show artifacts inline, enable in settings.}