claude-symphony 0.0.1 → 0.0.3

package/template/.claude/hooks/session-start.sh

@@ -1,9 +1,9 @@
 #!/bin/bash
-# session-start.sh - 세션 시작 시 자동 복구
+# session-start.sh - Session start auto-recovery
 # claude-symphony workflow pipeline
 #
-# SessionStart hook: Claude Code 세션 시작/재개 시 실행
-# /compact 후 저장된 스냅샷이 있으면 자동으로 컨텍스트 복구 안내
+# SessionStart hook: Runs when Claude Code session starts/resumes
+# If snapshot exists from /compact, provides auto context recovery guidance
 
 set -e
 
@@ -12,64 +12,64 @@ TRIGGER_FILE="$PROJECT_ROOT/state/context/auto-trigger.json"
 CONTEXT_DIR="$PROJECT_ROOT/state/context"
 PROGRESS_FILE="$PROJECT_ROOT/state/progress.json"
 
-# 컨텍스트 디렉토리 확인
+# Ensure context directory
 mkdir -p "$CONTEXT_DIR"
 
-# jq 필요
+# jq required
 if ! command -v jq &> /dev/null; then
     exit 0
 fi
 
-# 1. 트리거 파일 확인 - compact가 실행되었는지
+# 1. Check trigger file - if compact was executed
 if [ ! -f "$TRIGGER_FILE" ]; then
-    exit 0  # 복구 필요 없음
+    exit 0  # No recovery needed
 fi
 
 COMPACT_SCHEDULED=$(jq -r '.compact_scheduled // false' "$TRIGGER_FILE" 2>/dev/null || echo "false")
 if [ "$COMPACT_SCHEDULED" != "true" ]; then
-    exit 0  # compact가 예정되지 않았음
+    exit 0  # compact not scheduled
 fi
 
-# 2. 최근 스냅샷 찾기
+# 2. Find latest snapshot
 LATEST_SNAPSHOT=$(ls -1t "$CONTEXT_DIR"/auto-snapshot-*.md 2>/dev/null | head -1)
 if [ -z "$LATEST_SNAPSHOT" ]; then
-    # 스냅샷 없음 - 트리거 파일 정리
+    # No snapshot - cleanup trigger file
     rm -f "$TRIGGER_FILE"
     exit 0
 fi
 
-# 3. 현재 스테이지 정보
+# 3. Get current stage info
 CURRENT_STAGE="none"
 if [ -f "$PROGRESS_FILE" ]; then
     CURRENT_STAGE=$(jq -r '.current_stage // "none"' "$PROGRESS_FILE" 2>/dev/null || echo "none")
 fi
 
-# 4. 복구 컨텍스트 생성 (Claude에게 전달)
+# 4. Create recovery context (passed to Claude)
 RECOVERY_CONTEXT=$(cat << EOF
 
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-🔄 세션 복구 - 자동 /compact 후 재시작
+🔄 Session Recovery - Restart after auto /compact
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-## 복구 정보
-- 스냅샷: $(basename "$LATEST_SNAPSHOT")
-- 스테이지: $CURRENT_STAGE
-- 저장 시간: $(jq -r '.timestamp // "unknown"' "$TRIGGER_FILE" 2>/dev/null)
+## Recovery Information
+- Snapshot: $(basename "$LATEST_SNAPSHOT")
+- Stage: $CURRENT_STAGE
+- Save time: $(jq -r '.timestamp // "unknown"' "$TRIGGER_FILE" 2>/dev/null)
 
-## 스냅샷 내용
+## Snapshot Contents
 $(cat "$LATEST_SNAPSHOT" 2>/dev/null | head -50)
 
-## 복구 지침
-1. 위 스냅샷 내용을 참고하여 작업 컨텍스트 파악
-2. stages/$CURRENT_STAGE/CLAUDE.md 확인
-3. 중단된 작업부터 재개
+## Recovery Instructions
+1. Review snapshot contents above to understand work context
+2. Check stages/$CURRENT_STAGE/CLAUDE.md
+3. Resume from interrupted work
 
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 EOF
 )
 
-# 5. JSON 출력 (Claude에게 컨텍스트 전달)
-# additionalContext를 통해 Claude가 복구 정보를 받음
+# 5. JSON output (passing context to Claude)
+# Claude receives recovery info through additionalContext
 cat << EOF
 {
     "hookSpecificOutput": {
@@ -79,12 +79,12 @@ cat << EOF
 }
 EOF
 
-# 6. 트리거 파일 정리 (복구 완료 표시)
+# 6. Cleanup trigger file (mark recovery complete)
 jq '. + {"recovered": true, "recovery_time": "'"$(date -Iseconds)"'"}' \
     "$TRIGGER_FILE" > "$TRIGGER_FILE.tmp" && mv "$TRIGGER_FILE.tmp" "$TRIGGER_FILE"
 
-# 일정 시간 후 트리거 파일 삭제 (다음 세션에서 중복 복구 방지)
-# 백그라운드에서 5분 후 삭제
+# Delete trigger file after some time (prevent duplicate recovery in next session)
+# Delete in background after 5 minutes
 (sleep 300 && rm -f "$TRIGGER_FILE" 2>/dev/null) &
 
 exit 0

package/template/.claude/hooks/statusline.sh

@@ -1,9 +1,9 @@
 #!/bin/bash
-# statusline.sh - Claude Code Statusline API를 통한 실시간 컨텍스트 모니터링
+# statusline.sh - Real-time context monitoring via Claude Code Statusline API
 # claude-symphony workflow pipeline
 #
-# Claude Code가 ~300ms마다 JSON을 stdin으로 전달합니다.
-# 이 스크립트는 remaining_percentage를 분석하여 임계값 도달 시 자동 조치를 수행합니다.
+# Claude Code passes JSON to stdin every ~300ms.
+# This script analyzes remaining_percentage and performs auto actions when thresholds are reached.
 
 set -e
 
@@ -12,69 +12,69 @@ STATE_FILE="$PROJECT_ROOT/state/context/auto-trigger.json"
 PROGRESS_FILE="$PROJECT_ROOT/state/progress.json"
 CONTEXT_DIR="$PROJECT_ROOT/state/context"
 
-# 컨텍스트 디렉토리 확인
+# Ensure context directory
 mkdir -p "$CONTEXT_DIR"
 
-# stdin에서 JSON 읽기
+# Read JSON from stdin
 input=$(cat)
 
-# JSON 파싱 (jq 필요)
+# JSON parsing (jq required)
 if ! command -v jq &> /dev/null; then
-    echo "[CTX] jq 필요"
+    echo "[CTX] jq required"
     exit 0
 fi
 
-# 컨텍스트 데이터 추출
+# Extract context data
 REMAINING=$(echo "$input" | jq -r '.context_window.remaining_percentage // 100' 2>/dev/null || echo "100")
 USED=$(echo "$input" | jq -r '.context_window.used_percentage // 0' 2>/dev/null || echo "0")
 MODEL=$(echo "$input" | jq -r '.model.display_name // "Claude"' 2>/dev/null || echo "Claude")
 CONTEXT_SIZE=$(echo "$input" | jq -r '.context_window.context_window_size // 200000' 2>/dev/null || echo "200000")
 
-# 현재 스테이지 가져오기
+# Get current stage
 if [ -f "$PROGRESS_FILE" ]; then
     CURRENT_STAGE=$(jq -r '.current_stage // "none"' "$PROGRESS_FILE" 2>/dev/null || echo "none")
 else
     CURRENT_STAGE="none"
 fi
 
-# 숫자 비교를 위한 정수 변환
+# Convert to integer for numeric comparison
 REMAINING_INT=$(printf "%.0f" "$REMAINING" 2>/dev/null || echo "100")
 
-# 상태 및 색상 결정
-# 임계값: 60% 경고, 50% 자동저장, 40% 크리티컬
+# Determine status and color
+# Thresholds: 60% warning, 50% auto-save, 40% critical
 if [ "$REMAINING_INT" -le 40 ]; then
-    # 40% 이하: 크리티컬 - /clear 권고
+    # 40% or below: Critical - recommend /clear
     STATUS_ICON="🔴"
     STATUS_TEXT="CTX≤40%"
     NEEDS_ACTION="critical"
 elif [ "$REMAINING_INT" -le 50 ]; then
-    # 50% 이하: 자동 스냅샷 트리거
+    # 50% or below: Auto snapshot trigger
     STATUS_ICON="⚠️"
     STATUS_TEXT="CTX≤50%"
     NEEDS_ACTION="warning"
 elif [ "$REMAINING_INT" -le 60 ]; then
-    # 60% 이하: 경고 표시
+    # 60% or below: Warning display
     STATUS_ICON="⚡"
     STATUS_TEXT="CTX≤60%"
     NEEDS_ACTION="notice"
 else
-    # 정상
+    # Normal
     STATUS_ICON="✓"
     STATUS_TEXT=""
     NEEDS_ACTION="none"
 fi
 
-# 50% 이하일 때 자동 조치
+# Auto action when 50% or below
 if [ "$NEEDS_ACTION" = "warning" ] || [ "$NEEDS_ACTION" = "critical" ]; then
-    # 이미 트리거 되었는지 확인 (중복 방지)
+    # Check if already triggered (prevent duplicates)
     ALREADY_TRIGGERED=false
     if [ -f "$STATE_FILE" ]; then
         TRIGGERED=$(jq -r '.triggered // false' "$STATE_FILE" 2>/dev/null || echo "false")
         TRIGGER_REMAINING=$(jq -r '.remaining // 100' "$STATE_FILE" 2>/dev/null || echo "100")
 
-        # 같은 레벨에서 이미 트리거 되었으면 스킵
+        # Skip if already triggered at same level
         if [ "$TRIGGERED" = "true" ]; then
-            # 더 낮은 레벨로 떨어지면 다시 트리거
+            # Re-trigger if dropped to lower level
             if [ "$REMAINING_INT" -lt "$TRIGGER_REMAINING" ]; then
                 ALREADY_TRIGGERED=false
             else
@@ -84,7 +84,7 @@ if [ "$NEEDS_ACTION" = "warning" ] || [ "$NEEDS_ACTION" = "critical" ]; then
     fi
 
     if [ "$ALREADY_TRIGGERED" = false ]; then
-        # 트리거 상태 기록
+        # Record trigger state
         cat > "$STATE_FILE" << EOF
 {
     "triggered": true,
@@ -95,19 +95,19 @@ if [ "$NEEDS_ACTION" = "warning" ] || [ "$NEEDS_ACTION" = "critical" ]; then
 }
 EOF
 
-        # 자동 스냅샷 생성 (백그라운드)
+        # Create auto snapshot (background)
         if [ -x "$PROJECT_ROOT/scripts/context-manager.sh" ]; then
             "$PROJECT_ROOT/scripts/context-manager.sh" --auto-compact "$NEEDS_ACTION" 2>/dev/null &
         fi
     fi
 fi
 
-# 컨텍스트가 충분해지면 (70% 이상) 트리거 상태 리셋
+# Reset trigger state when context is sufficient (70% or above)
 if [ "$REMAINING_INT" -ge 70 ] && [ -f "$STATE_FILE" ]; then
     rm -f "$STATE_FILE"
 fi
 
-# 상태줄 출력
+# Output statusline
 if [ -n "$STATUS_TEXT" ]; then
     echo "[$MODEL] $STATUS_ICON $STATUS_TEXT ${REMAINING_INT}% | Stage: $CURRENT_STAGE"
 else

package/template/.claude/hooks/stop.sh

@@ -1,9 +1,9 @@
 #!/bin/bash
-# stop.sh - Claude 응답 완료 후 컨텍스트 자동 관리
+# stop.sh - Auto context management after Claude response
 # claude-symphony workflow pipeline
 #
-# Stop hook: Claude 응답이 완료된 후 실행됨
-# 컨텍스트가 50% 이하이면 자동으로 /compact 실행
+# Stop hook: Runs after Claude response completes
+# If context is 50% or below, automatically runs /compact
 
 set -e
 
@@ -13,23 +13,23 @@ COOLDOWN_FILE="$PROJECT_ROOT/state/context/.last-compact"
 CONTEXT_DIR="$PROJECT_ROOT/state/context"
 PROGRESS_FILE="$PROJECT_ROOT/state/progress.json"
 
-# 쿨다운 시간 (초) - 5분
+# Cooldown time (seconds) - 5 minutes
 COOLDOWN_SECONDS=300
 
-# 컨텍스트 디렉토리 확인
+# Ensure context directory
 mkdir -p "$CONTEXT_DIR"
 
-# jq 필요
+# jq required
 if ! command -v jq &> /dev/null; then
     exit 0
 fi
 
-# stdin에서 hook 데이터 읽기
+# Read hook data from stdin
 input=$(cat)
 
-# 1. 트리거 파일 확인 (statusline.sh에서 생성)
+# 1. Check trigger file (created by statusline.sh)
 if [ ! -f "$TRIGGER_FILE" ]; then
-    exit 0  # 트리거 없음 - 정상 상태
+    exit 0  # No trigger - normal state
 fi
 
 TRIGGERED=$(jq -r '.triggered // false' "$TRIGGER_FILE" 2>/dev/null || echo "false")
@@ -40,65 +40,65 @@ fi
 REMAINING=$(jq -r '.remaining // 100' "$TRIGGER_FILE" 2>/dev/null || echo "100")
 LEVEL=$(jq -r '.level // "warning"' "$TRIGGER_FILE" 2>/dev/null || echo "warning")
 
-# 50% 이하가 아니면 스킵
+# Skip if not 50% or below
 if [ "$REMAINING" -gt 50 ]; then
     exit 0
 fi
 
-# 2. 쿨다운 확인 (5분 내 재실행 방지)
+# 2. Check cooldown (prevent re-run within 5 minutes)
 if [ -f "$COOLDOWN_FILE" ]; then
     LAST_COMPACT=$(cat "$COOLDOWN_FILE" 2>/dev/null || echo "0")
     NOW=$(date +%s)
     ELAPSED=$((NOW - LAST_COMPACT))
 
     if [ "$ELAPSED" -lt "$COOLDOWN_SECONDS" ]; then
-        # 쿨다운 중 - 스킵
+        # In cooldown - skip
         REMAINING_COOLDOWN=$((COOLDOWN_SECONDS - ELAPSED))
         exit 0
     fi
 fi
 
-# 3. tmux 세션 확인
+# 3. Check tmux session
 if [ -z "$TMUX" ]; then
-    # tmux 세션이 아님 - 수동 안내만 제공
+    # Not in tmux session - provide manual guidance only
     echo ""
     echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-    echo "⚠️  컨텍스트 ${REMAINING}% - /compact 실행을 권장합니다"
+    echo "⚠️  Context ${REMAINING}% - Running /compact is recommended"
     echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
     exit 0
 fi
 
-# 4. 스냅샷 저장 확인 (이미 statusline.sh에서 저장했어야 함)
+# 4. Verify snapshot saved (should be saved by statusline.sh already)
 LATEST_SNAPSHOT=$(ls -1t "$CONTEXT_DIR"/auto-snapshot-*.md 2>/dev/null | head -1)
 if [ -z "$LATEST_SNAPSHOT" ]; then
-    # 스냅샷 없음 - 먼저 저장
+    # No snapshot - save first
     "$PROJECT_ROOT/scripts/context-manager.sh" --auto-compact "$LEVEL" 2>/dev/null || true
     LATEST_SNAPSHOT=$(ls -1t "$CONTEXT_DIR"/auto-snapshot-*.md 2>/dev/null | head -1)
 fi
 
-# 스냅샷이 여전히 없으면 안전을 위해 스킵
+# Skip for safety if snapshot still doesn't exist
 if [ -z "$LATEST_SNAPSHOT" ]; then
     echo ""
-    echo "⚠️  스냅샷 저장 실패 - /compact 자동 실행 취소"
+    echo "⚠️  Snapshot save failed - Auto /compact cancelled"
     exit 0
 fi
 
-# 5. 사전 알림
+# 5. Pre-notification
 echo ""
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "🔄 컨텍스트 ${REMAINING}% - 자동 /compact 실행 중..."
-echo "   스냅샷: $(basename "$LATEST_SNAPSHOT")"
+echo "🔄 Context ${REMAINING}% - Running auto /compact..."
+echo "   Snapshot: $(basename "$LATEST_SNAPSHOT")"
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 
-# 6. 쿨다운 타이머 기록
+# 6. Record cooldown timer
 date +%s > "$COOLDOWN_FILE"
 
-# 7. 트리거 파일에 compact 예정 표시
+# 7. Mark compact scheduled in trigger file
 jq '. + {"compact_scheduled": true, "compact_time": "'"$(date -Iseconds)"'"}' \
     "$TRIGGER_FILE" > "$TRIGGER_FILE.tmp" && mv "$TRIGGER_FILE.tmp" "$TRIGGER_FILE"
 
-# 8. tmux send-keys로 /compact 실행 (현재 pane에)
-sleep 1  # 잠시 대기 (출력이 보이도록)
+# 8. Run /compact via tmux send-keys (to current pane)
+sleep 1  # Brief wait (for output to be visible)
 tmux send-keys "/compact" Enter
 
 exit 0

package/template/.claude/settings.json

@@ -20,129 +20,129 @@
   },
 
   "hooks_info": {
-    "note": "실제 hooks 설정은 settings.local.json에 있음",
-    "stop": ".claude/hooks/stop.sh - 자동 /compact",
-    "session_start": ".claude/hooks/session-start.sh - 자동 복구"
+    "note": "Actual hooks settings are in settings.local.json",
+    "stop": ".claude/hooks/stop.sh - auto /compact",
+    "session_start": ".claude/hooks/session-start.sh - auto recovery"
   },
 
   "commands": {
     "init-project": {
-      "description": "새 프로젝트 초기화",
+      "description": "Initialize new project",
       "file": "commands/init-project.md"
     },
     "run-stage": {
-      "description": "스테이지 실행",
+      "description": "Run stage",
       "file": "commands/run-stage.md"
     },
     "handoff": {
-      "description": "핸드오프 문서 생성",
+      "description": "Generate handoff document",
       "file": "commands/handoff.md"
     },
     "checkpoint": {
-      "description": "체크포인트 생성",
+      "description": "Create checkpoint",
       "file": "commands/checkpoint.md"
     },
     "gemini": {
-      "description": "Gemini CLI 호출 (tmux)",
+      "description": "Call Gemini CLI (tmux)",
       "file": "commands/gemini.md"
     },
     "codex": {
-      "description": "Codex CLI 호출 (tmux)",
+      "description": "Call Codex CLI (tmux)",
       "file": "commands/codex.md"
     },
     "status": {
-      "description": "파이프라인 상태 확인",
+      "description": "Check pipeline status",
       "file": "commands/status.md"
     },
     "stages": {
-      "description": "스테이지 목록 및 상세",
+      "description": "Stage list and details",
       "file": "commands/stages.md"
     },
     "restore": {
-      "description": "체크포인트 복구",
+      "description": "Restore checkpoint",
       "file": "commands/restore.md"
     },
     "next": {
-      "description": "다음 스테이지 전환",
+      "description": "Transition to next stage",
       "file": "commands/next.md"
     },
     "context": {
-      "description": "컨텍스트 상태 관리",
+      "description": "Context state management",
       "file": "commands/context.md"
     },
     "brainstorm": {
-      "description": "01-brainstorm 스테이지 시작",
+      "description": "Start 01-brainstorm stage",
       "file": "commands/brainstorm.md"
     },
     "research": {
-      "description": "02-research 스테이지 시작",
+      "description": "Start 02-research stage",
       "file": "commands/research.md"
     },
     "planning": {
-      "description": "03-planning 스테이지 시작",
+      "description": "Start 03-planning stage",
       "file": "commands/planning.md"
     },
     "ui-ux": {
-      "description": "04-ui-ux 스테이지 시작",
+      "description": "Start 04-ui-ux stage",
       "file": "commands/ui-ux.md"
     },
     "tasks": {
-      "description": "05-task-management 스테이지 시작",
+      "description": "Start 05-task-management stage",
       "file": "commands/tasks.md"
     },
     "implement": {
-      "description": "06-implementation 스테이지 시작",
+      "description": "Start 06-implementation stage",
       "file": "commands/implement.md"
     },
     "refactor": {
-      "description": "07-refactoring 스테이지 시작",
+      "description": "Start 07-refactoring stage",
       "file": "commands/refactor.md"
     },
     "qa": {
-      "description": "08-qa 스테이지 시작",
+      "description": "Start 08-qa stage",
       "file": "commands/qa.md"
     },
     "test": {
-      "description": "09-testing 스테이지 시작",
+      "description": "Start 09-testing stage",
       "file": "commands/test.md"
     },
     "deploy": {
-      "description": "10-deployment 스테이지 시작",
+      "description": "Start 10-deployment stage",
       "file": "commands/deploy.md"
     },
     "collaborate": {
-      "description": "Multi-AI 협업 실행",
+      "description": "Run Multi-AI collaboration",
       "file": "commands/collaborate.md"
     },
     "benchmark": {
-      "description": "AI 모델 벤치마킹",
+      "description": "AI model benchmarking",
       "file": "commands/benchmark.md"
     },
     "fork": {
-      "description": "파이프라인 분기 관리",
+      "description": "Pipeline branch management",
       "file": "commands/fork.md"
     },
     "validate": {
-      "description": "산출물 검증 실행",
+      "description": "Run output validation",
       "file": "commands/validate.md"
     }
   },
 
   "skills": {
     "smart-handoff": {
-      "description": "스마트 컨텍스트 추출 및 HANDOFF 생성",
+      "description": "Smart context extraction and HANDOFF generation",
       "directory": "skills/smart-handoff"
     },
     "ai-collaboration": {
-      "description": "Multi-AI 협업 오케스트레이션",
+      "description": "Multi-AI collaboration orchestration",
       "directory": "skills/ai-collaboration"
     },
     "auto-checkpoint": {
-      "description": "자동 체크포인트 생성",
+      "description": "Automatic checkpoint generation",
       "directory": "skills/auto-checkpoint"
     },
     "output-validator": {
-      "description": "산출물 검증 및 품질 확인",
+      "description": "Output validation and quality verification",
       "directory": "skills/output-validator"
     }
   }

package/template/.claude/skills/ai-collaboration/README.md

@@ -1,61 +1,61 @@
 # AI Collaboration Skill
 
-Multi-AI 협업 및 오케스트레이션 스킬
+Multi-AI Collaboration and Orchestration Skill
 
-## 개요
+## Overview
 
-여러 AI 모델(Claude, Gemini, Codex)을 협업시켜 더 나은 결과물을 생성합니다:
-- 병렬 실행으로 다양한 관점 확보
-- 순차 핸드오프로 점진적 개선
-- 토론 모드로 최적 결론 도출
+Collaborate multiple AI models (Claude, Gemini, Codex) to generate better results:
+- Gain diverse perspectives through parallel execution
+- Gradual improvement through sequential handoff
+- Derive optimal conclusions through debate mode
 
-## 트리거
+## Trigger
 
-- `/collaborate` 명령어
-- 복잡한 태스크 감지 시 자동 제안
-- 낮은 확신도 감지 시
+- `/collaborate` command
+- Auto-suggested when complex task detected
+- When low confidence detected
 
-## 협업 모드
+## Collaboration Modes
 
-### 1. Parallel Execution (병렬 실행)
-동일 작업을 여러 AI가 동시 수행 → 최적 결과 선택
+### 1. Parallel Execution
+Multiple AIs perform the same task simultaneously → Select optimal result
 
 ```bash
-/collaborate --mode parallel --task "아이디어 생성" --models "gemini,claude"
+/collaborate --mode parallel --task "idea generation" --models "gemini,claude"
 ```
 
-### 2. Sequential Handoff (순차 핸드오프)
-AI 간 릴레이로 결과물 점진적 개선
+### 2. Sequential Handoff
+AI relay to gradually improve results
 
 ```bash
 /collaborate --mode sequential --chain "code_review"
 ```
 
-### 3. Debate Mode (토론 모드)
-AI 간 토론으로 다양한 관점에서 최적 결론 도출
+### 3. Debate Mode
+AI debate to derive optimal conclusions from various perspectives
 
 ```bash
-/collaborate --mode debate --topic "아키텍처 선택" --rounds 3
+/collaborate --mode debate --topic "architecture selection" --rounds 3
 ```
 
-## 파일 구조
+## File Structure
 
 ```
 ai-collaboration/
-├── README.md          # 이 파일
-├── parallel.md        # 병렬 실행 가이드
-├── debate.md          # 토론 모드 가이드
+├── README.md          # This file
+├── parallel.md        # Parallel execution guide
+├── debate.md          # Debate mode guide
 └── prompts/
-    └── CLAUDE.md      # AI 지침
+    └── CLAUDE.md      # AI instructions
 ```
 
-## 설정
+## Configuration
 
-`config/ai_collaboration.yaml` 참조
+See `config/ai_collaboration.yaml`
 
-## 출력
+## Output
 
-- 각 AI 결과물
-- 비교 분석 리포트
-- 최종 선택/병합 결과
-- `state/collaborations/` 저장
+- Each AI's result
+- Comparative analysis report
+- Final selection/merge result
+- Saved to `state/collaborations/`