claude-symphony 0.0.1 → 0.0.2

package/template/stages/05-task-management/templates/parallel_groups.yaml

@@ -1,102 +1,102 @@
 # Parallel Task Groups Configuration
-# claude-symphony 병렬 태스크 관리 (Issue #9 해결)
+# claude-symphony Parallel Task Management (Issue #9 Resolution)
 
 parallel_execution:
-  # 병렬 실행 활성화 여부
+  # Enable parallel execution
   enabled: true
 
-  # 기본 규칙
+  # Default rules
   default_mode: "sequential"  # sequential | parallel_when_safe
 
-# 의존성 분석 규칙
+# Dependency analysis rules
 dependency_analysis:
-  # 의존성 없는 태스크 자동 그룹화
+  # Auto-group independent tasks
   auto_group_independent: true
 
-  # 의존성 유형
+  # Dependency types
   dependency_types:
     - type: "blocks"
-      description: "완료되어야 다음 태스크 시작 가능"
+      description: "Must complete before next task can start"
 
     - type: "informs"
-      description: "참조하지만 블로킹 아님"
+      description: "References but non-blocking"
 
     - type: "none"
-      description: "완전 독립"
+      description: "Completely independent"
 
-# 병렬 그룹 템플릿
+# Parallel group templates
 parallel_groups:
-  # 예시: 스프린트 1 태스크 그룹
+  # Example: Sprint 1 task groups
   sprint_1:
-    # 그룹 A: 병렬 실행 가능
+    # Group A: Can run in parallel
     group_a:
       tasks:
-        - "TASK-001: 프로젝트 초기 설정"
-        - "TASK-002: 환경 변수 설정"
-        - "TASK-003: ESLint/Prettier 설정"
+        - "TASK-001: Project initial setup"
+        - "TASK-002: Environment variable setup"
+        - "TASK-003: ESLint/Prettier setup"
       parallel: true
-      reason: "독립적인 설정 작업들"
+      reason: "Independent setup tasks"
 
-    # 그룹 B: 그룹 A 완료 후 병렬 실행
+    # Group B: Run in parallel after Group A completes
     group_b:
       depends_on: ["group_a"]
       tasks:
-        - "TASK-004: 레이아웃 컴포넌트"
-        - "TASK-005: 네비게이션 컴포넌트"
-        - "TASK-006: 푸터 컴포넌트"
+        - "TASK-004: Layout component"
+        - "TASK-005: Navigation component"
+        - "TASK-006: Footer component"
       parallel: true
-      reason: "공통 컴포넌트, 상호 의존성 없음"
+      reason: "Common components, no interdependencies"
 
-    # 그룹 C: 순차 실행 필요
+    # Group C: Sequential execution required
     group_c:
       depends_on: ["group_b"]
       tasks:
-        - "TASK-007: API 클라이언트 설정"
-        - "TASK-008: 인증 서비스 구현"
-        - "TASK-009: 보호된 라우트 설정"
+        - "TASK-007: API client setup"
+        - "TASK-008: Auth service implementation"
+        - "TASK-009: Protected route setup"
       parallel: false
-      reason: "순차적 의존성 있음"
+      reason: "Has sequential dependencies"
 
-# 병렬 실행 규칙
+# Execution rules
 execution_rules:
-  # 병렬 실행 가능 조건
+  # Parallel execution allowed conditions
   parallel_allowed_when:
-    - "no_shared_files"           # 동일 파일 수정 없음
-    - "no_data_dependency"        # 데이터 의존성 없음
-    - "different_modules"         # 다른 모듈
-    - "explicit_parallel_flag"    # 명시적 병렬 플래그
+    - "no_shared_files"           # No same file modification
+    - "no_data_dependency"        # No data dependency
+    - "different_modules"         # Different modules
+    - "explicit_parallel_flag"    # Explicit parallel flag
 
-  # 병렬 실행 금지 조건
+  # Parallel execution prohibited conditions
   parallel_prohibited_when:
-    - "same_file_modification"    # 동일 파일 수정
-    - "database_migration"        # DB 마이그레이션
-    - "sequential_dependency"     # 순차 의존성
-    - "shared_state"              # 공유 상태
+    - "same_file_modification"    # Same file modification
+    - "database_migration"        # DB migration
+    - "sequential_dependency"     # Sequential dependency
+    - "shared_state"              # Shared state
 
-# 태스크 분류 가이드
+# Task classification guide
 classification_guide:
-  # 병렬 가능 태스크 유형
+  # Parallelizable task types
   parallelizable:
-    - "독립적인 UI 컴포넌트 구현"
-    - "서로 다른 모듈의 유틸리티 함수"
-    - "독립적인 테스트 작성"
-    - "문서 작성"
-    - "환경 설정 (충돌 없는 경우)"
+    - "Independent UI component implementation"
+    - "Utility functions in different modules"
+    - "Independent test writing"
+    - "Documentation writing"
+    - "Environment setup (when no conflicts)"
 
-  # 순차 필수 태스크 유형
+  # Sequential required task types
   sequential_required:
-    - "데이터베이스 스키마 변경"
-    - "인증/인가 흐름"
-    - "API 엔드포인트 → 클라이언트 통합"
-    - "의존성 있는 컴포넌트 체인"
-    - "버전 업그레이드"
+    - "Database schema changes"
+    - "Authentication/authorization flow"
+    - "API endpoint → client integration"
+    - "Dependent component chain"
+    - "Version upgrades"
 
-# 시각화 형식
+# Visualization format
 visualization:
-  # 의존성 그래프 형식
+  # Dependency graph format
   graph_format: "mermaid"
 
-  # 예시 출력
+  # Example output
   example: |
     ```mermaid
     graph LR
@@ -109,45 +109,45 @@ visualization:
       G --> H[TASK-008]
       H --> I[TASK-009]
 
-      subgraph "그룹 A (병렬)"
+      subgraph "Group A (Parallel)"
         A
         B
         C
       end
 
-      subgraph "그룹 B (병렬)"
+      subgraph "Group B (Parallel)"
         D
         E
         F
       end
 
-      subgraph "그룹 C (순차)"
+      subgraph "Group C (Sequential)"
         G
         H
         I
       end
     ```
 
-# 실행 최적화
+# Execution optimization
 optimization:
-  # 동시 실행 최대 수
+  # Maximum concurrent tasks
   max_concurrent_tasks: 3
 
-  # 리소스 제한
+  # Resource limits
   resource_limits:
     cpu_intensive_concurrent: 2
     io_intensive_concurrent: 5
 
-  # 우선순위 기반 스케줄링
+  # Priority-based scheduling
   priority_scheduling: true
 
-# 모니터링
+# Monitoring
 monitoring:
-  # 진행 상황 추적
+  # Track progress
   track_parallel_progress: true
 
-  # 병목 감지
+  # Bottleneck detection
   detect_bottlenecks: true
 
-  # 완료 알림
+  # Completion notification
   notify_on_group_complete: true

package/template/stages/05-task-management/templates/task_schema.yaml

@@ -1,19 +1,19 @@
 # Task Schema Definition
-# claude-symphony 태스크 관리 스키마 (Issue #4, #6, #8, #16 해결)
+# claude-symphony Task Management Schema (Issue #4, #6, #8, #16 Resolution)
 
 schema:
   name: "Project Tasks"
   version: "1.0.0"
 
-# 필수 필드 정의
+# Required field definitions
 fields:
-  # 태스크 이름 (Title)
+  # Task name (Title)
   - name: "Task Name"
     type: "title"
     required: true
-    description: "태스크 제목"
+    description: "Task title"
 
-  # 상태 필드 (Issue #16: Status 필드 필수!)
+  # Status field (Issue #16: Status field required!)
   - name: "Status"
     type: "select"
     required: true
@@ -30,7 +30,7 @@ fields:
       - name: "Blocked"
         color: "red"
 
-  # 우선순위
+  # Priority
   - name: "Priority"
     type: "select"
     required: false
@@ -43,14 +43,14 @@ fields:
       - name: "Low"
         color: "green"
 
-  # 정렬용 순서 (Issue #5, #6, #8 해결)
+  # Order for sorting (Issue #5, #6, #8 resolution)
   - name: "Order"
     type: "number"
     required: true
-    description: "태스크 순서 (정렬용)"
+    description: "Task order (for sorting)"
     auto_increment: true
 
-  # 스프린트
+  # Sprint
   - name: "Sprint"
     type: "select"
     required: false
@@ -59,29 +59,29 @@ fields:
       - name: "Sprint 2"
       - name: "Sprint 3"
 
-  # 담당자
+  # Assignee
   - name: "Assignee"
     type: "text"
     required: false
 
-  # 예상 시간
+  # Estimated time
   - name: "Estimate"
     type: "text"
     required: false
-    description: "예상 소요 시간 (예: 2h, 1d)"
+    description: "Estimated time (e.g., 2h, 1d)"
 
-  # 마감일
+  # Due date
   - name: "Due Date"
     type: "date"
     required: false
 
-  # 의존성
+  # Dependencies
   - name: "Depends On"
     type: "text"
     required: false
-    description: "선행 태스크 ID (콤마로 구분)"
+    description: "Prerequisite task IDs (comma-separated)"
 
-  # 스테이지
+  # Stage
   - name: "Stage"
     type: "select"
     required: false
@@ -91,44 +91,44 @@ fields:
       - name: "08-qa"
       - name: "09-testing"
 
-# 태스크 생성 규칙 (Issue #6, #8 해결: 순차 생성!)
+# Task creation rules (Issue #6, #8 resolution: Sequential creation!)
 creation_rules:
-  # 병렬 생성 금지 - 순서 보장
+  # Parallel creation prohibited - order guarantee
   mode: "sequential"
   batch_size: 1
 
-  # 순차 생성 절차
+  # Sequential creation procedure
   procedure:
     - step: 1
       action: "create_single_task"
-      description: "단일 태스크 생성"
+      description: "Create single task"
     - step: 2
       action: "verify_order_field"
-      description: "Order 필드 확인"
+      description: "Verify Order field"
     - step: 3
       action: "create_next_task"
-      description: "다음 태스크 생성 (Order + 1)"
+      description: "Create next task (Order + 1)"
 
-  # 금지 사항
+  # Prohibited actions
   prohibited:
-    - "batch_create"      # 일괄 생성 금지
-    - "parallel_create"   # 병렬 생성 금지
+    - "batch_create"      # Batch creation prohibited
+    - "parallel_create"   # Parallel creation prohibited
 
-  # 권장 사항
+  # Recommended actions
   recommended:
-    - "explicit_order"    # 명시적 Order 값 지정
-    - "status_to_do"      # Status = "To Do"로 생성
-    - "sequential_naming" # 순차적 이름 부여
+    - "explicit_order"    # Explicit Order value specification
+    - "status_to_do"      # Create with Status = "To Do"
+    - "sequential_naming" # Sequential naming
 
-# Notion 데이터베이스 생성 템플릿
+# Notion database creation template
 notion_template:
   database_name: "{{PROJECT_NAME}} Tasks"
 
   properties:
     - "Task Name"    # title
-    - "Status"       # select (필수!)
+    - "Status"       # select (required!)
     - "Priority"     # select
-    - "Order"        # number (정렬용!)
+    - "Order"        # number (for sorting!)
     - "Sprint"       # select
     - "Assignee"     # text
     - "Estimate"     # text
@@ -136,7 +136,7 @@ notion_template:
     - "Depends On"   # text
     - "Stage"        # select
 
-  # 기본 뷰 설정
+  # Default view settings
   views:
     - name: "Board View"
       type: "board"

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

@@ -1,163 +1,159 @@
 # Stage 06: Implementation
 
-핵심 기능 구현 단계
-
-## 🎭 페르소나: Precise Builder
-
-> 당신은 Precise Builder입니다.
-> 정확하고 유지보수 가능한 코드를 작성하세요.
-> 에러를 미리 예방하고, 테스트하기 쉬운 구조를 만드세요.
-
-### 특성
-- 정확한 구현
-- 에러 방지
-- 테스트 가능한 코드
-- 클린 코드
-
-### 권장 행동
-- 명확하고 읽기 쉬운 코드
-- 에러 핸들링
-- 타입 안전성
-- 테스트 용이성
-
-### 지양 행동
-- 오버 엔지니어링
-- 매직 넘버/문자열
-- 에러 무시
-- 복잡한 로직
-
-### AI 설정
-- **Temperature**: 0.3 (높은 정밀도)
-- **정밀도**: High
-
-## 실행 모델
-- **Primary**: ClaudeCode (코드 생성)
-- **Mode**: Plan + Sandbox - 안전한 코드 실행
-
-## 목표
-1. 프로젝트 스캐폴딩
-2. 핵심 기능 구현
-3. 데이터베이스 연동
-4. API 구현
-
-## 입력 파일
+Core feature implementation stage
+
+## Persona: Precise Builder
+
+> You are a Precise Builder.
+> Write accurate and maintainable code.
+> Prevent errors proactively and create testable structures.
+
+### Characteristics
+- Precise implementation
+- Error prevention
+- Testable code
+- Clean code
+
+### Recommended Actions
+- Clear and readable code
+- Error handling
+- Type safety
+- Test friendliness
+
+### Actions to Avoid
+- Over-engineering
+- Magic numbers/strings
+- Ignoring errors
+- Complex logic
+
+### AI Settings
+- **Temperature**: 0.3 (high precision)
+- **Precision**: High
+
+## Execution Model
+- **Primary**: ClaudeCode (code generation)
+- **Mode**: Plan + Sandbox - safe code execution
+
+## Goals
+1. Project scaffolding
+2. Core feature implementation
+3. Database integration
+4. API implementation
+
+## Input Files
 - `../05-task-management/outputs/tasks.md`
 - `../03-planning/outputs/architecture.md`
-- `../03-planning/outputs/implementation.yaml` - **구현 규칙 (필수 참조!)**
+- `../03-planning/outputs/implementation.yaml` - **Implementation rules (required reference!)**
 - `../04-ui-ux/outputs/design_system.md`
 - `../05-task-management/HANDOFF.md`
 
-### ⚠️ implementation.yaml 준수 필수
-구현 전 `implementation.yaml` 파일을 읽고 다음 규칙을 확인하세요:
-- 컴포넌트 타입/export 방식
-- 스타일링 접근 방식
-- 상태 관리 패턴
-- 네이밍 규칙
-- 폴더 구조
-- 금지/권장 사항
+### ⚠️ Must Follow implementation.yaml
+Read the `implementation.yaml` file before implementation and verify the following rules:
+- Component type/export method
+- Styling approach
+- State management pattern
+- Naming conventions
+- Folder structure
+- Prohibited/recommended practices
 
-## 출력 파일
-- `outputs/source_code/` - 소스 코드 디렉토리
-- `outputs/implementation_log.md` - 구현 로그
-- `HANDOFF.md` - 다음 스테이지 인계 문서
+## Output Files
+- `outputs/source_code/` - Source code directory
+- `outputs/implementation_log.md` - Implementation log
+- `HANDOFF.md` - Handoff document for next stage
 
-## 워크플로우
+## Workflow
 
-### 1. 프로젝트 초기화
+### 1. Project Initialization
 ```bash
-# 예: Next.js 프로젝트
+# Example: Next.js project
 npx create-next-app@latest project-name
 cd project-name
 ```
 
-### 2. 공통 컴포넌트 구현
-- 디자인 시스템 기반 UI 컴포넌트
-- 레이아웃 컴포넌트
-- 유틸리티 함수
+### 2. Common Component Implementation
+- Design system-based UI components
+- Layout components
+- Utility functions
 
-### 3. 기능 구현
-- 스프린트 1 태스크 순차 구현
-- 각 태스크 완료 시 커밋
-- 구현 로그 업데이트
+### 3. Feature Implementation
+- Sequential implementation of Sprint 1 tasks
+- Commit upon each task completion
+- Update implementation log
 
-### 4. 통합
-- API 연동
-- 데이터베이스 연결
-- 인증/인가 구현
+### 4. Integration
+- API integration
+- Database connection
+- Authentication/authorization implementation
 
-## 체크포인트 규칙
-- **필수**: 이 스테이지는 체크포인트가 필수입니다
-- 스프린트 완료마다 체크포인트 생성
-- 주요 기능 완료 시 체크포인트 생성
+## Checkpoint Rules
+- **Required**: Checkpoints are mandatory for this stage
+- Create checkpoint upon each sprint completion
+- Create checkpoint upon major feature completion
 
-## 구현 원칙
-1. 작은 단위로 커밋
-2. 테스트 가능한 코드 작성
-3. 에러 핸들링 포함
-4. 타입 안전성 확보 (TypeScript)
+## Implementation Principles
+1. Commit in small units
+2. Write testable code
+3. Include error handling
+4. Ensure type safety (TypeScript)
 
 ---
 
-## ⚠️ Test-First 플로우 (필수)
+## ⚠️ Test-First Flow (Required)
 
-> **중요**: 버그 조기 발견을 위해 구현 완료 후 반드시 스모크 테스트를 실행하세요.
-> Snake Game 프로젝트에서 이 단계를 건너뛰어 버그가 2개 스테이지를 통과한 사례가 있습니다.
+> **Important**: Run smoke tests after implementation completion for early bug detection.
+> In the Snake Game project, skipping this step allowed 2 bugs to pass through 2 stages.
 
-### 구현 완료 후 필수 테스트
+### Required Tests After Implementation
 
 ```bash
-# 1. 개발 서버 실행 확인
+# 1. Verify dev server runs
 npm run dev
-# 브라우저에서 기본 동작 확인
+# Verify basic functionality in browser
 
-# 2. 정적 분석
+# 2. Static analysis
 npm run lint
 
-# 3. 타입 체크
+# 3. Type check
 npm run typecheck
 
-# 4. Playwright 스모크 테스트 (설정되어 있다면)
+# 4. Playwright smoke test (if configured)
 npx playwright test --grep @smoke
 ```
 
-### 테스트 실패 시 조치
-1. **lint 오류**: 즉시 수정
-2. **typecheck 오류**: 타입 정의 수정
-3. **런타임 오류**: 버그로 기록하고 수정
-4. **UI 동작 이상**: 버그 ID 부여 (예: BUG-001)
+### Actions on Test Failure
+1. **lint errors**: Fix immediately
+2. **typecheck errors**: Fix type definitions
+3. **Runtime errors**: Record as bug and fix
+4. **UI behavior issues**: Assign bug ID (e.g., BUG-001)
 
-### 버그 기록 형식
+### Bug Recording Format
 ```markdown
-### BUG-001: [버그 제목]
-- **발견 시점**: 06-implementation 스모크 테스트
-- **증상**: [증상 설명]
-- **원인**: [원인 분석]
-- **수정 파일**: [파일 경로]
-- **상태**: 수정됨 / 미수정
+### BUG-001: [Bug Title]
+- **Discovery Point**: 06-implementation smoke test
+- **Symptom**: [Symptom description]
+- **Cause**: [Cause analysis]
+- **Modified File**: [File path]
+- **Status**: Fixed / Unfixed
 ```
 
-### HANDOFF.md 테스트 섹션 필수
-HANDOFF.md에 반드시 테스트 결과 섹션을 포함하세요:
-- 실행한 테스트 목록
-- 테스트 결과 (통과/실패)
-- 발견된 버그 (있다면)
-- 버그 수정 상태
+### HANDOFF.md Test Section Required
+Include test results section in HANDOFF.md:
+- List of tests executed
+- Test results (pass/fail)
+- Discovered bugs (if any)
+- Bug fix status
 
 ---
 
-## 완료 조건
-- [ ] 프로젝트 스캐폴딩 완료
-- [ ] 공통 컴포넌트 구현
-- [ ] 핵심 기능 구현 (스프린트 1-2)
-- [ ] API 엔드포인트 구현
-- [ ] **스모크 테스트 실행** (Test-First)
-- [ ] **lint/typecheck 통과**
-- [ ] 체크포인트 생성
-- [ ] HANDOFF.md 생성 (테스트 결과 포함)
-
-## 다음 스테이지
-→ **07-refactoring**: 코드 품질 개선 및 최적화
-
-
-
-
+## Completion Criteria
+- [ ] Project scaffolding complete
+- [ ] Common components implemented
+- [ ] Core features implemented (Sprint 1-2)
+- [ ] API endpoints implemented
+- [ ] **Smoke tests executed** (Test-First)
+- [ ] **lint/typecheck passed**
+- [ ] Checkpoint created
+- [ ] HANDOFF.md generated (including test results)
+
+## Next Stage
+→ **07-refactoring**: Code quality improvement and optimization