fosejary/product-factory

Product Factory — MVP에서 완성된 프로덕트로

MVP 코드베이스를 감사하고, 기능 추가 + 프로덕션 강화 + 성능 최적화 + 그로스를 병렬 수행한 뒤, QA 검증을 거쳐 릴리스 가능한 프로덕트를 만드는 오케스트레이터.

실행 모드: 파이프라인 + 팬아웃 (팀 재구성)

Phase 1은 서브 에이전트(감사), Phase 2는 에이전트 팀(4명 병렬), Phase 3은 서브 에이전트(QA)로 실행한다.

에이전트 구성

| 에이전트 | 타입 | 역할 | 스킬 | Phase | |---------|------|------|------|-------| | mvp-auditor | mvp-auditor | MVP 감사 | mvp-audit | 1 | | feature-engineer | feature-engineer | 기능 추가 | feature-expansion | 2 | | production-engineer | production-engineer | 프로덕션 강화 | production-hardening | 2 | | performance-engineer | performance-engineer | 성능 최적화 | performance-optimize | 2 | | growth-engineer | growth-engineer | 그로스 기능 | growth-engineering | 2 | | qa-engineer | qa-engineer | QA 검증 | qa-testing | 3 |

전제 조건

이 하네스는 MVP Factory(mvp-factory)가 생성한 산출물이 존재한다고 가정한다:

• 프로젝트 루트에 React Native (Expo) 코드
• _workspace/00_input.md ~ _workspace/05_aso_listing.md

_workspace/가 없는 프로젝트에도 사용 가능하지만, 감사 범위가 코드 분석에 한정된다.

워크플로우

Phase 0: 준비

1. 사용자 입력 분석 — 추가 기능 요구사항, 강화 우선순위 파악
2. 기존 _workspace/ 존재 여부 확인
3. _workspace/00_product_input.md에 Product Factory 입력 저장:

   # Product Factory Input
   - 추가 기능 요구사항: {requirements}
   - 우선순위: {priorities}
   - 생성일: {date}
   

Phase 1: MVP 감사 (서브 에이전트)

실행 방식: 순차 — 감사 결과가 Phase 2 전체의 작업 범위를 결정

Agent(
  description: "MVP 코드베이스 감사",
  prompt: "프로젝트 루트의 React Native 코드와 _workspace/ 파일들을 분석하라. .claude/skills/mvp-audit/skill.md를 Read로 읽고 감사 프로세스를 따르라. _workspace/00_product_input.md에 사용자 추가 요구사항이 있으면 Phase 2 재평가에 반영하라. 결과를 _workspace/06_audit_report.md에 저장하라.",
  subagent_type: "mvp-auditor",
  model: "opus"
)

산출물: | 파일 | 내용 | |------|------| | _workspace/06_audit_report.md | 감사 보고서 + 우선순위 매트릭스 + 에이전트별 작업 할당 |

Phase 2: 병렬 강화 (에이전트 팀)

실행 방식: 팬아웃 — 4명이 동시 작업, 발견 공유 및 충돌 조율

1. 팀 생성:

   TeamCreate(
     team_name: "product-team",
     members: [
       {
         name: "feature-engineer",
         agent_type: "feature-engineer",
         model: "opus",
         prompt: "_workspace/06_audit_report.md를 읽고 할당된 기능 추가 작업을 수행하라. .claude/skills/feature-expansion/skill.md를 Read로 읽고 프로세스를 따르라. 새 기능 추가 시 production-engineer에게 SendMessage로 알려 에러 핸들링/보안 적용을 요청하라. performance-engineer에게는 무거운 UI 추가 시 알리고, growth-engineer에게는 트래킹 포인트를 공유하라. 결과를 _workspace/07_feature_report.md에 저장하라."
       },
       {
         name: "production-engineer",
         agent_type: "production-engineer",
         model: "opus",
         prompt: "_workspace/06_audit_report.md를 읽고 할당된 프로덕션 강화 작업을 수행하라. .claude/skills/production-hardening/skill.md를 Read로 읽고 프로세스를 따르라. feature-engineer가 추가한 새 기능에도 에러 핸들링과 보안을 적용하라. 결과를 _workspace/08_production_report.md에 저장하라."
       },
       {
         name: "performance-engineer",
         agent_type: "performance-engineer",
         model: "opus",
         prompt: "_workspace/06_audit_report.md를 읽고 할당된 성능 최적화 작업을 수행하라. .claude/skills/performance-optimize/skill.md를 Read로 읽고 프로세스를 따르라. feature-engineer가 추가한 화면도 성능 검증하라. 결과를 _workspace/09_performance_report.md에 저장하라."
       },
       {
         name: "growth-engineer",
         agent_type: "growth-engineer",
         model: "opus",
         prompt: "_workspace/06_audit_report.md와 _workspace/01_research_market.md를 읽고 그로스 기능을 구현하라. .claude/skills/growth-engineering/skill.md를 Read로 읽고 프로세스를 따르라. feature-engineer가 공유한 새 기능의 트래킹 이벤트도 추가하라. 결과를 _workspace/10_growth_report.md에 저장하라."
       }
     ]
   )
   

2. 작업 등록:

   TaskCreate(tasks: [
     { title: "Phase 2 기능 구현", description: "감사 보고서의 기능 추가 항목 구현", assignee: "feature-engineer" },
     { title: "보안 강화", description: "RLS, 입력 검증, 인증 보안 강화", assignee: "production-engineer" },
     { title: "에러 핸들링", description: "글로벌 에러 바운더리, Supabase 에러 처리", assignee: "production-engineer" },
     { title: "크래시 리포팅", description: "Sentry 또는 Crashlytics 설정", assignee: "production-engineer" },
     { title: "결제/푸시 설정", description: "결제 연동 + 푸시 알림 설정 코드 + 가이드", assignee: "production-engineer" },
     { title: "렌더링 최적화", description: "memo, 리렌더 제거, 리스트 가상화", assignee: "performance-engineer" },
     { title: "번들/네트워크 최적화", description: "번들 크기, 이미지, 쿼리 최적화", assignee: "performance-engineer" },
     { title: "분석 계측", description: "Firebase Analytics 이벤트 설정", assignee: "growth-engineer" },
     { title: "리텐션 기능", description: "리마인더, 스트릭, 온보딩 최적화", assignee: "growth-engineer" }
   ])
   

3. 팀원들이 자체 조율하며 병렬 작업 수행

팀원 간 통신 규칙:

• feature-engineer → production-engineer: 새 API/DB 변경 시 SendMessage (에러 핸들링+보안 적용 요청)
• feature-engineer → performance-engineer: 무거운 기능 추가 시 SendMessage (최적화 요청)
• feature-engineer → growth-engineer: 새 기능 완성 시 SendMessage (트래킹 이벤트 요청)
• production-engineer ↔ growth-engineer: 푸시 알림 + 리텐션 메시지 전략 조율
• production-engineer ↔ performance-engineer: 캐싱/오프라인 전략 중복 방지

4. 모든 팀원 완료 시 산출물 확인
5. 팀 정리

산출물: | 파일 | 내용 | |------|------| | _workspace/07_feature_report.md | 추가된 기능 보고서 | | _workspace/08_production_report.md | 프로덕션 강화 보고서 | | _workspace/09_performance_report.md | 성능 최적화 보고서 | | _workspace/10_growth_report.md | 그로스 엔지니어링 보고서 |

Phase 3: QA 검증 (서브 에이전트)

실행 방식: 순차 — Phase 2 결과 전체를 검증

Agent(
  description: "통합 정합성 QA 검증",
  prompt: "프로젝트 코드 전체와 _workspace/06~10 보고서를 읽고 통합 정합성을 검증하라. .claude/skills/qa-testing/skill.md를 Read로 읽고 검증 프로세스를 따르라. 특히 경계면 교차 비교(Supabase 쿼리↔타입, 라우트 경로↔네비게이션, 스토어↔컴포넌트)를 철저히 수행하라. 발견한 버그는 직접 수정하고, 테스트 코드를 __tests__/에 추가하라. 결과를 _workspace/11_qa_report.md에 저장하라.",
  subagent_type: "qa-engineer",
  model: "opus"
)

산출물: | 파일 | 내용 | |------|------| | __tests__/ | 테스트 코드 | | _workspace/11_qa_report.md | QA 검증 보고서 + 릴리스 판정 |

Phase 4: 릴리스 준비 + 종합 보고

1. 모든 Phase의 산출물을 Read로 수집
2. QA 판정 확인:
   • 릴리스 가능 → Phase 4 진행
   • 조건부 → 미해결 P1 항목 목록 제시, 사용자 판단 요청
   • 불가 → P0 버그 목록 제시, 수정 후 QA 재실행 권고
3. _workspace/PRODUCT_SUMMARY.md에 종합 보고서 생성:

   # Product Factory 결과 요약
   
   ## 프로덕트 개요
   - 앱 이름:
   - 원래 MVP 범위:
   - 추가된 기능:
   
   ## 감사 → 해결 매트릭스
   | 감사 항목 | 우선순위 | 담당 | 해결 여부 |
   |----------|---------|------|----------|
   
   ## 추가된 기능 (Feature)
   (07_feature_report 핵심 요약)
   
   ## 프로덕션 강화 (Production)
   (08_production_report 핵심 요약)
   
   ## 성능 최적화 (Performance)
   (09_performance_report 핵심 요약)
   
   ## 그로스 기능 (Growth)
   (10_growth_report 핵심 요약)
   
   ## QA 결과
   (11_qa_report 핵심 요약)
   
   ## 사용자 설정 필요 항목
   - [ ] Supabase 프로젝트 환경변수
   - [ ] Firebase 프로젝트 설정
   - [ ] Google Play Console 설정
   - [ ] 결제 상품 등록
   - [ ] 푸시 알림 키 설정
   
   ## 빌드 & 출시
   1. eas build --platform android
   2. eas submit --platform android
   
   ## 다음 단계
   (추가 개선 권장 사항)
   

4. 사용자에게 결과 요약 보고

데이터 흐름

[MVP 코드 + _workspace/]
        |
   Phase 1 (서브 에이전트)
   mvp-auditor
        |
   06_audit_report.md
        |
+--- Phase 2 (에이전트 팀 4명) ---+
| feature  <-> production          |
| engineer     engineer            |
|    ^            ^                |
|    |            |                |
|    v            v                |
| growth   <-> performance         |
| engineer     engineer            |
|    |            |                |
| 07_feature  08_production        |
| 09_perf     10_growth            |
+----------------------------------+
        |
   Phase 3 (서브 에이전트)
   qa-engineer
        |
   11_qa_report.md + __tests__/
        |
   Phase 4 (리더)
   PRODUCT_SUMMARY.md

에러 핸들링

| 상황 | 전략 | |------|------| | Phase 1 감사 실패 | 1회 재시도. 재실패 시 코드 레벨 분석만으로 기본 감사 보고서 생성 | | Phase 2 팀원 1명 실패 | 나머지 팀원 결과로 진행, QA에서 해당 영역 미검증 명시 | | Phase 2 팀원 간 코드 충돌 | 마지막 수정 기준, QA에서 충돌 영역 검증 | | Phase 3 QA 불가 판정 | P0 버그 목록과 수정 제안을 사용자에게 보고, 수정 후 QA 재실행 권고 | | _workspace/ 미존재 | Phase 1에서 코드만으로 감사, Phase 2에서 사용자 요구사항 기반으로 작업 |

테스트 시나리오

정상 흐름

1. 사용자: "이 MVP를 프로덕트로 완성해줘. 소셜 로그인이랑 다크모드도 추가해줘"
2. Phase 0: 입력 파싱, 00_product_input.md 생성
3. Phase 1: mvp-auditor가 코드 + _workspace 분석 → 감사 보고서 생성
4. Phase 2: 4명 팀 구성 → 병렬 작업 (기능 추가 + 보안 + 성능 + 그로스)
5. Phase 3: qa-engineer가 전체 검증 → "릴리스 가능" 판정
6. Phase 4: PRODUCT_SUMMARY.md 생성
7. 예상 산출물: 강화된 프로젝트 코드 + 테스트 코드 + _workspace/ 보고서 6개

에러 흐름

1. Phase 2에서 performance-engineer가 최적화 중 에러로 중지
2. 나머지 3명(feature, production, growth) 결과로 Phase 3 진행
3. qa-engineer가 성능 관련 검증을 "미검증"으로 표기
4. PRODUCT_SUMMARY.md에 "성능 최적화 미완료" 명시
5. 사용자에게 수동 성능 검토 권고

부분 실행

사용자가 특정 Phase만 요청할 수 있다:

• "감사만 해줘" → Phase 0 + Phase 1만 실행
• "QA만 돌려줘" → Phase 3만 실행
• "기능만 추가해줘" → feature-engineer만 서브 에이전트로 실행