| name | onboarding |
| description | Interactive onboarding wizard — env setup, external service connection, verification, and deployment testing using agent-browser in headed mode. |
| metadata | {"short-description":"Full onboarding wizard"} |
onboarding
Purpose
보일러플레이트의 전체 온보딩을 대화형으로 진행한다.
환경 변수 설정 → 외부 서비스 연결 → 연결 검증 → 앱 기동 확인 → 배포 테스트까지 하나의 플로우로 완료한다.
Phases
| Phase | 파일 | 설명 |
|---|
| 0 | phases/00-status.md | 현재 상태 확인, 의존성 설치, 서비스 선택, 재개 판단 |
| 1 | phases/01-supabase.md | Supabase 프로젝트 생성 + DB 연결 + Seed |
| 2 | phases/02-oauth.md | Google / GitHub OAuth 설정 + 프로덕션 전환 안내 |
| 3 | phases/03-polar.md | Polar 결제/구독 설정 |
| 4 | phases/04-ai.md | OpenAI / Anthropic API 키 설정 |
| 5 | phases/05-email.md | Resend 이메일 설정 |
| 6 | phases/06-admin.md | 관리자 설정 + .env.local 백업 및 생성 |
| 7 | phases/07-verify.md | 모든 연결 검증 + Webhook 엔드포인트 테스트 |
| 8 | phases/08-deploy.md | 앱 기동 + Vercel 환경 변수 싱크 + 배포 테스트 |
실행 규칙
- playbook.md를 먼저 읽는다.
- Phase 0을 로드하여 현재 상태를 파악하고 사용자에게 서비스 선택을 받는다.
- Phase 0에서 중단/재개 여부를 판단한다. 이미 완료된 Phase는 건너뛴다.
- 선택된 서비스의 Phase만 순서대로 로드하여 진행한다. (건너뛴 서비스의 Phase는 로드하지 않는다.)
- Phase 7(검증)과 Phase 8(배포)은 항상 실행한다.
- 각 Phase 파일은 해당 단계 진입 시점에 로드한다. 미리 읽지 않는다.
agent-browser 사용 규칙
- 항상
--headed --session onboarding 플래그를 사용한다.
snapshot -i -c --session onboarding으로 현재 페이지 상태를 파악한다.- 새 서비스 대시보드를 열 때 기존 탭을 재사용한다 (불필요한 창 증가 방지).
- 사용자가 직접 로그인/인증하도록 안내하고, 키 복사 위치를 가이드한다.
- 민감한 정보(비밀번호, API 키)를 절대 로그에 남기지 않는다.
- ⚠️ 브라우저 세션은 모든 Phase가 완전히 끝날 때까지 절대 닫지 않는다.
- 세션을 닫으면 GitHub/Supabase/Vercel 등의 로그인 상태가 사라져 매번 재로그인해야 한다.
agent-browser close --session onboarding은 Phase 8의 최종 온보딩 리포트 출력 후 단 한 번만 실행한다.
Outputs
.env.local 파일 생성/업데이트 (기존 파일은 .env.local.bak으로 백업)- DB migration + seed 실행 완료
- 연결 검증 리포트 (webhook 포함)
- 앱 기동 확인
- 배포 테스트 결과
