claude-symphony 0.0.1

package/template/stages/04-ui-ux/prompts/collaboration.md

@@ -0,0 +1,56 @@
+# AI 협업 프롬프트 - UI/UX Planning
+
+## 협업 모드: Debate + Parallel
+
+이 스테이지에서는 **토론 모드**로 UX 방향성을 결정하고, **병렬 모드**로 세부 설계를 진행합니다.
+
+### 참여 모델
+- **Gemini**: 창의적 UI 설계, 와이어프레임 생성
+- **Claude**: 사용성 검토, 접근성 평가
+
+### 협업 프롬프트
+
+```
+# UX 방향 토론
+/collaborate --mode debate --topic "사용자 경험 방향성" --rounds 2
+
+# 병렬 설계
+/collaborate --mode parallel --models gemini,claude --task "UI 컴포넌트 설계"
+```
+
+### 토론 주제
+
+1. **인터랙션 패턴**: 전통적 vs 혁신적
+2. **정보 아키텍처**: 평면 vs 계층
+3. **디자인 시스템**: 기존 사용 vs 커스텀
+
+### 작업 분담
+
+| AI | 담당 영역 | 출력 |
+|----|----------|------|
+| Gemini | 와이어프레임, 시각 설계 | wireframes.md |
+| Claude | 사용자 플로우, 접근성 검토 | user_flows.md |
+
+### 디자인 검토 체크리스트
+
+- [ ] 사용자 시나리오 기반 설계
+- [ ] 반응형 고려
+- [ ] 접근성 (WCAG 2.1)
+- [ ] 일관된 디자인 언어
+
+### 출력 형식
+
+```markdown
+## AI 협업 결과
+
+### Gemini 설계
+- 와이어프레임 (ASCII/Mermaid)
+- 색상/타이포그래피 제안
+
+### Claude 검토
+- 사용성 평가
+- 접근성 개선점
+
+### 통합 디자인 시스템
+- [최종 컴포넌트 목록]
+```

package/template/stages/04-ui-ux/prompts/validation.md

@@ -0,0 +1,54 @@
+# 산출물 검증 프롬프트 - UI/UX Planning
+
+## 검증 대상
+
+| 산출물 | 필수 조건 | 검증 방법 |
+|--------|----------|----------|
+| `wireframes.md` | 주요 화면 5개+ | 수량 확인 |
+| `user_flows.md` | 핵심 플로우 3개+ | 수량 확인 |
+| `design_system.md` | 색상/타이포/스페이싱 | 구조 확인 |
+| `HANDOFF.md` | 컴포넌트 목록 | 항목 확인 |
+
+## 검증 명령
+
+```bash
+/validate --stage 04-ui-ux
+```
+
+## 품질 기준
+
+### wireframes.md
+- [ ] 주요 화면 5개 이상
+- [ ] 각 화면 설명
+- [ ] 반응형 breakpoint 고려
+- [ ] 상호작용 설명
+
+### user_flows.md
+- [ ] 핵심 사용자 플로우 3개 이상
+- [ ] 각 플로우 다이어그램
+- [ ] 엣지 케이스 처리
+- [ ] 에러 상태 정의
+
+### design_system.md
+- [ ] 색상 팔레트 (Primary, Secondary, Neutral)
+- [ ] 타이포그래피 스케일
+- [ ] 스페이싱 시스템
+- [ ] 컴포넌트 목록 및 변형
+
+### HANDOFF.md
+- [ ] 구현할 컴포넌트 목록
+- [ ] 우선순위 지정
+- [ ] 기술적 고려사항
+
+## 자동 검증 스크립트
+
+```bash
+# 와이어프레임 수 확인
+grep -c "^### " outputs/wireframes.md
+
+# 사용자 플로우 수 확인
+grep -c "^## Flow" outputs/user_flows.md
+
+# 디자인 시스템 섹션 확인
+grep -E "^## (색상|Color|타이포|Typography|스페이싱|Spacing)" outputs/design_system.md
+```

package/template/stages/05-task-management/CLAUDE.md

@@ -0,0 +1,105 @@
+# Stage 05: Task Management
+
+> ⚠️ **Notion 태스크 생성 규칙**
+> - 태스크는 반드시 **하나씩 순차적으로** 생성하세요
+> - 모든 태스크에 **Status** 필드 필수 (기본값: To Do)
+> - **Order** 필드로 순서 지정 (View 정렬은 수동 설정)
+> - 스키마: `templates/task_schema.yaml` | 가이드: `templates/notion_integration.md`
+
+태스크 분해 및 스프린트 계획 단계
+
+## 🎭 페르소나: Project Organizer
+
+> 당신은 Project Organizer입니다.
+> 모든 작업을 실행 가능한 작은 단위로 분해하세요.
+> 각 태스크는 명확한 완료 조건과 의존성을 가져야 합니다.
+
+### 특성
+- 체계적 분해
+- 의존성 분석
+- 우선순위 설정
+- 실행 가능성
+
+### 권장 행동
+- 작은 단위로 분해
+- 명확한 완료 조건
+- 의존성 명시
+- 실행 가능한 태스크
+
+### 지양 행동
+- 모호한 태스크
+- 거대한 단위
+- 의존성 무시
+
+### AI 설정
+- **Temperature**: 0.3 (높은 정밀도)
+- **정밀도**: High
+
+## 실행 모델
+- **Primary**: ClaudeCode (구조화된 태스크 분해)
+- **Mode**: Plan Mode
+
+## 목표
+1. 기능별 태스크 분해
+2. 의존성 맵핑
+3. 스프린트 계획 수립
+4. 마일스톤별 산출물 정의
+
+## 입력 파일
+- `../03-planning/outputs/project_plan.md`
+- `../03-planning/outputs/architecture.md`
+- `../04-ui-ux/outputs/design_system.md`
+- `../04-ui-ux/HANDOFF.md`
+
+## 출력 파일
+- `outputs/tasks.md` - 태스크 목록
+- `outputs/sprint_plan.md` - 스프린트 계획
+- `outputs/milestones.md` - 마일스톤 정의
+- `HANDOFF.md` - 다음 스테이지 인계 문서
+
+## 워크플로우
+
+### 1. 태스크 분해
+- 기능 → 에픽 → 스토리 → 태스크
+- 예상 작업량 산정
+- 기술적 의존성 파악
+
+### 2. 우선순위 결정
+- MoSCoW 분류
+- 비즈니스 가치 vs 기술 복잡도
+- 리스크 기반 우선순위
+
+### 3. 스프린트 계획
+- 스프린트 길이 결정
+- 용량 기반 할당
+- 버퍼 포함
+
+### 4. 마일스톤 정의
+- 체크포인트별 산출물
+- 성공 기준
+- 검증 방법
+
+## 태스크 형식
+```markdown
+## TASK-XXX: [태스크명]
+- **에픽**: [에픽명]
+- **스토리**: [유저스토리]
+- **우선순위**: Must/Should/Could
+- **예상 시간**: Xh
+- **의존성**: [TASK-YYY, TASK-ZZZ]
+- **담당 스테이지**: 06-implementation
+```
+
+## 완료 조건
+- [ ] 전체 태스크 목록 작성
+- [ ] 의존성 그래프 생성
+- [ ] 스프린트 3개 이상 계획
+- [ ] 마일스톤 산출물 정의
+- [ ] HANDOFF.md 생성
+
+## 다음 스테이지
+→ **06-implementation**: 핵심 기능 구현
+
+
+
+

package/template/stages/05-task-management/HANDOFF.md.template

@@ -0,0 +1,97 @@
+# Stage Handoff: 05-task-management → 06-implementation
+
+**생성일**: {{TIMESTAMP}}
+**생성자**: ClaudeCode
+**소요 시간**: {{DURATION}}
+
+---
+
+## 완료된 작업
+
+- [ ] 태스크 분해 (총 {{TASK_COUNT}}개)
+- [ ] 의존성 맵핑
+- [ ] 스프린트 계획 ({{SPRINT_COUNT}}개)
+- [ ] 마일스톤 정의
+- [ ] HANDOFF.md 생성
+
+---
+
+## 다음 에이전트를 위한 컨텍스트
+
+### 스프린트 1 태스크 (즉시 시작)
+
+| ID | 태스크 | 우선순위 | 의존성 |
+|----|--------|----------|--------|
+| {{TASK_1_ID}} | {{TASK_1}} | Must | - |
+| {{TASK_2_ID}} | {{TASK_2}} | Must | {{DEP_2}} |
+| {{TASK_3_ID}} | {{TASK_3}} | Should | {{DEP_3}} |
+
+### 의존성 요약
+```mermaid
+graph TD
+    {{DEPENDENCY_GRAPH}}
+```
+
+### 마일스톤
+
+| 마일스톤 | 목표 | 완료 기준 |
+|----------|------|-----------|
+| M1 | {{M1_GOAL}} | {{M1_CRITERIA}} |
+| M2 | {{M2_GOAL}} | {{M2_CRITERIA}} |
+
+### 기술적 주의사항
+- {{TECH_NOTE_1}}
+- {{TECH_NOTE_2}}
+
+---
+
+## 생성된 산출물
+
+| 파일 | 설명 |
+|------|------|
+| tasks.md | 전체 태스크 목록 |
+| sprint_plan.md | 스프린트 계획 |
+| milestones.md | 마일스톤 정의 |
+
+---
+
+## 06-implementation 스테이지 가이드
+
+### 즉시 실행할 작업
+1. 프로젝트 초기화 (scaffolding)
+2. 공통 컴포넌트 구현
+3. {{FIRST_FEATURE}} 구현 시작
+
+### 구현 순서 권장
+1. {{IMPL_ORDER_1}}
+2. {{IMPL_ORDER_2}}
+3. {{IMPL_ORDER_3}}
+
+### 체크포인트 트리거
+- 스프린트 1 완료 시
+- 핵심 기능 구현 완료 시
+
+---
+
+## 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: "05-task-management"
+status: "completed"
+next_stage: "06-implementation"
+models_used:
+  - claudecode
+total_tasks: {{TASK_COUNT}}
+total_sprints: {{SPRINT_COUNT}}
+```

package/template/stages/05-task-management/config.yaml

@@ -0,0 +1,81 @@
+# Stage 05: Task Management Configuration
+
+stage:
+  id: "05-task-management"
+  name: "Task Management"
+  description: "태스크 분해 및 스프린트 계획"
+
+models:
+  primary: "claudecode"
+  secondary: null
+  collaboration: null
+
+execution:
+  mode: "plan"
+  container: false
+  sandbox: false
+  timeout: 1800  # 30 minutes
+
+inputs:
+  required:
+    - name: "../03-planning/outputs/project_plan.md"
+    - name: "../03-planning/outputs/architecture.md"
+    - name: "../04-ui-ux/HANDOFF.md"
+  optional:
+    - name: "../04-ui-ux/outputs/design_system.md"
+    - name: "../01-brainstorm/outputs/requirements_analysis.md"
+
+outputs:
+  required:
+    - name: "tasks.md"
+      description: "태스크 목록"
+    - name: "sprint_plan.md"
+      description: "스프린트 계획"
+    - name: "milestones.md"
+      description: "마일스톤 정의"
+    - name: "HANDOFF.md"
+
+# Notion 연동 설정 (Issue #4, #5, #6, #8, #16 해결)
+notion_integration:
+  enabled: true
+  schema: "templates/task_schema.yaml"
+  guide: "templates/notion_integration.md"
+
+  # 태스크 생성 규칙
+  task_creation:
+    mode: "sequential"     # 순차 생성 필수!
+    batch_size: 1          # 한 번에 하나씩
+    delay_ms: 100          # 생성 간 딜레이
+
+  # 필수 필드
+  required_fields:
+    - "Task Name"
+    - "Status"             # Issue #16: 필수!
+    - "Order"              # Issue #5: 정렬용!
+
+  # 기본값
+  defaults:
+    status: "To Do"
+    priority: "Medium"
+
+prompts:
+  - name: "task_breakdown"
+    file: "prompts/task_breakdown.md"
+    model: "claudecode"
+  - name: "sprint_planning"
+    file: "prompts/sprint_planning.md"
+    model: "claudecode"
+
+completion:
+  checklist:
+    - "전체 태스크 목록 작성"
+    - "의존성 그래프 생성"
+    - "스프린트 3개 이상 계획"
+    - "마일스톤 산출물 정의"
+
+transition:
+  next_stage: "06-implementation"
+  prerequisites:
+    - "04-ui-ux"
+  handoff_required: true
+  checkpoint_required: false

package/template/stages/05-task-management/prompts/collaboration.md

@@ -0,0 +1,54 @@
+# AI 협업 프롬프트 - Task Management
+
+## 협업 모드: Sequential Review
+
+이 스테이지에서는 **순차적 리뷰** 모드를 사용하여 태스크 분해의 완전성을 보장합니다.
+
+### 참여 모델
+- **ClaudeCode**: 태스크 분해, 의존성 분석
+
+### 협업 프롬프트
+
+```
+# 단일 모델이지만 반복 검토
+/collaborate --mode sequential --chain "claudecode:decompose -> claudecode:review"
+```
+
+### 작업 흐름
+
+1. **초기 분해**: 기능 → 에픽 → 스토리 → 태스크
+2. **의존성 분석**: 태스크 간 관계 파악
+3. **검토 및 조정**: 누락/중복 태스크 식별
+
+### 태스크 품질 기준
+
+| 기준 | 설명 |
+|------|------|
+| 원자성 | 더 이상 분해 불가 |
+| 명확성 | 완료 조건 명확 |
+| 독립성 | 최소한의 의존성 |
+| 추정 가능 | 시간 추정 가능 |
+
+### Notion 통합
+
+태스크 생성 시 반드시 준수:
+- 하나씩 순차적으로 생성
+- Status 필드 필수 (기본값: To Do)
+- Order 필드로 순서 지정
+
+### 출력 형식
+
+```markdown
+## 태스크 분해 결과
+
+### 에픽 1: [에픽명]
+#### 스토리 1.1: [스토리명]
+- TASK-001: [태스크] (2h)
+- TASK-002: [태스크] (4h)
+...
+
+### 의존성 그래프
+TASK-001 → TASK-003
+TASK-002 → TASK-004
+...
+```

package/template/stages/05-task-management/prompts/validation.md

@@ -0,0 +1,66 @@
+# 산출물 검증 프롬프트 - Task Management
+
+## 검증 대상
+
+| 산출물 | 필수 조건 | 검증 방법 |
+|--------|----------|----------|
+| `tasks.md` | 전체 태스크 목록 | 구조 확인 |
+| `sprint_plan.md` | 스프린트 3개+ | 수량 확인 |
+| `milestones.md` | 산출물 정의 | 구조 확인 |
+| `HANDOFF.md` | 첫 스프린트 태스크 | 항목 확인 |
+
+## 검증 명령
+
+```bash
+/validate --stage 05-task-management
+```
+
+## 품질 기준
+
+### tasks.md
+- [ ] MoSCoW 분류 적용
+- [ ] 각 태스크에 예상 시간
+- [ ] 의존성 명시
+- [ ] 담당 스테이지 지정
+
+### sprint_plan.md
+- [ ] 스프린트 3개 이상
+- [ ] 각 스프린트 용량 계산
+- [ ] 버퍼 시간 포함
+- [ ] 우선순위 기반 할당
+
+### milestones.md
+- [ ] 마일스톤별 산출물 정의
+- [ ] 성공 기준 명시
+- [ ] 검증 방법 포함
+
+### HANDOFF.md
+- [ ] 스프린트 1 태스크 목록
+- [ ] 의존성 그래프
+- [ ] 우선 구현 항목
+
+## 자동 검증 스크립트
+
+```bash
+# 태스크 수 확인
+grep -c "^- TASK-" outputs/tasks.md
+
+# 스프린트 수 확인
+grep -c "^## Sprint" outputs/sprint_plan.md
+
+# 마일스톤 수 확인
+grep -c "^## Milestone" outputs/milestones.md
+
+# 의존성 그래프 존재 확인
+grep -c "→" outputs/tasks.md
+```
+
+## 태스크 품질 체크
+
+```bash
+# 예상 시간 누락 확인
+grep -E "^- TASK-" outputs/tasks.md | grep -v -E "\([0-9]+h\)"
+
+# 의존성 누락 확인
+grep -E "^- TASK-" outputs/tasks.md | grep -v "의존성"
+```

package/template/stages/05-task-management/templates/notion_integration.md

@@ -0,0 +1,176 @@
+# Notion 연동 가이드
+
+> claude-symphony 태스크 관리 - Notion 데이터베이스 연동
+
+## 주의사항 (Issue #5, #6, #8, #16 해결)
+
+### ⚠️ 순차 생성 필수
+
+Notion API로 태스크를 생성할 때 **반드시 하나씩 순차적으로** 생성해야 합니다.
+
+```
+❌ 잘못된 방식 (병렬 생성)
+Promise.all([
+  createTask("태스크 1"),
+  createTask("태스크 2"),
+  createTask("태스크 3")
+])
+
+✅ 올바른 방식 (순차 생성)
+await createTask("태스크 1", { order: 1 })
+await createTask("태스크 2", { order: 2 })
+await createTask("태스크 3", { order: 3 })
+```
+
+### ⚠️ Status 필드 필수
+
+모든 태스크는 반드시 `Status` 필드를 포함해야 합니다.
+- 기본값: `To Do`
+- 생성 시 명시적으로 지정
+
+### ⚠️ Order 필드로 정렬
+
+Notion 데이터베이스 View 정렬은 수동으로 설정해야 합니다:
+
+1. 데이터베이스 View 열기
+2. `Sort` 클릭
+3. `Order` 필드 선택
+4. `Ascending` 정렬
+
+---
+
+## 데이터베이스 생성 절차
+
+### 1. 데이터베이스 생성
+
+```javascript
+// MCP Notion 도구 사용 예시
+await notion.createDatabase({
+  parent: { page_id: "프로젝트_페이지_ID" },
+  title: [{ text: { content: "프로젝트명 Tasks" } }],
+  properties: {
+    "Task Name": { title: {} },
+    "Status": {
+      select: {
+        options: [
+          { name: "To Do", color: "gray" },
+          { name: "In Progress", color: "blue" },
+          { name: "Review", color: "yellow" },
+          { name: "Done", color: "green" },
+          { name: "Blocked", color: "red" }
+        ]
+      }
+    },
+    "Priority": {
+      select: {
+        options: [
+          { name: "High", color: "red" },
+          { name: "Medium", color: "yellow" },
+          { name: "Low", color: "green" }
+        ]
+      }
+    },
+    "Order": { number: { format: "number" } },
+    "Sprint": {
+      select: {
+        options: [
+          { name: "Sprint 1" },
+          { name: "Sprint 2" },
+          { name: "Sprint 3" }
+        ]
+      }
+    },
+    "Assignee": { rich_text: {} },
+    "Estimate": { rich_text: {} },
+    "Due Date": { date: {} },
+    "Depends On": { rich_text: {} },
+    "Stage": {
+      select: {
+        options: [
+          { name: "06-implementation" },
+          { name: "07-refactoring" },
+          { name: "08-qa" },
+          { name: "09-testing" }
+        ]
+      }
+    }
+  }
+})
+```
+
+### 2. 태스크 생성 (순차적)
+
+```javascript
+// 태스크 목록
+const tasks = [
+  { name: "프로젝트 초기 설정", priority: "High" },
+  { name: "기본 UI 컴포넌트 구현", priority: "High" },
+  { name: "API 연동", priority: "Medium" },
+  // ...
+];
+
+// 순차 생성 (중요!)
+for (let i = 0; i < tasks.length; i++) {
+  await notion.createPage({
+    parent: { database_id: "데이터베이스_ID" },
+    properties: {
+      "Task Name": { title: [{ text: { content: tasks[i].name } }] },
+      "Status": { select: { name: "To Do" } },  // 필수!
+      "Priority": { select: { name: tasks[i].priority } },
+      "Order": { number: i + 1 }  // 순서 보장!
+    }
+  });
+
+  // 순서 보장을 위한 짧은 대기
+  await new Promise(resolve => setTimeout(resolve, 100));
+}
+```
+
+---
+
+## View 설정 (수동)
+
+Notion UI에서 직접 설정해야 합니다:
+
+### Board View 설정
+1. `+ Add a view` 클릭
+2. `Board` 선택
+3. `Group by` → `Status` 선택
+
+### List View 정렬 설정
+1. View에서 `...` 클릭
+2. `Sort` 선택
+3. `+ Add a sort`
+4. `Order` → `Ascending` 선택
+
+### 필터 설정 (선택)
+1. `Filter` 클릭
+2. `Status` `is not` `Done` 추가
+
+---
+
+## 체크리스트
+
+- [ ] 데이터베이스 생성 완료
+- [ ] Status 필드 포함 확인
+- [ ] Order 필드 포함 확인
+- [ ] 태스크 순차 생성 완료
+- [ ] Board View 설정 (Status 그룹화)
+- [ ] List View 정렬 설정 (Order 오름차순)
+
+---
+
+## 문제 해결
+
+### 태스크 순서가 뒤죽박죽인 경우
+1. List View에서 `Order` 정렬 확인
+2. Order 값이 누락된 태스크 수정
+3. 필요시 Order 값 재할당
+
+### Status 필드가 없는 경우
+1. 데이터베이스 속성에서 `Status` 추가
+2. 기존 태스크에 Status 값 할당
+
+### View 정렬이 저장되지 않는 경우
+1. 해당 View가 저장된 View인지 확인
+2. `...` → `Lock database` 해제 확인