MeridiansMeridians

Onboarding workspace [UI]

Source path: knowledge-base/diagrams/ui/onboarding-workspace.md

# Onboarding workspace `[UI]`

The domain-genesis surface: a full-screen workspace with a progress sidebar and a center step container. Six steps carry a *constellation of drafts* from an idea to extracted, maintained Domains. Two steps (Capture, Maintain) let you move between drafts in any order; the rest are linear.

```mermaid
flowchart LR
    Page["/onboarding/[id]<br/>(wrapped in GatewayShell)"] --> Work

    subgraph Work["OnboardingWorkspaceView"]
        direction LR
        Center["**step container** — one step body at a time"]
        Side["**OnboardingSidebar**<br/>6-step progress rail +<br/>per-draft switcher (Capture/Maintain) +<br/>delete control"]
    end

    Center --> Steps

    subgraph Steps["the six steps (OnboardingStep)"]
        direction TB
        S1["**idea** → IdeaStep<br/>frame the constellation"]
        S2["**topics** (Capture) → CaptureStep<br/>split-pane: interview chat + corpus review"]
        S3["**architecture** (Graph) → GraphStep<br/>GraphStudio — world-node canvas"]
        S4["**grounding** → research corpus / interview"]
        S5["**build** → BuildStep<br/>create Constellation + extract Domains (background)"]
        S6["**automation** (Maintain) → MaintainStep<br/>per-Domain: Reminder + Research loop approval"]
        S1 --> S2 --> S3 --> S4 --> S5 --> S6
    end

    S5 -.->|"extraction runs in background"| Ex(["extraction-pipeline → canonical Domains"])
    S6 -.->|"SynthesisStep — tutor merge from interview"| Syn(["expert corpus folded"])
```

- **The sidebar is the spine.** `ONBOARDING_STEPS` drives the numbered rail (step *n* of 6); Capture and Maintain expose a **per-draft switcher** below it because both operate over every draft Domain, in any order. The delete control tears down the whole onboarding (answers, Graph, corpus).
- **Capture is a split-pane.** An interview chat on one side, the accumulating corpus review on the other — the two expandable panels track focus per draft. This is the ideal grounding path: paid Research (public) + interview (private) → corpus → accept → expert corpus.
- **Build is background + resumable.** Creating the Constellation and extracting each accepted corpus runs in the background — you can leave and return. Deleting a Constellation/Domain elsewhere makes the step offer to rebuild it.
- **The whole flow is also drivable headless.** The same steps are a Tier-2 op family, so a chat can run all six (build/automation execute immediately).

**Where it lives:** `src/features/onboarding/` — `OnboardingWorkspaceView.tsx` · `OnboardingSidebar.tsx` · `OnboardingSteps.tsx` · `steps/{IdeaStep,CaptureStep,GraphStep}.tsx` · `SynthesisStep.tsx` · `GraphStudio.tsx`. Step model: `src/types/domain/onboarding.ts` + `src/lib/core/onboarding.ts`. Background runner: [onboarding](../flows/onboarding.md) flow · [extraction-pipeline](../flows/extraction-pipeline.md).
Open on GitHub

Raw Markdown source