Document sub agent grouping and independent launches

[selfcontained]

Nightly docs audit. Scoped to the diff since 7d4e2a4b — #973 (lineage + sidebar grouping) and #972 (self-archive), which between them changed where a launched agent renders and shipped with no doc changes at all.

What was wrong

Four surfaces still said a launched agent "appears as a top-level entry in the sidebar" and "is not nested under its parent like persona reviewers". Since #973, every agent with a parent renders as a row in that parent card's Sub Agents list; a top-level card is what child: false gets you.

What changed

• docs-sections/agents.tsx — Agent orchestration rewritten around the Sub Agents list, child: false, the one-level nesting cap, the row's session controls (attach/detach, resume, and the overflow menu with Pause / Session settings / Archive), orphan promotion when a parent is archived, and self-archive. Added an id="sub-agents" anchor. The Agent details paragraph no longer claims persona agents show a role block on their own card — they render as sub agent rows.
• docs-sections/tools.tsx — same correction in the orchestration section; child: false added to the dispatch_launch_agent bullet; lineage and provenance folded into the list_agents bullet (clears a backlog item from Surface agent delegation lineage in list_agents and messages #967).
• docs-sections/shortcuts.tsx — Mod+Shift+↑/↓ skips every sub agent now, not only review children, and anchors on the containing card when a sub agent is selected.
• plugins/dispatch/skills/subagents/SKILL.md — the same contract agent-facing. The depth cap especially: it fails at the point of use, halfway through work the agent has already planned around.
• README.md — three MCP table cells (dispatch_launch_agent, dispatch_archive_agent, list_agents).
• tips.ts — new "Sub Agents" ambient tip, since: 0.35.0 (confirmed by git merge-base --is-ancestor ab797976 65a75e5a), linking agents#sub-agents.

Docs only — no behavior change. pnpm run check and the tips unit tests pass.

Deferred

• The REVIEW badge on a sub agent row isn't in the Agents "Sidebar badges" list.
• agent-card.tsx's Persona block looks unreachable now (a persona agent always has a parent, and review children cascade on archive) — code cleanup, not docs.
• No e2e coverage of the Sub Agents grouping or the row overflow menu.

Next run: the Status Events deep-dive, which this displaced for a second time and should run regardless of what that diff turns up.

🤖 Generated with Claude Code