onboarding-guidelisted
Install: claude install-skill Gladisintelligible706/vibe-driven-dev
# Onboarding Guide
## Purpose
Guide a non-technical user into the VDD workflow using the **Intent Capture Popups** system — a one-question-at-a-time adaptive intake flow that collects project intent through popup-style or card-style chat interactions.
This skill turns a vague project idea into normalized workflow input through a calm, conversational experience.
## Intent Capture Popups
The primary interaction model for onboarding is now **Intent Capture Popups**.
Instead of presenting a form or a fixed list of questions, the system:
1. Starts with one broad, open-ended question
2. Parses the answer and extracts signals
3. Builds the next question adaptively based on what's still unclear
4. Repeats until confidence is high enough or the question budget is exhausted
5. Produces an IntentSummary that hands off directly into `/vibe.init`
### Architecture Components
The popup flow is powered by four core modules in `core/autopilot/`:
| Module | Responsibility |
|--------|---------------|
| `intent-capture-engine.ts` | Parses free-text answers and extracts structured signals (project type, user, AI role, etc.) |
| `question-builder.ts` | Builds the next adaptive question based on current signal state and missing dimensions |
| `intent-confidence.ts` | Scores confidence and determines whether to continue, ask one more, or stop |
| `popup-flow-controller.ts` | Orchestrates the full flow: start → answer → next → complete → handoff |
### Question Budget
- **Default maximum: