rn-harness-generator

rn-harness-generator — Phase 5: 앱 빌드

계약 기준에 따라 React Native + Expo 앱을 빌드한다.

Trigger

오케스트레이터에서 Phase 5 (Generator)로 호출됨.

Input

• docs/harness/contract.md (완료 기준)
• docs/harness/plans/YYYY-MM-DD-prd.md (PRD)
• docs/harness/plans/YYYY-MM-DD-design.md (디자인)
• docs/harness/feedback/round-N-*.md (Round 2+ 시 Evaluator 피드백)

Process

Round 1: 전체 빌드

Step 1: Project Scaffolding

Read app_slug and workspace_dir from docs/harness/config.md / state.md (set during Phase 2). Until now the pipeline has been running in the staging folder .rn-harness/$RUN_ID/. This phase graduates it to a top-level Expo project named $APP_SLUG and moves the harness artifacts inside — so each run ends up as its own clean project folder with no shared root docs/.

# Run from the run-directory root (parent of .rn-harness/).
# $APP_SLUG = kebab-case app name from config.md (e.g., budget-book)
# $RUN_ID   = staging id from state.md (e.g., run-20260709-113045)

npx create-expo-app@latest "$APP_SLUG"          # creates ./$APP_SLUG (its own git repo)
mv ".rn-harness/$RUN_ID/docs" "$APP_SLUG/docs"  # move all harness artifacts in
rm -rf ".rn-harness/$RUN_ID"                     # remove now-empty staging
rmdir .rn-harness 2>/dev/null || true            # remove container if no other runs

cd "$APP_SLUG"
mkdir -p credentials

# Record the graduated location so later phases + resume cd here.
# state.md → workspace_dir: $APP_SLUG

NOTE: Always use npx create-expo-app@latest to get the latest Expo SDK version. NOTE: After graduation, all artifacts live inside $APP_SLUG/docs/harness/ (one git repo). Update state.md workspace_dir to $APP_SLUG — Phase 6+ and --resume rely on it. The run-directory retains only .claude/ and any other runs still staging under .rn-harness/.

Step 1.1: Clean Up Default Template Files (MANDATORY)

Remove unused default files generated by create-expo-app:

# Remove default reset script
rm -f scripts/reset-project.js
rmdir scripts 2>/dev/null || true

# Remove default template images (will be replaced with app-specific assets)
rm -f assets/images/partial-react-logo.png
rm -f assets/images/react-logo.png
rm -f assets/images/[email protected]
rm -f assets/images/[email protected]

# Remove default example components/screens if they exist
rm -rf components/__tests__/
rm -f components/EditScreenInfo.tsx
rm -f components/ExternalLink.tsx
rm -f components/HelloWave.tsx
rm -f components/ParallaxScrollView.tsx
rm -f components/ThemedText.tsx
rm -f components/ThemedView.tsx
rm -f components/Collapsible.tsx
rm -f components/HapticTab.tsx
rm -rf components/ 2>/dev/null || true

# Remove default tab screens (will be rewritten)
rm -f app/(tabs)/explore.tsx
rm -f app/(tabs)/index.tsx
rm -f app/+not-found.tsx
rm -f app/+html.tsx

# Remove default constants
rm -f constants/Colors.ts
rm -rf constants/ 2>/dev/null || true

# Remove default hooks
rm -f hooks/useColorScheme.ts
rm -f hooks/useColorScheme.web.ts
rm -f hooks/useThemeColor.ts
rm -rf hooks/ 2>/dev/null || true