:::humanclean
## Problem
New workspaces stall on the first import: 41% of signups never connect a repository, and the ones who do wait a median of 9 minutes before seeing a single document render.
main
PRD — Onboarding revamp
docs/product/prd-onboarding.md · Maya Patel · Lead reviewer — walk the draft queue, diff, and settle each block with a verdict.
:::reviewpending
## Proposed flow
Ship a three-step wizard: connect repo, pick a starting folder, invite one reviewer. Every step is skippable and the workspace stays usable with zero steps completed.
agentCodex Agent6m ago1/2
Ship a three-step wizard — connect repo, pick a starting folder, invite one reviewer — with a persistent skip affordance on each step. The workspace must render a sample document even when zero steps are completed.
Makes the zero-state guarantee explicit; reviewers flagged it as ambiguous twice.
:::draft[agent]clean
## Success metrics
Repo-connection rate above 70% within 14 days, first-render latency under 90 seconds, and no regression on week-2 retention.
risk4m ago
Week-2 retention is a lagging metric — gating the launch on it will block the release for a fortnight. Consider a leading proxy such as second-session document opens.