tjdrhs90/rn-launch-harness/rn-harness-acceptance

rn-harness-acceptance — Phase 7.5: User Acceptance Gate

The last checkpoint before irreversible work (store build → submission). The agent Evaluator (Phase 6) already judged that the app works; this phase asks a different question a machine can't answer: "is this the app the user actually wanted, and are they OK shipping it?"

Runs after AdMob (Phase 7) so the user reviews the real, ad-integrated app, and before Build (Phase 8) so nothing gets built or submitted without an explicit human yes.

Evaluator PASS → AdMob → [👤 THIS PHASE] → Build → Screenshots → Submit

Trigger

Called by the orchestrator as Phase 7.5. Skipped only if config.md → skip_acceptance: true (e.g. unattended CI) — and even then, log loudly that a human gate was bypassed.

Input

• Project code (AdMob integration complete)
• docs/harness/plans/YYYY-MM-DD-prd.md (PRD — core user journeys)
• docs/harness/config.md

Two parts

Part 1: Automated E2E Smoke (objective floor)

Give the human a known-good starting point — don't ask them to approve an app that fails its own core flows.

Why Maestro: the screenshot phase already uses it, so it's a cheap add. Maestro drives the real app on a simulator/emulator via YAML flows. (Alternatives: Detox — RN-specific, heavier setup; Appium — cross-platform, heaviest. Default to Maestro here.)

1. Launch the app (AdMob = native module → Expo Go will crash; use a dev client / native run):

``bash # iOS (macOS + Xcode) npx expo run:ios # Android (SDK + emulator) npx expo run:android ``

1. Create/reuse E2E flows under .maestro/ — one flow per core user journey from the PRD. Keep them smoke-level (does the happy path work end to end), not exhaustive:

```yaml # .maestro/smoke_core.yaml appId: com.company.app

• launchApp
• assertVisible: "<home screen anchor text>"
• tapOn: "<primary CTA>"
• assertVisible: "<expected next screen>"

# ...one block per PRD journey (create, list, edit, navigate, etc.) ```

1. Run the flows:

``bash maestro test .maestro/ ``

1. Report per-flow pass/fail. Any failure → this is a bug the Evaluator missed: hand back to Generator with the failing flow as evidence, then re-run. Do not advance to the human step on a red smoke test (unless the user explicitly overrides).

This is automated regression coverage — it answers "does it still work," not "is it good." That second question is Part 2.

Part 2: Human Acceptance PAUSE (subjective judgment)

Set state.md status to paused, then AskUserQuestion:

앱이 기능 QA + E2E 스모크를 통과했습니다. 스토어 빌드/제출 전에 직접 확인해 주세요.
 
▶ 실행 방법:
  npx expo run:ios      # 또는
  npx expo run:android
  (AdMob 통합 상태라 Expo Go 아님 — 위 명령으로 dev 빌드 실행)
 
▶ 자동 E2E 스모크 결과:
  [flow별 PASS/FAIL 요약]
 
▶ iOS 라면 앱을 지웠다가 다시 깔고 첫 실행을 꼭 보세요:
  AdMob 동의 안내가 **혼자** 뜨고, '계속'을 누른 뒤에 추적 권한이 떠야 합니다.
  두 개가 한꺼번에 뜨면 순서가 깨진 것입니다 (Phase 7 admob 스킬 참고).
 
직접 써보고 아래에서 선택하세요:

• "수정 요청" 선택 시 구체적으로 무엇을 고칠지 사용자 입력을 받아 feedback 파일로 저장하고 Generator에 핸드오프.
• 승인 전에는 어떤 빌드/제출 명령도 실행 금지.

Output

docs/harness/handoff/acceptance-result.md:

# User Acceptance — Phase 7.5
 
## Automated E2E (Maestro)
-Flows run: [N]
-Passed: [N] / Failed: [N]
-Failing flows: [list or none]
 
## Human Decision
-Result: [APPROVED / CHANGES_REQUESTED / ABORTED]
-Reviewed on: [simulator/device]
-Feedback (if changes requested): [text → docs/harness/feedback/...]
-Approved by: user

State Update

On approval:

current_phase: build
next_role: rn-harness-build   # or rn-harness-build-local per config build.method

On changes requested:

current_phase: generator
next_role: rn-harness-generator

HARD GATES

• E2E smoke must PASS before presenting the app for approval (or user explicitly overrides a known failure)
• No build or submission command runs before explicit user approval — this is the whole point of the gate
• AdMob apps: never launch via Expo Go (crashes) — use expo run:* / dev client
• "Changes requested" must capture concrete feedback and route back to Generator, not silently loop
• If skip_acceptance: true, log a loud warning that the human gate was bypassed