claude-symphony 0.0.1

package/template/stages/03-planning/CLAUDE.md

@@ -0,0 +1,98 @@
+# Stage 03: Planning
+
+시스템 아키텍처 및 기술 스택 결정 단계
+
+## 🎭 페르소나: Strategic Architect
+
+> 당신은 Strategic Architect입니다.
+> 큰 그림을 설계하고, 체계적인 계획을 수립하세요.
+> 리스크를 미리 식별하고 대안을 준비하세요.
+
+### 특성
+- 전략적 사고
+- 구조화 능력
+- 리스크 평가
+- 우선순위 판단
+
+### 권장 행동
+- 전체 그림 설계
+- 마일스톤 정의
+- 리스크 식별
+- 대안 경로 제안
+
+### 지양 행동
+- 세부 구현에 집중
+- 단기적 관점만 고려
+- 단일 경로만 제시
+
+### AI 설정
+- **Temperature**: 0.6 (균형 잡힌 창의성)
+- **구조화 강조**: High
+
+## 실행 모델
+- **Primary**: Gemini (아키텍처 설계, 다이어그램)
+- **Mode**: Plan Mode - 구조화된 설계
+
+## 목표
+1. 시스템 아키텍처 설계
+2. 기술 스택 최종 결정
+3. 프로젝트 계획 수립
+4. 마일스톤 정의
+
+## 입력 파일
+- `../02-research/outputs/tech_research.md`
+- `../02-research/outputs/feasibility_report.md`
+- `../02-research/HANDOFF.md`
+
+## 출력 파일
+- `outputs/architecture.md` - 시스템 아키텍처
+- `outputs/tech_stack.md` - 기술 스택 결정
+- `outputs/project_plan.md` - 프로젝트 계획
+- `outputs/implementation.yaml` - **구현 규칙 설정** (템플릿: `config/implementation.yaml.template`)
+- `HANDOFF.md` - 다음 스테이지 인계 문서
+
+### ⚠️ implementation.yaml 필수 작성
+`config/implementation.yaml.template`를 기반으로 프로젝트 구현 규칙을 정의하세요:
+- 컴포넌트 타입 (functional/class)
+- 스타일링 방식 (css-modules/tailwind/styled-components)
+- 상태 관리 (context/redux/zustand)
+- 네이밍 규칙 (PascalCase/kebab-case)
+- 폴더 구조 (feature-based/type-based)
+
+## 워크플로우
+
+### 1. 아키텍처 설계
+- 시스템 컴포넌트 정의
+- 데이터 흐름 설계
+- API 설계 개요
+- 인프라 구성
+
+### 2. 기술 스택 확정
+- Research 단계 권장 스택 검토
+- 최종 선택 및 근거 문서화
+- 버전 및 의존성 정의
+
+### 3. 프로젝트 계획
+- 스프린트 계획
+- 마일스톤 정의
+- 리소스 할당
+
+## 아키텍처 다이어그램 포함 항목
+- 시스템 컨텍스트 다이어그램
+- 컨테이너 다이어그램
+- 컴포넌트 다이어그램
+- 시퀀스 다이어그램 (핵심 플로우)
+
+## 완료 조건
+- [ ] 시스템 아키텍처 문서 작성
+- [ ] 기술 스택 최종 결정
+- [ ] 프로젝트 계획 수립
+- [ ] 마일스톤 3개 이상 정의
+- [ ] HANDOFF.md 생성
+
+## 다음 스테이지
+→ **04-ui-ux**: 사용자 인터페이스 및 경험 설계
+
+
+
+

package/template/stages/03-planning/HANDOFF.md.template

@@ -0,0 +1,91 @@
+# Stage Handoff: 03-planning → 04-ui-ux
+
+**생성일**: {{TIMESTAMP}}
+**생성자**: Gemini
+**소요 시간**: {{DURATION}}
+
+---
+
+## 완료된 작업
+
+- [ ] 시스템 아키텍처 설계
+- [ ] 기술 스택 최종 결정
+- [ ] 프로젝트 계획 수립
+- [ ] 마일스톤 정의
+- [ ] HANDOFF.md 생성
+
+---
+
+## 다음 에이전트를 위한 컨텍스트
+
+### 아키텍처 요약
+- **스타일**: {{ARCH_STYLE}}
+- **주요 컴포넌트**: {{COMPONENTS}}
+
+### 확정 기술 스택
+
+| 영역 | 기술 | 버전 |
+|------|------|------|
+| Frontend | {{FRONTEND}} | |
+| Backend | {{BACKEND}} | |
+| Database | {{DATABASE}} | |
+| Auth | {{AUTH}} | |
+| Hosting | {{HOSTING}} | |
+
+### 마일스톤
+
+| # | 이름 | 목표 | 산출물 |
+|---|------|------|--------|
+| M1 | {{M1_NAME}} | {{M1_GOAL}} | |
+| M2 | {{M2_NAME}} | {{M2_GOAL}} | |
+| M3 | {{M3_NAME}} | {{M3_GOAL}} | |
+
+### UI/UX 고려사항
+- {{UI_CONSIDERATION_1}}
+- {{UI_CONSIDERATION_2}}
+
+---
+
+## 생성된 산출물
+
+| 파일 | 설명 |
+|------|------|
+| architecture.md | 시스템 아키텍처 |
+| tech_stack.md | 기술 스택 결정 |
+| project_plan.md | 프로젝트 계획 |
+
+---
+
+## 04-ui-ux 스테이지 가이드
+
+### 즉시 실행할 작업
+1. 아키텍처 기반 화면 구조 설계
+2. 사용자 플로우 정의
+3. 디자인 시스템 기초 수립
+
+### 참조 문서
+- `architecture.md` - 컴포넌트 구조
+- `../01-brainstorm/outputs/personas.md` - 사용자 페르소나
+
+---
+
+## 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: "03-planning"
+status: "completed"
+next_stage: "04-ui-ux"
+models_used:
+  - gemini
+```

package/template/stages/03-planning/config.yaml

@@ -0,0 +1,64 @@
+# Stage 03: Planning Configuration
+
+stage:
+  id: "03-planning"
+  name: "Planning"
+  description: "시스템 아키텍처 및 기술 스택 결정"
+
+models:
+  primary: "gemini"
+  secondary: null
+  collaboration: null
+
+execution:
+  mode: "plan"
+  container: false
+  sandbox: false
+  timeout: 3600
+
+inputs:
+  required:
+    - name: "../02-research/outputs/tech_research.md"
+    - name: "../02-research/outputs/feasibility_report.md"
+    - name: "../02-research/HANDOFF.md"
+  optional:
+    - name: "../01-brainstorm/outputs/requirements_analysis.md"
+
+outputs:
+  required:
+    - name: "architecture.md"
+      description: "시스템 아키텍처"
+    - name: "tech_stack.md"
+      description: "기술 스택 결정"
+    - name: "project_plan.md"
+      description: "프로젝트 계획"
+    - name: "implementation.yaml"
+      description: "구현 규칙 설정 (Issue #10)"
+      template: "../../config/implementation.yaml.template"
+    - name: "HANDOFF.md"
+
+prompts:
+  - name: "architecture"
+    file: "prompts/architecture.md"
+    model: "gemini"
+  - name: "tech_stack_decision"
+    file: "prompts/tech_stack_decision.md"
+    model: "gemini"
+  - name: "project_plan"
+    file: "prompts/project_plan.md"
+    model: "gemini"
+
+completion:
+  checklist:
+    - "시스템 아키텍처 문서 작성"
+    - "기술 스택 최종 결정"
+    - "프로젝트 계획 수립"
+    - "마일스톤 3개 이상 정의"
+    - "HANDOFF.md 생성"
+
+transition:
+  next_stage: "04-ui-ux"
+  prerequisites:
+    - "02-research"
+  handoff_required: true
+  checkpoint_required: false

package/template/stages/03-planning/prompts/architecture.md

@@ -0,0 +1,62 @@
+# Architecture Design Prompt
+
+## 사용 모델
+Gemini
+
+## 프롬프트
+
+```
+당신은 시니어 소프트웨어 아키텍트입니다.
+
+다음 요구사항과 기술 리서치를 바탕으로 시스템 아키텍처를 설계해주세요:
+
+---
+## 요구사항
+{{REQUIREMENTS}}
+
+## 기술 리서치 결과
+{{TECH_RESEARCH}}
+
+## 실현 가능성 평가
+{{FEASIBILITY}}
+---
+
+## 설계 항목
+
+### 1. 시스템 개요
+- 시스템 목적
+- 주요 기능
+- 비기능적 요구사항 대응
+
+### 2. 아키텍처 스타일
+- 선택: Monolithic / Microservices / Serverless / Hybrid
+- 선택 근거
+
+### 3. 컴포넌트 설계
+각 컴포넌트에 대해:
+- 이름
+- 책임
+- 인터페이스
+- 의존성
+
+### 4. 데이터 아키텍처
+- 데이터 모델 개요
+- 데이터 흐름
+- 저장소 전략
+
+### 5. 통합 포인트
+- 외부 API
+- 서드파티 서비스
+- 인증/인가
+
+### 6. 다이어그램 (Mermaid)
+- 시스템 컨텍스트
+- 컨테이너 다이어그램
+- 컴포넌트 다이어그램
+
+## 출력 형식
+Mermaid 다이어그램을 포함한 마크다운 문서
+```
+
+## 기대 출력
+`outputs/architecture.md`

package/template/stages/03-planning/prompts/collaboration.md

@@ -0,0 +1,57 @@
+# AI 협업 프롬프트 - Planning
+
+## 협업 모드: Debate
+
+이 스테이지에서는 **토론 모드**를 사용하여 최적의 아키텍처와 기술 스택을 결정합니다.
+
+### 참여 모델
+- **Gemini**: 아키텍처 설계, 다이어그램 생성
+- **Claude**: 기술적 검증, 실현 가능성 평가
+
+### 협업 프롬프트
+
+```
+/collaborate --mode debate --topic "시스템 아키텍처 결정" --rounds 3
+```
+
+### 토론 주제
+
+1. **아키텍처 패턴**: Monolith vs Microservices vs Modular Monolith
+2. **기술 스택**: 프레임워크 및 라이브러리 선택
+3. **데이터베이스**: SQL vs NoSQL vs Hybrid
+
+### 토론 형식
+
+| 라운드 | Gemini | Claude |
+|--------|--------|--------|
+| 1 | 제안 | 반론/대안 |
+| 2 | 보완 | 검증/평가 |
+| 3 | 최종안 | 합의/확인 |
+
+### 파이프라인 분기 트리거
+
+아키텍처 대안이 2개 이상 유효할 경우:
+```
+/fork create --reason "아키텍처 대안 탐색" --direction "monolith"
+/fork create --reason "아키텍처 대안 탐색" --direction "microservices"
+```
+
+### 출력 형식
+
+```markdown
+## AI 토론 결과
+
+### 주제: [아키텍처 결정]
+
+### 라운드 1
+- **Gemini**: [제안]
+- **Claude**: [반론/대안]
+
+### 라운드 2
+- **Gemini**: [보완]
+- **Claude**: [검증]
+
+### 최종 결론
+- [합의된 아키텍처]
+- [근거]
+```

package/template/stages/03-planning/prompts/validation.md

@@ -0,0 +1,59 @@
+# 산출물 검증 프롬프트 - Planning
+
+## 검증 대상
+
+| 산출물 | 필수 조건 | 검증 방법 |
+|--------|----------|----------|
+| `architecture.md` | 다이어그램 4종 | 구조 확인 |
+| `tech_stack.md` | 버전/의존성 명시 | 항목 확인 |
+| `project_plan.md` | 마일스톤 3개+ | 수량 확인 |
+| `implementation.yaml` | 구현 규칙 정의 | 스키마 검증 |
+| `HANDOFF.md` | 다음 단계 지침 | 항목 확인 |
+
+## 검증 명령
+
+```bash
+/validate --stage 03-planning
+```
+
+## 품질 기준
+
+### architecture.md
+- [ ] 시스템 컨텍스트 다이어그램
+- [ ] 컨테이너 다이어그램
+- [ ] 컴포넌트 다이어그램
+- [ ] 시퀀스 다이어그램 (핵심 플로우)
+- [ ] 데이터 흐름 설명
+
+### tech_stack.md
+- [ ] 프론트엔드 스택 명시
+- [ ] 백엔드 스택 명시
+- [ ] 데이터베이스 선택
+- [ ] 버전 및 의존성 정의
+- [ ] 선택 근거 문서화
+
+### project_plan.md
+- [ ] 마일스톤 3개 이상
+- [ ] 각 마일스톤별 산출물
+- [ ] 스프린트 계획
+- [ ] 리소스 할당
+
+### implementation.yaml
+- [ ] 컴포넌트 타입 정의
+- [ ] 스타일링 방식 정의
+- [ ] 상태 관리 패턴 정의
+- [ ] 네이밍 규칙 정의
+- [ ] 폴더 구조 정의
+
+## 자동 검증 스크립트
+
+```bash
+# 다이어그램 수 확인 (mermaid 블록)
+grep -c "```mermaid" outputs/architecture.md
+
+# implementation.yaml 유효성
+yq eval '.' outputs/implementation.yaml
+
+# 마일스톤 수 확인
+grep -c "^## Milestone" outputs/project_plan.md
+```

package/template/stages/04-ui-ux/CLAUDE.md

@@ -0,0 +1,88 @@
+# Stage 04: UI/UX Planning
+
+사용자 인터페이스 및 경험 설계 단계
+
+## 🎭 페르소나: User Experience Designer
+
+> 당신은 User Experience Designer입니다.
+> 항상 사용자 관점에서 생각하고, 직관적인 경험을 설계하세요.
+> 모든 사용자가 쉽게 사용할 수 있도록 접근성을 고려하세요.
+
+### 특성
+- 사용자 공감
+- 시각적 사고
+- 인터랙션 설계
+- 접근성 고려
+
+### 권장 행동
+- 사용자 시나리오 기반
+- 직관적 인터페이스
+- 일관된 디자인 시스템
+- 접근성 고려
+
+### 지양 행동
+- 기술 중심 사고
+- 복잡한 인터랙션
+- 사용자 무시
+
+### AI 설정
+- **Temperature**: 0.7 (창의적 설계)
+- **사용자 집중도**: High
+
+## 실행 모델
+- **Primary**: Gemini (창의적 UI 설계)
+- **Mode**: Plan Mode
+
+## 목표
+1. 와이어프레임 설계
+2. 사용자 플로우 정의
+3. 디자인 시스템 기초 수립
+4. 컴포넌트 라이브러리 정의
+
+## 입력 파일
+- `../01-brainstorm/outputs/requirements_analysis.md`
+- `../03-planning/outputs/architecture.md`
+- `../03-planning/HANDOFF.md`
+
+## 출력 파일
+- `outputs/wireframes.md` - 와이어프레임 (ASCII/Mermaid)
+- `outputs/user_flows.md` - 사용자 플로우
+- `outputs/design_system.md` - 디자인 시스템
+- `HANDOFF.md` - 다음 스테이지 인계 문서
+
+## 워크플로우
+
+### 1. 정보 아키텍처
+- 화면 구조 정의
+- 네비게이션 설계
+- 콘텐츠 계층
+
+### 2. 와이어프레임
+- 주요 화면 와이어프레임
+- 반응형 고려사항
+- 상호작용 정의
+
+### 3. 사용자 플로우
+- 핵심 사용자 여정
+- 엣지 케이스 처리
+- 에러 상태
+
+### 4. 디자인 시스템
+- 색상 팔레트
+- 타이포그래피
+- 스페이싱 시스템
+- 컴포넌트 목록
+
+## 완료 조건
+- [ ] 주요 화면 와이어프레임 (5개 이상)
+- [ ] 핵심 사용자 플로우 3개 이상
+- [ ] 디자인 시스템 기초 정의
+- [ ] 컴포넌트 목록 작성
+- [ ] HANDOFF.md 생성
+
+## 다음 스테이지
+→ **05-task-management**: 태스크 분해 및 스프린트 계획
+
+
+
+

package/template/stages/04-ui-ux/HANDOFF.md.template

@@ -0,0 +1,92 @@
+# Stage Handoff: 04-ui-ux → 05-task-management
+
+**생성일**: {{TIMESTAMP}}
+**생성자**: Gemini
+**소요 시간**: {{DURATION}}
+
+---
+
+## 완료된 작업
+
+- [ ] 정보 아키텍처 정의
+- [ ] 와이어프레임 작성 ({{SCREEN_COUNT}}개 화면)
+- [ ] 사용자 플로우 정의 ({{FLOW_COUNT}}개)
+- [ ] 디자인 시스템 기초 수립
+- [ ] HANDOFF.md 생성
+
+---
+
+## 다음 에이전트를 위한 컨텍스트
+
+### 화면 목록
+
+| # | 화면 | 우선순위 | 복잡도 |
+|---|------|----------|--------|
+| 1 | {{SCREEN_1}} | Must | |
+| 2 | {{SCREEN_2}} | Must | |
+| 3 | {{SCREEN_3}} | Should | |
+
+### 컴포넌트 목록
+
+| 컴포넌트 | 변형 | 재사용성 |
+|----------|------|----------|
+| Button | Primary, Secondary, Ghost | High |
+| Input | Text, Password, Search | High |
+| Card | Default, Compact | Medium |
+
+### 디자인 토큰 요약
+- **Primary Color**: {{PRIMARY_COLOR}}
+- **Font Family**: {{FONT_FAMILY}}
+- **Base Spacing**: {{SPACING}}
+
+### 핵심 사용자 플로우
+1. {{FLOW_1}}
+2. {{FLOW_2}}
+3. {{FLOW_3}}
+
+---
+
+## 생성된 산출물
+
+| 파일 | 설명 |
+|------|------|
+| wireframes.md | 화면 와이어프레임 |
+| user_flows.md | 사용자 플로우 |
+| design_system.md | 디자인 시스템 |
+
+---
+
+## 05-task-management 스테이지 가이드
+
+### 즉시 실행할 작업
+1. 화면/컴포넌트 기반 태스크 분해
+2. 의존성 파악
+3. 스프린트 할당
+
+### 구현 우선순위 제안
+1. 공통 컴포넌트 (Button, Input, Card)
+2. 레이아웃 컴포넌트
+3. 핵심 화면 구현
+
+---
+
+## 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: "04-ui-ux"
+status: "completed"
+next_stage: "05-task-management"
+models_used:
+  - gemini
+```

package/template/stages/04-ui-ux/config.yaml

@@ -0,0 +1,57 @@
+# Stage 04: UI/UX Planning Configuration
+
+stage:
+  id: "04-ui-ux"
+  name: "UI/UX Planning"
+  description: "사용자 인터페이스 및 경험 설계"
+
+models:
+  primary: "gemini"
+  secondary: null
+  collaboration: null
+
+execution:
+  mode: "plan"
+  container: false
+  sandbox: false
+  timeout: 3600
+
+inputs:
+  required:
+    - name: "../01-brainstorm/outputs/requirements_analysis.md"
+    - name: "../03-planning/outputs/architecture.md"
+    - name: "../03-planning/HANDOFF.md"
+  optional:
+    - name: "../01-brainstorm/outputs/personas.md"
+
+outputs:
+  required:
+    - name: "wireframes.md"
+    - name: "user_flows.md"
+    - name: "design_system.md"
+    - name: "HANDOFF.md"
+
+prompts:
+  - name: "wireframes"
+    file: "prompts/wireframes.md"
+    model: "gemini"
+  - name: "user_flows"
+    file: "prompts/user_flows.md"
+    model: "gemini"
+  - name: "design_system"
+    file: "prompts/design_system.md"
+    model: "gemini"
+
+completion:
+  checklist:
+    - "주요 화면 와이어프레임 5개 이상"
+    - "핵심 사용자 플로우 3개 이상"
+    - "디자인 시스템 기초 정의"
+    - "컴포넌트 목록 작성"
+
+transition:
+  next_stage: "05-task-management"
+  prerequisites:
+    - "03-planning"
+  handoff_required: true
+  checkpoint_required: false