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

```bash
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

<!-- Generated by flowmind compile --target=skill from lev-onboarding.flow.yaml -->