# Onboarding

## Purpose

First-run wizard so a new site owner can go from install → useful AI in ~5
minutes without reading the architecture docs.

## Flow (required steps)

1. **Back up website** — detect known backup plugins or admin confirm
2. WordPress AI Client available
3. Configure provider (Settings → Connectors)
4. Enable Copilot
5. Enable RAG
6. Enable visitor widget
7. Enable SEO assistant
8. Write first SEO draft (guided)

Optional: try Copilot, enable audited agent pipeline.

## Classes

- `src/Application/UseCase/OnboardingService.php`
- `src/Application/Support/BackupStatusService.php`
- `src/Admin/GettingStartedPage.php`
- REST: `GET /onboarding/status`, `POST /onboarding/confirm-backup`
- Tool: `system.backup.status`

## Settings

- `onboarding_dismissed`
- `onboarding_backup_confirmed`

## Verification

```bash
php tests/e2e-onboarding.php
composer test:integration   # OnboardingServiceTest
```