claude-symphony 0.0.5 → 0.0.7

package/template/stages/02-research/HANDOFF.md.template

@@ -1,93 +1,93 @@
 # Stage Handoff: 02-research → 03-planning
 
-**생성일**: {{TIMESTAMP}}
-**생성자**: Claude
-**소요 시간**: {{DURATION}}
+**Created**: {{TIMESTAMP}}
+**Creator**: Claude
+**Duration**: {{DURATION}}
 
 ---
 
-## 완료된 작업
+## Completed Tasks
 
-- [ ] 기술 스택 리서치
-- [ ] 시장 분석 (경쟁사 {{COMPETITOR_COUNT}}개)
-- [ ] 실현 가능성 평가
-- [ ] HANDOFF.md 생성
+- [ ] Tech stack research
+- [ ] Market analysis ({{COMPETITOR_COUNT}} competitors)
+- [ ] Feasibility assessment
+- [ ] HANDOFF.md generation
 
 ---
 
-## 다음 에이전트를 위한 컨텍스트
+## Context for Next Agent
 
-### 권장 기술 스택
+### Recommended Tech Stack
 
-| 영역 | 선택 | 대안 | 선택 이유 |
-|------|------|------|-----------|
+| Area | Choice | Alternatives | Rationale |
+|------|--------|--------------|-----------|
 | Frontend | {{FRONTEND}} | | |
 | Backend | {{BACKEND}} | | |
 | Database | {{DATABASE}} | | |
 | Infrastructure | {{INFRA}} | | |
 
-### 핵심 결정사항
+### Key Decisions
 
-| 결정 | 이유 | 되돌릴 수 있음 |
-|------|------|----------------|
+| Decision | Rationale | Reversible |
+|----------|-----------|------------|
 | {{DECISION_1}} | {{REASON_1}} | Yes/No |
 
-### 실현 가능성 요약
-- **기술**: {{TECH_SCORE}}/10
-- **경제**: {{ECON_SCORE}}/10
-- **일정**: {{TIME_SCORE}}/10
-- **시장**: {{MARKET_SCORE}}/10
-- **종합**: {{TOTAL_SCORE}}/40
-- **권고**: {{RECOMMENDATION}}
+### Feasibility Summary
+- **Technical**: {{TECH_SCORE}}/10
+- **Economic**: {{ECON_SCORE}}/10
+- **Timeline**: {{TIME_SCORE}}/10
+- **Market**: {{MARKET_SCORE}}/10
+- **Overall**: {{TOTAL_SCORE}}/40
+- **Recommendation**: {{RECOMMENDATION}}
 
-### 주요 리스크
+### Major Risks
 1. {{RISK_1}}
 2. {{RISK_2}}
 3. {{RISK_3}}
 
 ---
 
-## 생성된 산출물
+## Generated Outputs
 
-| 파일 | 설명 |
-|------|------|
-| tech_research.md | 기술 스택 리서치 |
-| market_analysis.md | 시장 분석 |
-| feasibility_report.md | 실현 가능성 보고서 |
+| File | Description |
+|------|-------------|
+| tech_research.md | Tech stack research |
+| market_analysis.md | Market analysis |
+| feasibility_report.md | Feasibility report |
 
 ---
 
-## 03-planning 스테이지 가이드
+## 03-planning Stage Guide
 
-### 즉시 실행할 작업
-1. 권장 기술 스택 기반 아키텍처 설계
-2. 시스템 컴포넌트 정의
-3. 데이터 모델 설계
+### Immediate Tasks
+1. Design architecture based on recommended tech stack
+2. Define system components
+3. Design data model
 
-### 아키텍처 고려사항
+### Architecture Considerations
 - {{ARCH_CONSIDERATION_1}}
 - {{ARCH_CONSIDERATION_2}}
 
-### 검증된 가정
+### Validated Assumptions
 - {{VALIDATED_ASSUMPTION_1}}
 
-### 미검증 가정 (Planning에서 결정 필요)
+### Unvalidated Assumptions (Decision needed in Planning)
 - {{UNVALIDATED_ASSUMPTION_1}}
 
 ---
 
-## AI 호출 기록
+## AI Call Log
 
-| AI | 호출 시간 | 프롬프트 | 결과 | 상태 |
-|----|----------|---------|------|------|
+| AI | Call Time | Prompt | Result | Status |
+|----|-----------|--------|--------|--------|
 | {{AI_1}} | {{TIME_1}} | {{PROMPT_1}} | {{OUTPUT_1}} | {{STATUS_1}} |
 | {{AI_2}} | {{TIME_2}} | {{PROMPT_2}} | {{OUTPUT_2}} | {{STATUS_2}} |
 
-> 설정: `config/ai_logging.yaml`
+> Configuration: `config/ai_logging.yaml`
 
 ---
 
-## 메타데이터
+## Metadata
 
 ```yaml
 stage: "02-research"

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

@@ -1,86 +1,86 @@
 # Stage Handoff: 03-planning → 04-ui-ux
 
-**생성일**: {{TIMESTAMP}}
-**생성자**: Gemini
-**소요 시간**: {{DURATION}}
+**Created**: {{TIMESTAMP}}
+**Creator**: Gemini
+**Duration**: {{DURATION}}
 
 ---
 
-## 완료된 작업
+## Completed Tasks
 
-- [ ] 시스템 아키텍처 설계
-- [ ] 기술 스택 최종 결정
-- [ ] 프로젝트 계획 수립
-- [ ] 마일스톤 정의
-- [ ] HANDOFF.md 생성
+- [ ] System architecture design
+- [ ] Tech stack finalization
+- [ ] Project plan establishment
+- [ ] Milestone definition
+- [ ] HANDOFF.md generation
 
 ---
 
-## 다음 에이전트를 위한 컨텍스트
+## Context for Next Agent
 
-### 아키텍처 요약
-- **스타일**: {{ARCH_STYLE}}
-- **주요 컴포넌트**: {{COMPONENTS}}
+### Architecture Summary
+- **Style**: {{ARCH_STYLE}}
+- **Key Components**: {{COMPONENTS}}
 
-### 확정 기술 스택
+### Finalized Tech Stack
 
-| 영역 | 기술 | 버전 |
-|------|------|------|
+| Area | Technology | Version |
+|------|------------|---------|
 | Frontend | {{FRONTEND}} | |
 | Backend | {{BACKEND}} | |
 | Database | {{DATABASE}} | |
 | Auth | {{AUTH}} | |
 | Hosting | {{HOSTING}} | |
 
-### 마일스톤
+### Milestones
 
-| # | 이름 | 목표 | 산출물 |
-|---|------|------|--------|
+| # | Name | Goal | Deliverables |
+|---|------|------|--------------|
 | M1 | {{M1_NAME}} | {{M1_GOAL}} | |
 | M2 | {{M2_NAME}} | {{M2_GOAL}} | |
 | M3 | {{M3_NAME}} | {{M3_GOAL}} | |
 
-### UI/UX 고려사항
+### UI/UX Considerations
 - {{UI_CONSIDERATION_1}}
 - {{UI_CONSIDERATION_2}}
 
 ---
 
-## 생성된 산출물
+## Generated Outputs
 
-| 파일 | 설명 |
-|------|------|
-| architecture.md | 시스템 아키텍처 |
-| tech_stack.md | 기술 스택 결정 |
-| project_plan.md | 프로젝트 계획 |
+| File | Description |
+|------|-------------|
+| architecture.md | System architecture |
+| tech_stack.md | Tech stack decision |
+| project_plan.md | Project plan |
 
 ---
 
-## 04-ui-ux 스테이지 가이드
+## 04-ui-ux Stage Guide
 
-### 즉시 실행할 작업
-1. 아키텍처 기반 화면 구조 설계
-2. 사용자 플로우 정의
-3. 디자인 시스템 기초 수립
+### Immediate Tasks
+1. Design screen structure based on architecture
+2. Define user flows
+3. Establish design system foundation
 
-### 참조 문서
-- `architecture.md` - 컴포넌트 구조
-- `../01-brainstorm/outputs/personas.md` - 사용자 페르소나
+### Reference Documents
+- `architecture.md` - Component structure
+- `../01-brainstorm/outputs/personas.md` - User personas
 
 ---
 
-## AI 호출 기록
+## AI Call Log
 
-| AI | 호출 시간 | 프롬프트 | 결과 | 상태 |
-|----|----------|---------|------|------|
+| AI | Call Time | Prompt | Result | Status |
+|----|-----------|--------|--------|--------|
 | {{AI_1}} | {{TIME_1}} | {{PROMPT_1}} | {{OUTPUT_1}} | {{STATUS_1}} |
 | {{AI_2}} | {{TIME_2}} | {{PROMPT_2}} | {{OUTPUT_2}} | {{STATUS_2}} |
 
-> 설정: `config/ai_logging.yaml`
+> Configuration: `config/ai_logging.yaml`
 
 ---
 
-## 메타데이터
+## Metadata
 
 ```yaml
 stage: "03-planning"

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

@@ -44,6 +44,46 @@ User interface and experience design stage
 - `../03-planning/outputs/architecture.md`
 - `../03-planning/HANDOFF.md`
 
+## Moodboard Analysis
+
+> Configuration: `config/ui-ux.yaml`
+
+When images are present in `inputs/moodboard/`, analyze them using vision capabilities:
+
+### Directory Structure
+```
+inputs/moodboard/
+├── ui-references/    # Reference UI screenshots
+├── brand-assets/     # Brand colors, logos, typography
+└── sketches/         # Wireframes and hand-drawn sketches
+```
+
+### Analysis Workflow
+
+1. **ui-references/** - Reference UI Screenshots
+   - Identify UI patterns and components
+   - Extract layout structures
+   - Note interaction patterns
+
+2. **brand-assets/** - Brand Assets
+   - Extract color palette (primary, secondary, accent)
+   - Identify typography styles
+   - Document logo usage guidelines
+
+3. **sketches/** - Wireframes & Sketches
+   - Interpret hand-drawn wireframes
+   - Map sketch elements to components
+   - Identify user flow intentions
+
+### Vision Analysis Checklist
+- [ ] Extract color palette from brand assets
+- [ ] Identify layout patterns from references
+- [ ] Map sketch elements to component suggestions
+- [ ] Document design constraints from references
+- [ ] Generate initial component list from analysis
+
+**Note:** AI analyzes images manually using vision capabilities. No automated scripts required.
+
 ## Output Files
 - `outputs/wireframes.md` - Wireframes (ASCII/Mermaid)
 - `outputs/user_flows.md` - User flows

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

@@ -1,87 +1,87 @@
 # Stage Handoff: 04-ui-ux → 05-task-management
 
-**생성일**: {{TIMESTAMP}}
-**생성자**: Gemini
-**소요 시간**: {{DURATION}}
+**Created**: {{TIMESTAMP}}
+**Creator**: Gemini
+**Duration**: {{DURATION}}
 
 ---
 
-## 완료된 작업
+## Completed Tasks
 
-- [ ] 정보 아키텍처 정의
-- [ ] 와이어프레임 작성 ({{SCREEN_COUNT}}개 화면)
-- [ ] 사용자 플로우 정의 ({{FLOW_COUNT}}개)
-- [ ] 디자인 시스템 기초 수립
-- [ ] HANDOFF.md 생성
+- [ ] Information architecture definition
+- [ ] Wireframe creation ({{SCREEN_COUNT}} screens)
+- [ ] User flow definition ({{FLOW_COUNT}} flows)
+- [ ] Design system foundation establishment
+- [ ] HANDOFF.md generation
 
 ---
 
-## 다음 에이전트를 위한 컨텍스트
+## Context for Next Agent
 
-### 화면 목록
+### Screen List
 
-| # | 화면 | 우선순위 | 복잡도 |
-|---|------|----------|--------|
+| # | Screen | Priority | Complexity |
+|---|--------|----------|------------|
 | 1 | {{SCREEN_1}} | Must | |
 | 2 | {{SCREEN_2}} | Must | |
 | 3 | {{SCREEN_3}} | Should | |
 
-### 컴포넌트 목록
+### Component List
 
-| 컴포넌트 | 변형 | 재사용성 |
-|----------|------|----------|
+| Component | Variants | Reusability |
+|-----------|----------|-------------|
 | Button | Primary, Secondary, Ghost | High |
 | Input | Text, Password, Search | High |
 | Card | Default, Compact | Medium |
 
-### 디자인 토큰 요약
+### Design Token Summary
 - **Primary Color**: {{PRIMARY_COLOR}}
 - **Font Family**: {{FONT_FAMILY}}
 - **Base Spacing**: {{SPACING}}
 
-### 핵심 사용자 플로우
+### Core User Flows
 1. {{FLOW_1}}
 2. {{FLOW_2}}
 3. {{FLOW_3}}
 
 ---
 
-## 생성된 산출물
+## Generated Outputs
 
-| 파일 | 설명 |
-|------|------|
-| wireframes.md | 화면 와이어프레임 |
-| user_flows.md | 사용자 플로우 |
-| design_system.md | 디자인 시스템 |
+| File | Description |
+|------|-------------|
+| wireframes.md | Screen wireframes |
+| user_flows.md | User flows |
+| design_system.md | Design system |
 
 ---
 
-## 05-task-management 스테이지 가이드
+## 05-task-management Stage Guide
 
-### 즉시 실행할 작업
-1. 화면/컴포넌트 기반 태스크 분해
-2. 의존성 파악
-3. 스프린트 할당
+### Immediate Tasks
+1. Task breakdown based on screens/components
+2. Identify dependencies
+3. Sprint allocation
 
-### 구현 우선순위 제안
-1. 공통 컴포넌트 (Button, Input, Card)
-2. 레이아웃 컴포넌트
-3. 핵심 화면 구현
+### Implementation Priority Proposal
+1. Common components (Button, Input, Card)
+2. Layout components
+3. Core screen implementation
 
 ---
 
-## AI 호출 기록
+## AI Call Log
 
-| AI | 호출 시간 | 프롬프트 | 결과 | 상태 |
-|----|----------|---------|------|------|
+| AI | Call Time | Prompt | Result | Status |
+|----|-----------|--------|--------|--------|
 | {{AI_1}} | {{TIME_1}} | {{PROMPT_1}} | {{OUTPUT_1}} | {{STATUS_1}} |
 | {{AI_2}} | {{TIME_2}} | {{PROMPT_2}} | {{OUTPUT_2}} | {{STATUS_2}} |
 
-> 설정: `config/ai_logging.yaml`
+> Configuration: `config/ai_logging.yaml`
 
 ---
 
-## 메타데이터
+## Metadata
 
 ```yaml
 stage: "04-ui-ux"

package/template/stages/04-ui-ux/inputs/moodboard/brand-assets/.gitkeep

@@ -0,0 +1,3 @@
+# Brand Assets
+# Place brand colors, logos, typography samples here
+# Supported formats: PNG, JPG, WEBP, SVG

package/template/stages/04-ui-ux/inputs/moodboard/sketches/.gitkeep

@@ -0,0 +1,3 @@
+# Sketches & Wireframes
+# Place hand-drawn sketches and wireframe images here
+# Supported formats: PNG, JPG, WEBP, SVG

package/template/stages/04-ui-ux/inputs/moodboard/ui-references/.gitkeep

@@ -0,0 +1,3 @@
+# UI References
+# Place UI screenshots and reference images here
+# Supported formats: PNG, JPG, WEBP, SVG

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

@@ -1,90 +1,90 @@
 # Stage Handoff: 05-task-management → 06-implementation
 
-**생성일**: {{TIMESTAMP}}
-**생성자**: ClaudeCode
-**소요 시간**: {{DURATION}}
+**Created**: {{TIMESTAMP}}
+**Creator**: ClaudeCode
+**Duration**: {{DURATION}}
 
 ---
 
-## 완료된 작업
+## Completed Tasks
 
-- [ ] 태스크 분해 (총 {{TASK_COUNT}}개)
-- [ ] 의존성 맵핑
-- [ ] 스프린트 계획 ({{SPRINT_COUNT}}개)
-- [ ] 마일스톤 정의
-- [ ] HANDOFF.md 생성
+- [ ] Task breakdown ({{TASK_COUNT}} total tasks)
+- [ ] Dependency mapping
+- [ ] Sprint planning ({{SPRINT_COUNT}} sprints)
+- [ ] Milestone definition
+- [ ] HANDOFF.md generation
 
 ---
 
-## 다음 에이전트를 위한 컨텍스트
+## Context for Next Agent
 
-### 스프린트 1 태스크 (즉시 시작)
+### Sprint 1 Tasks (Start Immediately)
 
-| ID | 태스크 | 우선순위 | 의존성 |
-|----|--------|----------|--------|
+| ID | Task | Priority | Dependencies |
+|----|------|----------|--------------|
 | {{TASK_1_ID}} | {{TASK_1}} | Must | - |
 | {{TASK_2_ID}} | {{TASK_2}} | Must | {{DEP_2}} |
 | {{TASK_3_ID}} | {{TASK_3}} | Should | {{DEP_3}} |
 
-### 의존성 요약
+### Dependency Summary
 ```mermaid
 graph TD
     {{DEPENDENCY_GRAPH}}
 ```
 
-### 마일스톤
+### Milestones
 
-| 마일스톤 | 목표 | 완료 기준 |
-|----------|------|-----------|
+| Milestone | Goal | Completion Criteria |
+|-----------|------|---------------------|
 | M1 | {{M1_GOAL}} | {{M1_CRITERIA}} |
 | M2 | {{M2_GOAL}} | {{M2_CRITERIA}} |
 
-### 기술적 주의사항
+### Technical Notes
 - {{TECH_NOTE_1}}
 - {{TECH_NOTE_2}}
 
 ---
 
-## 생성된 산출물
+## Generated Outputs
 
-| 파일 | 설명 |
-|------|------|
-| tasks.md | 전체 태스크 목록 |
-| sprint_plan.md | 스프린트 계획 |
-| milestones.md | 마일스톤 정의 |
+| File | Description |
+|------|-------------|
+| tasks.md | Complete task list |
+| sprint_plan.md | Sprint plan |
+| milestones.md | Milestone definitions |
 
 ---
 
-## 06-implementation 스테이지 가이드
+## 06-implementation Stage Guide
 
-### 즉시 실행할 작업
-1. 프로젝트 초기화 (scaffolding)
-2. 공통 컴포넌트 구현
-3. {{FIRST_FEATURE}} 구현 시작
+### Immediate Tasks
+1. Project initialization (scaffolding)
+2. Common component implementation
+3. Start implementing {{FIRST_FEATURE}}
 
-### 구현 순서 권장
+### Recommended Implementation Order
 1. {{IMPL_ORDER_1}}
 2. {{IMPL_ORDER_2}}
 3. {{IMPL_ORDER_3}}
 
-### 체크포인트 트리거
-- 스프린트 1 완료 시
-- 핵심 기능 구현 완료 시
+### Checkpoint Triggers
+- On Sprint 1 completion
+- On core feature implementation completion
 
 ---
 
-## AI 호출 기록
+## AI Call Log
 
-| AI | 호출 시간 | 프롬프트 | 결과 | 상태 |
-|----|----------|---------|------|------|
+| AI | Call Time | Prompt | Result | Status |
+|----|-----------|--------|--------|--------|
 | {{AI_1}} | {{TIME_1}} | {{PROMPT_1}} | {{OUTPUT_1}} | {{STATUS_1}} |
 | {{AI_2}} | {{TIME_2}} | {{PROMPT_2}} | {{OUTPUT_2}} | {{STATUS_2}} |
 
-> 설정: `config/ai_logging.yaml`
+> Configuration: `config/ai_logging.yaml`
 
 ---
 
-## 메타데이터
+## Metadata
 
 ```yaml
 stage: "05-task-management"

package/template/stages/06-implementation/CLAUDE.md

@@ -90,6 +90,89 @@ cd project-name
 - Create checkpoint upon each sprint completion
 - Create checkpoint upon major feature completion
 
+---
+
+## Iterative Development Mode
+
+> Stage 06 operates in **sprint-based iterative mode**.
+
+### Sprint Workflow
+
+1. Sprint Start → Task Progress → Sprint Complete
+2. `/next` → Auto-advance to next Sprint (if Sprints remain)
+3. After all Sprints complete, `/next` → Transition to Stage 07
+
+### Sprint Commands
+
+| Command | Description |
+|---------|-------------|
+| `/sprint` | Show current Sprint status |
+| `/sprint tasks` | List tasks for current Sprint |
+| `/next` | Sprint remaining → Next Sprint / Complete → Stage 07 |
+| `/next --stage` | Force Stage transition (skip Sprints, not recommended) |
+
+---
+
+## ⚠️ Mandatory Git Commit Rule
+
+> **CRITICAL**: Starting from Stage 06, git commit is REQUIRED after every task completion.
+
+### Per-Task Commit Protocol
+After completing each task:
+
+1. **Stage changes**
+   ```bash
+   git add <relevant-files>
+   ```
+
+2. **Commit with conventional format**
+   ```bash
+   git commit -m "feat(impl): <task description>"
+   ```
+
+3. **Verify clean state**
+   ```bash
+   git status  # Should show "nothing to commit"
+   ```
+
+### Commit Message Format
+| Task Type | Format | Example |
+|-----------|--------|---------|
+| New feature | `feat(impl): ...` | `feat(impl): add user login form` |
+| Component | `feat(impl): ...` | `feat(impl): create Button component` |
+| API | `feat(impl): ...` | `feat(impl): implement auth API endpoint` |
+| Style | `style(impl): ...` | `style(impl): add responsive styles` |
+
+### ❌ Prohibited
+- Proceeding to next task without committing
+- Batching multiple tasks into single commit
+- WIP or meaningless commit messages
+
+### ✅ Required
+- One commit per task (minimum)
+- Meaningful, descriptive commit messages
+- Clean working directory before next task
+
+---
+
+### Sprint Completion Criteria
+
+Each Sprint completion requires:
+- [ ] All Must tasks completed
+- [ ] `npm run lint` passed
+- [ ] `npm run typecheck` passed
+- [ ] Sprint checkpoint created
+
+### Sprint HANDOFF
+
+On Sprint transition, `SPRINT_HANDOFF_N.md` is auto-generated:
+- Completed tasks list
+- Test results summary
+- Checkpoint reference
+- Next Sprint focus
+
+---
+
 ## Implementation Principles
 1. Commit in small units
 2. Write testable code