app-onboarding-flowlisted
Install: claude install-skill Nioris/project-forge
# App Onboarding Flow — снизить churn первой минуты
## Зачем
Industry data: **30-50% юзеров уходят** в первые 60 секунд если app feels empty или confusing. Apps критичнее games в этом — у games есть встроенный feedback loop ("я нажал — что-то происходит"), у apps — пустой экран без user input.
Onboarding — это не tutorial. Это **архитектурный pattern**:
1. Welcome screen (что это за приложение)
2. Permission requests (только то что нужно)
3. Sample data (или dataset import)
4. First win (минимальное действие → видимый результат)
5. Feature discovery (постепенно, не всё сразу)
Заложить это в архитектуру = ~1 день. Retrofit потом = переписать UI flow.
## Когда вызывать
- **New apps**: после `$start` Step 6.5+ (i18n, data model) до first feature
- **Existing apps**: если analytics показывает D1 retention <30% — likely onboarding gap
- **Pivot**: если app меняет audience (B2C → B2B), onboarding нужен другой
## Pipeline
### Шаг 1 — Read context
```
wiki/_map.md # type, category
wiki/architecture/metrics.md # D1 retention target
wiki/research/{Project}-references.md # как у конкурентов
```
Бенчмарки D1 retention by category:
- Productivity: 50-70%
- Tools/reference: 30-50% (often single-use is OK)
- SaaS: 60-80% (paid trial period)
- Health: 40-60%
- Education: 50-70%
Если current/target D1 ниже benchmarka — onboarding фактор.
### Шаг 2 — Define onboarding strategy
3 levels of onboarding sophistication:
#### Level 1: Minimal (для tools/utility apps)