onboarding

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 환경 변수 싱크 + 배포 테스트

실행 규칙

1. playbook.md를 먼저 읽는다.
2. Phase 0을 로드하여 현재 상태를 파악하고 사용자에게 서비스 선택을 받는다.
3. Phase 0에서 중단/재개 여부를 판단한다. 이미 완료된 Phase는 건너뛴다.
4. 선택된 서비스의 Phase만 순서대로 로드하여 진행한다. (건너뛴 서비스의 Phase는 로드하지 않는다.)
5. Phase 7(검증)과 Phase 8(배포)은 항상 실행한다.
6. 각 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 포함)
• 앱 기동 확인
• 배포 테스트 결과