claude-symphony 0.0.1

package/template/stages/01-brainstorm/HANDOFF.md.template

@@ -0,0 +1,112 @@
+# Stage Handoff: 01-brainstorm → 02-research
+
+**생성일**: {{TIMESTAMP}}
+**생성자**: {{MODEL}}
+**소요 시간**: {{DURATION}}
+
+---
+
+## 완료된 작업
+
+- [ ] 프로젝트 브리프 분석
+- [ ] 브레인스토밍 ({{IDEA_COUNT}}개 아이디어)
+- [ ] 사용자 페르소나 생성 ({{PERSONA_COUNT}}개)
+- [ ] 요구사항 분석
+- [ ] MVP 범위 정의
+- [ ] HANDOFF.md 생성
+
+---
+
+## 다음 에이전트를 위한 컨텍스트
+
+### 핵심 결정사항
+
+| 결정 | 이유 | 되돌릴 수 있음 |
+|------|------|----------------|
+| {{DECISION_1}} | {{REASON_1}} | Yes/No |
+| {{DECISION_2}} | {{REASON_2}} | Yes/No |
+
+### 성공한 접근법
+- {{SUCCESSFUL_APPROACH_1}}
+- {{SUCCESSFUL_APPROACH_2}}
+
+### 실패한 접근법
+- {{FAILED_APPROACH_1}}: {{FAILURE_REASON_1}}
+
+### 우선순위 아이디어 (Top 5)
+1. **{{IDEA_1}}** - {{IDEA_1_VALUE}}
+2. **{{IDEA_2}}** - {{IDEA_2_VALUE}}
+3. **{{IDEA_3}}** - {{IDEA_3_VALUE}}
+4. **{{IDEA_4}}** - {{IDEA_4_VALUE}}
+5. **{{IDEA_5}}** - {{IDEA_5_VALUE}}
+
+### MVP 핵심 기능
+1. {{MVP_FEATURE_1}}
+2. {{MVP_FEATURE_2}}
+3. {{MVP_FEATURE_3}}
+
+---
+
+## 생성된 산출물
+
+| 파일 | 설명 | 위치 |
+|------|------|------|
+| ideas.md | 브레인스토밍 아이디어 | `outputs/ideas.md` |
+| requirements_analysis.md | 요구사항 분석 | `outputs/requirements_analysis.md` |
+| personas.md | 사용자 페르소나 | `outputs/personas.md` (선택) |
+
+---
+
+## 02-research 스테이지 가이드
+
+### 즉시 실행할 작업
+1. `outputs/requirements_analysis.md` 읽고 MVP 범위 확인
+2. 우선순위 아이디어 기술 스택 리서치
+3. 경쟁사 심층 분석
+
+### 리서치 우선순위
+1. {{RESEARCH_PRIORITY_1}}
+2. {{RESEARCH_PRIORITY_2}}
+3. {{RESEARCH_PRIORITY_3}}
+
+### 검증 필요 가정
+- {{ASSUMPTION_1}}
+- {{ASSUMPTION_2}}
+
+### 권장 MCP 서버
+- `firecrawl`: 웹 크롤링
+- `exa`: AI 검색
+- `context7`: 문서 검색
+
+---
+
+## 체크포인트 참조
+> 이 스테이지는 체크포인트가 필요하지 않습니다.
+
+---
+
+## AI 호출 기록
+
+| AI | 호출 시간 | 프롬프트 | 결과 | 상태 |
+|----|----------|---------|------|------|
+| {{AI_1}} | {{TIME_1}} | {{PROMPT_1}} | {{OUTPUT_1}} | {{STATUS_1}} |
+| {{AI_2}} | {{TIME_2}} | {{PROMPT_2}} | {{OUTPUT_2}} | {{STATUS_2}} |
+
+> 설정: `config/ai_logging.yaml`
+
+---
+
+## 메타데이터
+
+```yaml
+stage: "01-brainstorm"
+status: "completed"
+next_stage: "02-research"
+models_used:
+  - gemini
+  - claudecode
+tokens_used: {{TOKENS_USED}}
+outputs_generated:
+  - ideas.md
+  - requirements_analysis.md
+```

package/template/stages/01-brainstorm/README.md

@@ -0,0 +1,97 @@
+# Stage 01: Brainstorming
+
+발산적 아이디어 생성 및 요구사항 탐색
+
+## 개요
+
+이 스테이지는 프로젝트의 시작점으로, 창의적 아이디어 발산과 초기 요구사항 분석을 수행합니다.
+
+## 실행 모델
+
+| 역할 | 모델 | 목적 |
+|------|------|------|
+| Primary | Gemini | 창의적 아이디어 생성, 웹 리서치 |
+| Secondary | ClaudeCode | 구조화, 실현 가능성 검토 |
+
+## 시작하기
+
+### 1. 입력 파일 준비
+
+```bash
+# 프로젝트 브리프 작성
+cp templates/project_brief.md inputs/project_brief.md
+# 편집 후 내용 채우기
+```
+
+### 2. 스테이지 실행
+
+```bash
+# 방법 1: 슬래시 커맨드
+/run-stage 01-brainstorm
+
+# 방법 2: 스크립트 직접 실행
+../../scripts/run-stage.sh 01-brainstorm
+```
+
+### 3. 수동 워크플로우
+
+```bash
+# Step 1: Gemini로 아이디어 발산
+/gemini "$(cat prompts/ideation.md)"
+
+# Step 2: 결과를 outputs/ideas.md에 저장
+
+# Step 3: 요구사항 분석
+# ClaudeCode가 자동 수행
+
+# Step 4: HANDOFF.md 생성
+/handoff
+```
+
+## 디렉토리 구조
+
+```
+01-brainstorm/
+├── README.md           # 이 파일
+├── CLAUDE.md           # AI 지침
+├── config.yaml         # 스테이지 설정
+├── prompts/
+│   ├── ideation.md     # 아이디어 발산 프롬프트
+│   ├── persona.md      # 페르소나 생성 프롬프트
+│   └── requirements.md # 요구사항 분석 프롬프트
+├── templates/
+│   ├── ideas.md        # 아이디어 출력 템플릿
+│   └── requirements_analysis.md  # 요구사항 출력 템플릿
+├── inputs/             # 입력 파일
+├── outputs/            # 출력 파일
+├── HANDOFF.md.template # 핸드오프 템플릿
+└── HANDOFF.md          # 생성된 핸드오프 (완료 시)
+```
+
+## 완료 조건
+
+- [ ] 최소 10개 아이디어 생성
+- [ ] 3개 이상 사용자 페르소나 정의
+- [ ] 요구사항 분석 문서 완성
+- [ ] MVP 범위 정의
+- [ ] HANDOFF.md 생성
+
+## 출력물
+
+| 파일 | 설명 |
+|------|------|
+| `outputs/ideas.md` | 브레인스토밍 아이디어 목록 |
+| `outputs/requirements_analysis.md` | 요구사항 분석 결과 |
+| `outputs/personas.md` | 사용자 페르소나 (선택) |
+| `HANDOFF.md` | 다음 스테이지 인계 문서 |
+
+## 다음 스테이지
+
+**→ 02-research**: 기술 리서치 및 시장 분석
+
+## 팁
+
+1. **발산적 사고**: 이 단계에서는 아이디어 제한 없이 자유롭게
+2. **모든 것을 기록**: 나중에 재검토할 수 있도록
+3. **Gemini 활용**: 웹 검색이 필요한 경쟁사 분석에 활용
+4. **구조화는 나중에**: ClaudeCode가 구조화 담당

package/template/stages/01-brainstorm/config.yaml

@@ -0,0 +1,92 @@
+# Stage 01: Brainstorming Configuration
+
+stage:
+  id: "01-brainstorm"
+  name: "Brainstorming"
+  description: "발산적 아이디어 생성 및 요구사항 탐색"
+
+# Model Assignment
+models:
+  primary: "gemini"
+  secondary: "claudecode"
+  collaboration: "parallel"  # parallel | sequential | handoff
+
+# AI 자동 호출 설정 (Issue #12 해결)
+auto_invoke:
+  enabled: true
+  model: "gemini"
+  trigger: "stage_start"
+  prompt_file: "prompts/ideation.md"
+  wrapper: "scripts/gemini-wrapper.sh"
+  required: true
+  message: "🤖 Gemini 자동 호출: 발산적 아이디어 생성 시작"
+
+# Execution Mode
+execution:
+  mode: "yolo"
+  container: true
+  sandbox: false
+  timeout: 3600  # 1 hour
+
+# Input/Output Definitions
+inputs:
+  required:
+    - name: "project_brief.md"
+      description: "프로젝트 개요 및 목표"
+      schema: null
+  optional:
+    - name: "user_requirements.md"
+      description: "초기 사용자 요구사항"
+    - name: "reference_materials/"
+      description: "참고 자료 디렉토리"
+
+outputs:
+  required:
+    - name: "ideas.md"
+      description: "브레인스토밍 아이디어 목록"
+      template: "templates/ideas.md"
+    - name: "requirements_analysis.md"
+      description: "요구사항 분석 결과"
+      template: "templates/requirements_analysis.md"
+    - name: "HANDOFF.md"
+      description: "다음 스테이지 인계 문서"
+      template: "HANDOFF.md.template"
+  optional:
+    - name: "personas.md"
+      description: "사용자 페르소나"
+    - name: "competitive_analysis.md"
+      description: "경쟁사 분석"
+
+# Prompts
+prompts:
+  - name: "ideation"
+    file: "prompts/ideation.md"
+    model: "gemini"
+    description: "발산적 아이디어 생성"
+  - name: "persona"
+    file: "prompts/persona.md"
+    model: "gemini"
+    description: "사용자 페르소나 생성"
+  - name: "requirements"
+    file: "prompts/requirements.md"
+    model: "claudecode"
+    description: "요구사항 분석 및 구조화"
+
+# Completion Criteria
+completion:
+  checklist:
+    - "최소 10개 아이디어 생성"
+    - "3개 이상 사용자 페르소나 정의"
+    - "요구사항 분석 문서 완성"
+    - "HANDOFF.md 생성"
+  validation:
+    min_ideas: 10
+    min_personas: 3
+    require_handoff: true
+
+# Transition
+transition:
+  next_stage: "02-research"
+  prerequisites: []
+  handoff_required: true
+  checkpoint_required: false

package/template/stages/01-brainstorm/prompts/collaboration.md

@@ -0,0 +1,46 @@
+# AI 협업 프롬프트 - Brainstorming
+
+## 협업 모드: Parallel Execution
+
+이 스테이지에서는 **병렬 실행** 모드를 사용하여 여러 AI 모델이 동시에 아이디어를 생성합니다.
+
+### 참여 모델
+- **Gemini**: 창의적 아이디어 발산, 웹 리서치
+- **Claude**: 구조화, 실현 가능성 검토
+
+### 협업 프롬프트
+
+```
+/collaborate --mode parallel --models gemini,claude --task "아이디어 브레인스토밍"
+```
+
+### 병합 전략
+
+1. **Gemini 결과**: 창의적 아이디어, 다양한 관점
+2. **Claude 결과**: 구조화된 분석, 실현 가능성 평가
+3. **병합**: Best-of-N 선택 후 통합
+
+### 토론 모드 (선택적)
+
+복잡한 아이디어 평가 시 토론 모드 활용:
+```
+/collaborate --mode debate --topic "최적의 MVP 범위 결정" --rounds 2
+```
+
+### 출력 형식
+
+```markdown
+## AI 협업 결과
+
+### Gemini 아이디어
+- [아이디어 1]
+- [아이디어 2]
+...
+
+### Claude 분석
+- [구조화된 평가]
+...
+
+### 통합 결과
+- [최종 아이디어 목록]
+```

package/template/stages/01-brainstorm/prompts/ideation.md

@@ -0,0 +1,62 @@
+# Ideation Prompt Template
+
+프로젝트 브레인스토밍을 위한 발산적 아이디어 생성 프롬프트
+
+## 사용 모델
+Gemini (창의적 발산에 적합)
+
+## 프롬프트
+
+```
+당신은 창의적인 프로덕트 매니저이자 아이디어 전문가입니다.
+
+다음 프로젝트 브리프를 분석하고 포괄적인 브레인스토밍을 수행해주세요:
+
+---
+{{PROJECT_BRIEF}}
+---
+
+## 요청 사항
+
+### 1. 핵심 기능 아이디어 (최소 10개)
+각 아이디어에 대해:
+- 기능 이름 및 한 줄 설명
+- 사용자 가치 (어떤 문제를 해결하는가?)
+- 구현 복잡도 (Low/Medium/High)
+- 혁신성 점수 (1-5)
+
+### 2. 사용자 페르소나 (3개 이상)
+각 페르소나에 대해:
+- 이름, 나이, 직업
+- 목표와 동기
+- 불만 사항과 pain points
+- 기술 친숙도
+
+### 3. 경쟁사/유사 서비스 분석
+- Reddit, HackerNews, ProductHunt 검색
+- 유사 프로젝트 3-5개 식별
+- 각각의 강점/약점 분석
+- 차별화 기회 식별
+
+### 4. 발산적 아이디어
+- "미친" 아이디어 3개 (실현 가능성 무시)
+- 각 아이디어가 성공할 경우의 임팩트
+
+## 출력 형식
+마크다운 형식으로 구조화하여 출력해주세요.
+```
+
+## 사용 예시
+
+```bash
+# Gemini CLI 호출
+/gemini "$(cat prompts/ideation.md | sed 's/{{PROJECT_BRIEF}}/'"$(cat inputs/project_brief.md)"'/')"
+
+# 또는 직접 호출
+scripts/gemini-wrapper.sh "$(cat prompts/ideation.md)"
+```
+
+## 기대 출력
+- `outputs/ideas.md`로 저장
+- 최소 10개 이상의 아이디어 포함
+- 구조화된 마크다운 형식

package/template/stages/01-brainstorm/prompts/persona.md

@@ -0,0 +1,73 @@
+# Persona Generation Prompt Template
+
+사용자 페르소나 생성을 위한 프롬프트
+
+## 사용 모델
+Gemini
+
+## 프롬프트
+
+```
+당신은 UX 리서처이자 사용자 심리 전문가입니다.
+
+다음 프로젝트에 대한 상세 사용자 페르소나를 생성해주세요:
+
+---
+프로젝트: {{PROJECT_NAME}}
+설명: {{PROJECT_DESCRIPTION}}
+대상 시장: {{TARGET_MARKET}}
+---
+
+## 페르소나 생성 요청
+
+각 페르소나에 대해 다음 정보를 포함해주세요:
+
+### 기본 정보
+- **이름**: (가상의 현실적인 이름)
+- **나이**:
+- **직업**:
+- **위치**:
+- **교육 수준**:
+
+### 심리적 프로필
+- **성격 유형** (MBTI 참고):
+- **가치관**:
+- **라이프스타일**:
+
+### 목표와 동기
+- **주요 목표** (이 제품과 관련하여):
+- **숨겨진 동기**:
+- **성공의 정의**:
+
+### Pain Points
+- **현재 해결책의 불만**:
+- **시간/비용 낭비 요소**:
+- **감정적 좌절감**:
+
+### 기술 프로필
+- **기술 친숙도** (1-5):
+- **주로 사용하는 기기**:
+- **앱 사용 패턴**:
+
+### 사용 시나리오
+- **제품을 발견하는 상황**:
+- **핵심 사용 사례**:
+- **기대하는 결과**:
+
+### 인용구
+이 페르소나가 할 법한 말:
+> "..."
+
+## 출력 형식
+3개 이상의 페르소나를 마크다운 형식으로 출력해주세요.
+각 페르소나는 명확히 구분되어야 합니다.
+```
+
+## 변수 치환
+- `{{PROJECT_NAME}}`: 프로젝트 이름
+- `{{PROJECT_DESCRIPTION}}`: 프로젝트 설명
+- `{{TARGET_MARKET}}`: 대상 시장
+
+## 기대 출력
+- `outputs/personas.md`로 저장
+- 최소 3개 이상의 상세 페르소나

package/template/stages/01-brainstorm/prompts/requirements.md

@@ -0,0 +1,73 @@
+# Requirements Analysis Prompt Template
+
+요구사항 분석 및 구조화를 위한 프롬프트
+
+## 사용 모델
+ClaudeCode (구조화 및 분석에 적합)
+
+## 프롬프트
+
+```
+당신은 시니어 시스템 분석가입니다.
+
+다음 브레인스토밍 결과와 프로젝트 브리프를 바탕으로
+체계적인 요구사항 분석을 수행해주세요:
+
+---
+## 프로젝트 브리프
+{{PROJECT_BRIEF}}
+
+## 브레인스토밍 결과
+{{BRAINSTORM_IDEAS}}
+
+## 사용자 페르소나
+{{PERSONAS}}
+---
+
+## 분석 요청
+
+### 1. 기능적 요구사항 (Functional Requirements)
+카테고리별로 분류:
+- 사용자 관리
+- 핵심 기능
+- 데이터 관리
+- 통합/연동
+- 보고/분석
+
+각 요구사항에 대해:
+| ID | 요구사항 | 우선순위 | 복잡도 | 의존성 |
+|----|----------|----------|--------|--------|
+
+### 2. 비기능적 요구사항 (Non-Functional Requirements)
+- **성능**: 응답 시간, 처리량
+- **확장성**: 사용자 수, 데이터 볼륨
+- **보안**: 인증, 권한, 데이터 보호
+- **가용성**: 업타임 목표
+- **사용성**: 접근성, UX 기준
+
+### 3. 제약조건 (Constraints)
+- 기술적 제약
+- 비즈니스 제약
+- 시간/예산 제약
+- 규제/법적 제약
+
+### 4. 가정사항 (Assumptions)
+검증이 필요한 가정들
+
+### 5. MVP 범위 제안
+- **필수 기능** (Must Have)
+- **있으면 좋은 기능** (Nice to Have)
+- **향후 버전** (Future)
+
+### 6. 리스크 식별
+| 리스크 | 영향도 | 발생 확률 | 완화 전략 |
+|--------|--------|-----------|-----------|
+
+## 출력 형식
+구조화된 마크다운 문서로 출력해주세요.
+```
+
+## 기대 출력
+- `outputs/requirements_analysis.md`로 저장
+- MoSCoW 우선순위가 적용된 요구사항 목록
+- MVP 범위 명확히 정의

package/template/stages/01-brainstorm/prompts/validation.md

@@ -0,0 +1,50 @@
+# 산출물 검증 프롬프트 - Brainstorming
+
+## 검증 대상
+
+| 산출물 | 필수 조건 | 검증 방법 |
+|--------|----------|----------|
+| `ideas.md` | 최소 10개 아이디어 | 수량 확인 |
+| `requirements_analysis.md` | 기능/비기능 섹션 포함 | 구조 확인 |
+| `HANDOFF.md` | 완료 체크리스트 | 항목 확인 |
+
+## 검증 명령
+
+```bash
+/validate --stage 01-brainstorm
+```
+
+## 품질 기준
+
+### ideas.md
+- [ ] 최소 10개 아이디어 존재
+- [ ] 각 아이디어에 장단점 분석
+- [ ] 우선순위 또는 카테고리 분류
+- [ ] 실현 가능성 초기 평가
+
+### requirements_analysis.md
+- [ ] 기능적 요구사항 섹션
+- [ ] 비기능적 요구사항 섹션
+- [ ] 제약조건 식별
+- [ ] MVP 범위 제안
+
+### HANDOFF.md
+- [ ] 완료된 작업 체크리스트
+- [ ] 핵심 결정사항
+- [ ] 다음 스테이지 준비 항목
+
+## 자동 검증 스크립트
+
+```bash
+# ideas.md 아이디어 수 확인
+grep -c "^## " outputs/ideas.md
+
+# requirements_analysis.md 섹션 확인
+grep -E "^## (기능|비기능)" outputs/requirements_analysis.md
+```
+
+## 실패 시 조치
+
+1. 부족한 항목 식별
+2. 추가 아이디어 생성 또는 분석 보완
+3. 재검증 실행

package/template/stages/01-brainstorm/templates/ideas.md

@@ -0,0 +1,91 @@
+# Brainstorming Ideas
+
+**프로젝트**: {{PROJECT_NAME}}
+**생성일**: {{DATE}}
+**생성자**: {{MODEL}} (Gemini + ClaudeCode)
+
+---
+
+## 핵심 기능 아이디어
+
+### 아이디어 요약 테이블
+
+| # | 기능명 | 설명 | 사용자 가치 | 복잡도 | 혁신성 |
+|---|--------|------|-------------|--------|--------|
+| 1 | | | | | |
+| 2 | | | | | |
+| 3 | | | | | |
+| ... | | | | | |
+
+### 상세 아이디어
+
+#### 아이디어 1: [기능명]
+- **설명**:
+- **사용자 가치**:
+- **구현 복잡도**: Low / Medium / High
+- **혁신성 점수**: ⭐⭐⭐⭐⭐ (5/5)
+- **비고**:
+
+---
+
+## 발산적 아이디어 ("미친" 아이디어)
+
+### 🚀 아이디어 A: [이름]
+- **설명**:
+- **성공 시 임팩트**:
+- **실현 장벽**:
+
+### 🚀 아이디어 B: [이름]
+- **설명**:
+- **성공 시 임팩트**:
+- **실현 장벽**:
+
+### 🚀 아이디어 C: [이름]
+- **설명**:
+- **성공 시 임팩트**:
+- **실현 장벽**:
+
+---
+
+## 경쟁사/유사 서비스 분석
+
+### 식별된 서비스
+
+| 서비스 | 유형 | 강점 | 약점 | 차별화 기회 |
+|--------|------|------|------|-------------|
+| | | | | |
+
+### 상세 분석
+
+#### [서비스 1]
+- **URL**:
+- **핵심 기능**:
+- **가격 모델**:
+- **타겟 사용자**:
+- **우리의 차별화 포인트**:
+
+---
+
+## 아이디어 우선순위 매트릭스
+
+```
+높은 임팩트
+    │
+    │   ⭐ Quick Wins    │   🎯 Big Bets
+    │   (아이디어 #)      │   (아이디어 #)
+    │                    │
+────┼────────────────────┼────────────────
+    │                    │
+    │   ❌ Not Worth It   │   🔬 Experiments
+    │   (아이디어 #)      │   (아이디어 #)
+    │
+낮은 임팩트
+         낮은 노력          높은 노력
+```
+
+---
+
+## 다음 단계
+1. Research 스테이지에서 기술적 실현 가능성 검토
+2. Quick Wins 아이디어 우선 검증
+3. Big Bets 아이디어 심층 분석