lev-onboarding

name	lev-onboarding
description	First-run setup wizard for Lev — prereqs, XDG scaffolding, config, smoke validation, handoff to /work.
triggers	["install lev","setup lev","first run","onboard agent","lev doctor","prereq check","new machine","fresh install"]
source_flow	lev-onboarding.flow.yaml
generated	true

lev-onboarding

First-run setup wizard for Lev — prereqs, XDG scaffolding, config, smoke validation, handoff to /work.

Takes a human or coding-agent from zero to a working Lev install. Absorbs the hm-01 setup wizard pattern from hermes and the oc-02 onboarding wizard pattern from openclaw into a single Lev-specific surface, replacing the prior deferrals that had no valid home under /agent-field-kit's generic remote-access charter.

Quick Start

lev exec --flow lev-onboarding

Source of Truth

• dna/skills/lev-onboarding.intent.yaml
• dna/core/onboarding.dna.yaml
• docs/ARCHITECTURE.md (XDG Directory Map)

Steps

1. Run prereq-check: verify git, bun, pnpm, and writable XDG paths
2. Install or verify Lev CLI surface via core/poly (idempotent)
3. Scaffold XDG dirs: ~/.config/lev, ~/.local/share/lev, ~/.local/state/lev, ~/.cache/lev
4. Write default settings.yaml and reactive/hooks.yaml under $XDG_CONFIG_HOME/lev
5. Run smoke test: lev doctor plus one canonical flow execution
6. Emit lev.onboarding.* LevEvents for each step (visible on event bus)
7. Hand off to /work with a pre-filled tracked session for the first piece of real work

Done Condition

• Criteria: lev doctor returns exit 0 AND at least one flow executes end-to-end AND first /work session is tracked
• Metric: prerequisite_check_passes
• Metric: xdg_paths_created
• Metric: default_config_written
• Metric: first_flow_execution_ok
• Metric: first_work_session_tracked