Moodify Development Operations

협업·통합·배포 운영 가이드

Gemini, Codex, Claude의 작업을 안전하게 하나의 제품으로 연결하는 기준

v3.1 · 2026-09-07

세 담당자의 역할

◆

Gemini

UI/UX, 레이아웃, 색상, 애니메이션과 디자인을 담당합니다. 전용 브랜치에서 로컬 개발·빌드·미리보기까지만 수행하며 main 병합과 운영 배포는 하지 않습니다.

로컬 5173 · 배포 금지
⌘

Codex

검색·재생·저장·권한·버그 수정과 전체 변경 통합, 프로덕션 빌드 검증 및 승인된 웹 운영 배포를 담당합니다.

통합 · 검증 · 웹 배포
▲

Claude

확정된 main 커밋으로 Android/iOS를 빌드·서명하고 스토어에 제출합니다.

Android / iOS

한눈에 보는 전체 흐름

Gemini UI 브랜치5173에서 디자인 확인
커밋·브랜치 푸시
＋
Codex 로직 브랜치5181 등에서 기능 확인
커밋·브랜치 푸시
Codex 최종 통합·검증최신 변경 확인 → 승인된 변경 병합 → 충돌·누락 검사 → 검색·재생·저장 영향 확인 → 프로덕션 빌드
↓
GitHub main웹과 앱이 함께 사용하는 유일한 최종 배포 기준
→
Cloudflare Pages검증된 main에서 보호된 배포 실행
Production 환경·SHA 확인
→
Moodify 웹ai-moodify.pages.dev
→
Claude 앱 빌드확정된 main SHA 체크아웃
Android/iOS 빌드·서명
→
스토어 배포Google Play / App Store

환경별 의미

localhost:5173

Gemini UI/UX 작업의 미리보기입니다. 운영 서버가 아닙니다.

localhost:5181 등

Codex 로직 작업의 미리보기입니다. 안내된 포트는 작업마다 달라질 수 있습니다.

GitHub main

승인된 UI와 로직을 모두 포함하며 웹 배포와 앱 빌드의 기준입니다.

권장 배포 절차

  1. Gemini와 Codex가 각자 전용 브랜치에서 작업하고 로컬 미리보기를 제공합니다. Gemini는 npm run dev, npm run build, npm run preview까지만 실행합니다.
  2. 사용자가 UI와 기능을 확인하고 반영을 승인합니다.
  3. 각 담당자가 자신의 변경만 커밋하고 브랜치에 푸시합니다.
  4. Codex가 최신 main과 Gemini 변경을 확인한 뒤 승인된 변경만 통합합니다.
  5. 충돌·누락과 프로덕션 빌드를 확인하고 사용자 승인 후 main에 푸시합니다.
  6. 깨끗한 main에서 HEAD와 origin/main이 같은지 확인한 뒤 npm run deploy를 실행합니다.
  7. Cloudflare Production 환경, 운영 URL HTTP 200, 최신 자산과 배포 SHA가 최종 main과 같은지 확인합니다.
  8. Claude에게 확정 SHA를 전달하고 동일한 소스로 앱을 빌드합니다.
  9. 앱 버전과 업데이트 정책을 맞춘 뒤 스토어에 제출합니다.

배포 권한과 자동 차단 조건

Gemini가 실행하지 않는 작업

  • npm run deploy, wrangler pages deploy 등 배포 명령
  • Cloudflare 대시보드/API 배포와 운영 환경 변수 변경
  • Cloudflare API 토큰 생성·조회·복사·사용
  • main 병합·푸시와 배포 보호 절차 우회

운영 배포 통과 조건

  • 현재 브랜치가 main일 것
  • 작업 트리에 미커밋 변경이 없을 것
  • 현재 HEAD가 origin/main과 정확히 일치할 것
  • 작업 브랜치 Preview가 아닌 Cloudflare Production으로 등록될 것

배포 스크립트가 조건 불일치로 중단되면 우회하지 않습니다. Gemini는 브랜치와 테스트 결과를 Codex에 전달하고, Codex가 통합·검증·승인 절차를 마친 뒤 운영에 반영합니다.

배포 전 체크

변경 보존

Gemini UI와 Codex 로직이 모두 포함됐는지 확인합니다.

기술 검증

충돌·관계없는 파일·프로덕션 빌드 결과를 확인합니다.

버전 일치

main, Cloudflare webVersion, Claude 빌드 SHA를 일치시킵니다.

Claude에게 전달할 정보

항목전달 내용
브랜치main
커밋확정된 전체 SHA
변경 요약포함된 Gemini UI와 Codex 로직
앱 버전Android versionName/versionCode 및 iOS version/build
업데이트 정책스토어 공개 버전과 update-policy.json 일치

핵심 원칙

5173 = Gemini UI 확인5181 등 = Codex 로직 확인main = 유일한 배포 기준

로컬 서버 중 하나를 그대로 배포하지 않습니다. 승인된 UI와 로직을 합친 main을 Cloudflare와 Claude가 함께 사용해야 합니다.