🎮 Vibe Validator

Steam 리뷰 기반 게임 아이디어 검증 도구

🔄 워크플로우

flowchart LR
    subgraph Phase1["🎯 Phase 1: 페르소나 생성"]
        A[장르/태그 선택] --> B[Reference 게임 추가]
        B --> C[Steam 리뷰 수집]
        C --> D[Pain/Delight 태깅]
        D --> E[페르소나 도출]
    end
    
    subgraph Phase2["🎨 Phase 2: 크리에이팅"]
        F[아이디어 입력] --> G[🎮 게임 디렉터]
        G --> H[📝 컨텐츠]
        H --> I[⚖️ 밸런스]
        I --> J[⚙️ 시스템]
        J --> K[📊 종합]
    end
    
    subgraph Phase3["✅ Phase 3: QA 검증"]
        L[카테고리별 검증] --> M[이슈 & 개선점]
        M --> N[최종 점수]
        N --> O[권장사항]
    end
    
    Phase1 --> Phase2
    Phase2 --> Phase3
    
    style Phase1 fill:#e8f5e9,stroke:#4caf50
    style Phase2 fill:#fff3e0,stroke:#ff9800
    style Phase3 fill:#e3f2fd,stroke:#2196f3

Loading

flowchart TB
    subgraph Input["📥 입력"]
        I1[게임 아이디어]
        I2[Reference 게임]
        I3[컨텍스트 개입]
    end
    
    subgraph AI["🤖 AI 에이전트"]
        A1[Miner<br/>리뷰 수집]
        A2[Tagger<br/>태깅]
        A3[Synthesizer<br/>페르소나]
        A4[Multi-Agent<br/>크리에이팅]
        A5[QA Agent<br/>검증]
    end
    
    subgraph Output["📤 출력"]
        O1[페르소나 카드]
        O2[기획 문서]
        O3[검증 리포트]
    end
    
    I1 --> A4
    I2 --> A1
    I3 -.->|실시간 반영| AI
    
    A1 --> A2 --> A3 --> O1
    A3 --> A4 --> O2
    A4 --> A5 --> O3

Loading

📋 개요

Vibe Validator는 게임 아이디어를 Steam 리뷰 데이터와 AI 에이전트를 활용하여 체계적으로 검증하는 도구입니다.

🤖 AI 에이전트 컨텍스트

각 에이전트는 이전 단계의 결과물을 컨텍스트로 활용하여 점진적으로 분석을 심화합니다.

flowchart TB
    subgraph Context["📚 컨텍스트 흐름"]
        direction TB
        
        C1["🎮 Reference 게임\n(Steam AppID)"]
        C2["📝 Raw Reviews\n(긍정/부정 리뷰 원문)"]
        C3["🏷️ Tagged Data\n(Pain Points, Delight Points)"]
        C4["👥 Personas\n(목표, 고통점, 이탈 트리거)"]
        C5["💡 아이디어\n(사용자 입력)"]
        C6["📄 기획 문서\n(비전, 기능, 시스템)"]
        
        C1 --> C2 --> C3 --> C4
        C4 --> C6
        C5 --> C6
        C6 --> C7["✅ 검증 리포트"]
    end

Loading

에이전트	입력 컨텍스트	출력	역할
Miner	Steam AppID, 장르 필터	Raw Reviews (JSONL)	Reference 게임의 리뷰를 수집하고 긍정/부정 비율 조절
Tagger	Raw Reviews	Pain/Delight Tags	리뷰에서 불만점과 만족점을 추출하여 태깅
Synthesizer	Tagged Data, 장르	Personas (3-4명)	태그 분포를 기반으로 타겟 유저 페르소나 도출
Game Director	아이디어, Personas	Vision, Key Points	전체 방향성과 핵심 비전 제시
Content Designer	아이디어, Personas, Vision	Features, Suggestions	구체적인 기능과 컨텐츠 제안
Balance Designer	아이디어, Personas, Features	Concerns, Recommendations	밸런스 관점의 우려사항과 권장사항
System Designer	아이디어, Personas, Features	Architecture, Components	기술적 시스템 구조 설계
Synthesizer (PM)	모든 에이전트 출력	종합 의견	에이전트 의견을 통합하여 최종 정리
QA Agent	기획 문서, Personas	검증 리포트	카테고리별 검증 및 개선점 도출

🔄 컨텍스트 누적 방식

[Phase 1]
  Miner: Steam API → 리뷰 수집
  Tagger: 리뷰 + LLM → 태그 추출  
  Synthesizer: 태그 분포 + 장르 → 페르소나
  
[Phase 2]  
  각 에이전트: 아이디어 + 페르소나 + 이전 에이전트 출력 → 기획
  
[Phase 3]
  QA Agent: 전체 기획 + 페르소나 + 사용자 컨텍스트 → 검증

💬 사용자 컨텍스트 개입

사용자가 추가한 컨텍스트는 모든 후속 LLM 호출에 포함됩니다:

[사용자 추가 지시사항]
- "캐주얼 유저 중심으로 분석해줘"
- "모바일 환경도 고려해줘"

위 사항을 고려해서 분석해주세요.

이를 통해 분석 방향을 실시간으로 조정할 수 있습니다.

주요 기능

• Phase 1: 페르소나 생성

  • Reference 게임의 Steam 리뷰 수집
  • Pain Point / Delight Point 태깅
  • 타겟 유저 페르소나 자동 도출

• Phase 2: 크리에이팅

  • 🎮 게임 디렉터: 전체 비전 및 방향성
  • 📝 컨텐츠 디자이너: 기능 제안
  • ⚖️ 밸런스 디자이너: 밸런스 검토
  • ⚙️ 시스템 디자이너: 시스템 아키텍처
  • 📊 종합: 에이전트 의견 통합

• Phase 3: QA 검증

  • 카테고리별 검증 (밸런스, UX, 기술, 운영, 수익화)
  • 이슈 및 개선점 도출
  • 최종 점수 및 권장사항

🚀 시작하기

1. 요구사항

• Python 3.9+
• 웹 브라우저 (Chrome 권장)

2. 설치

# 저장소 클론
git clone https://github.com/your-username/IdeationHelper.git
cd IdeationHelper

# 의존성 설치
pip install -r requirements.txt

3. 실행

Web UI (권장)

# 브라우저에서 직접 열기
start ui/index.html   # Windows
open ui/index.html    # macOS

CLI

python main.py

4. API 키 설정

UI 우측 상단의 ⚙️ 설정 버튼을 클릭하여 API 키를 입력하세요:

• OpenAI: sk-...
• Anthropic: sk-ant-...
• Google AI (Gemini): AIza...

⚠️ API 키는 브라우저 로컬에만 저장되며, 서버로 전송되지 않습니다.

📁 프로젝트 구조

IdeationHelper/
├── ui/
│   └── index.html      # Web UI (단일 파일)
├── src/
│   ├── agents/         # AI 에이전트
│   │   ├── miner.py    # 리뷰 수집
│   │   ├── tagger.py   # 태깅
│   │   ├── synthesizer.py
│   │   └── editor.py
│   ├── config.py
│   └── data/
│       └── persona_frameworks.json
├── docs/
│   ├── ui_specification.md
│   └── screenshot.png
├── output/             # 생성된 결과물 (gitignore)
├── config.yaml         # 설정 파일
├── main.py
├── requirements.txt
└── README.md

⚙️ 설정

config.yaml에서 프리셋을 선택할 수 있습니다:

프리셋	리뷰 수	용도
free	30개/게임	빠른 테스트
standard	100개/게임	일반 사용 (권장)
detailed	300개/게임	꼼꼼한 분석

🎯 사용 흐름

1. 장르/태그 선택
2. Reference 게임 추가 (Steam AppID)
3. Phase 1 실행 → 페르소나 생성
4. 아이디어 입력
5. Phase 2 실행 → 크리에이팅
6. Phase 3 실행 → QA 검증
7. 결과 확인 및 개선점 검토

🔧 컨텍스트 개입

분석 중 언제든 우측 패널에서 컨텍스트를 추가할 수 있습니다:

• "캐주얼 유저 중심으로 분석해줘"
• "모바일 환경도 고려해줘"
• "F2P 모델 기준으로 분석해줘"

📝 License

MIT License

🤝 Contributing

이슈 및 PR 환영합니다!