claude-symphony 0.0.1 → 0.0.2

package/template/scripts/run-stage.sh

@@ -1,5 +1,5 @@
 #!/bin/bash
-# run-stage.sh - 스테이지 실행
+# run-stage.sh - Stage execution
 # claude-symphony workflow pipeline
 
 set -e
@@ -8,55 +8,55 @@ STAGE_ID="$1"
 PROJECT_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
 TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
 
-# 색상 정의
+# Color definitions
 RED='\033[0;31m'
 GREEN='\033[0;32m'
 YELLOW='\033[1;33m'
 BLUE='\033[0;34m'
 NC='\033[0m' # No Color
 
-# 사용법
+# Usage
 if [ -z "$STAGE_ID" ]; then
-    echo "사용법: $0 <stage-id>"
+    echo "Usage: $0 <stage-id>"
     echo ""
-    echo "사용 가능한 스테이지:"
-    echo "  01-brainstorm    브레인스토밍"
-    echo "  02-research      리서치"
-    echo "  03-planning      기획"
-    echo "  04-ui-ux         UI/UX 설계"
-    echo "  05-task-management 태스크 관리"
-    echo "  06-implementation 구현"
-    echo "  07-refactoring   리팩토링"
+    echo "Available stages:"
+    echo "  01-brainstorm    Brainstorming"
+    echo "  02-research      Research"
+    echo "  03-planning      Planning"
+    echo "  04-ui-ux         UI/UX Design"
+    echo "  05-task-management Task Management"
+    echo "  06-implementation Implementation"
+    echo "  07-refactoring   Refactoring"
     echo "  08-qa            QA"
-    echo "  09-testing       테스팅"
-    echo "  10-deployment    배포"
+    echo "  09-testing       Testing"
+    echo "  10-deployment    Deployment"
     exit 1
 fi
 
-# 스테이지 디렉토리 확인
+# Check stage directory
 STAGE_DIR="$PROJECT_ROOT/stages/$STAGE_ID"
 
 if [ ! -d "$STAGE_DIR" ]; then
-    echo -e "${RED}오류:${NC} 스테이지를 찾을 수 없습니다: $STAGE_ID"
+    echo -e "${RED}Error:${NC} Stage not found: $STAGE_ID"
     exit 1
 fi
 
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "🚀 스테이지 실행: $STAGE_ID"
+echo "🚀 Stage Execution: $STAGE_ID"
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 
-# 1. Pre-stage 훅 실행
+# 1. Execute pre-stage hook
 echo ""
-echo -e "${BLUE}[1/3] Pre-Stage 훅 실행${NC}"
+echo -e "${BLUE}[1/3] Executing Pre-Stage Hook${NC}"
 if [ -f "$PROJECT_ROOT/.claude/hooks/pre-stage.sh" ]; then
     bash "$PROJECT_ROOT/.claude/hooks/pre-stage.sh" "$STAGE_ID"
 else
-    echo -e "${YELLOW}⚠${NC} Pre-stage 훅이 없습니다."
+    echo -e "${YELLOW}⚠${NC} No pre-stage hook found."
 fi
 
-# 2. 상태 업데이트
+# 2. Update status
 echo ""
-echo -e "${BLUE}[2/3] 상태 업데이트${NC}"
+echo -e "${BLUE}[2/3] Updating Status${NC}"
 PROGRESS_FILE="$PROJECT_ROOT/state/progress.json"
 
 if command -v jq &> /dev/null; then
@@ -65,14 +65,14 @@ if command -v jq &> /dev/null; then
         .stages.\"$STAGE_ID\".started_at = \"$TIMESTAMP\" | \
         .pipeline.updated_at = \"$TIMESTAMP\"" \
         "$PROGRESS_FILE" > "${PROGRESS_FILE}.tmp" && mv "${PROGRESS_FILE}.tmp" "$PROGRESS_FILE"
-    echo -e "${GREEN}✓${NC} progress.json 업데이트됨"
+    echo -e "${GREEN}✓${NC} progress.json updated"
 else
-    echo -e "${YELLOW}⚠${NC} jq 미설치 - 수동 업데이트 필요"
+    echo -e "${YELLOW}⚠${NC} jq not installed - Manual update required"
 fi
 
-# 3. 모델 강제 실행 확인 (Issue #12, #14 해결)
+# 3. Model enforcement check (Issue #12, #14 resolution)
 echo ""
-echo -e "${BLUE}[3/5] AI 모델 강제 실행 확인${NC}"
+echo -e "${BLUE}[3/5] AI Model Enforcement Check${NC}"
 STAGE_CONFIG="$STAGE_DIR/config.yaml"
 MODEL_ENFORCEMENT="$PROJECT_ROOT/config/model_enforcement.yaml"
 
@@ -85,10 +85,10 @@ if command -v yq &> /dev/null && [ -f "$STAGE_CONFIG" ]; then
     if [ "$AUTO_INVOKE_ENABLED" = "true" ]; then
         echo ""
         echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-        echo -e "${YELLOW}🤖 AI 모델 자동 호출 설정${NC}"
+        echo -e "${YELLOW}🤖 AI Model Auto-Invoke Settings${NC}"
         echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-        echo "  모델: $AUTO_INVOKE_MODEL"
-        echo "  필수: $AUTO_INVOKE_REQUIRED"
+        echo "  Model: $AUTO_INVOKE_MODEL"
+        echo "  Required: $AUTO_INVOKE_REQUIRED"
         if [ -n "$AUTO_INVOKE_MSG" ] && [ "$AUTO_INVOKE_MSG" != "null" ]; then
             echo ""
             echo -e "  ${GREEN}$AUTO_INVOKE_MSG${NC}"
@@ -96,44 +96,44 @@ if command -v yq &> /dev/null && [ -f "$STAGE_CONFIG" ]; then
 
         if [ "$AUTO_INVOKE_REQUIRED" = "true" ]; then
             echo ""
-            echo -e "  ${YELLOW}⚠️  이 스테이지는 ${AUTO_INVOKE_MODEL} 사용이 필수입니다.${NC}"
-            echo -e "  ${BLUE}→ /${AUTO_INVOKE_MODEL} 명령어로 호출하세요.${NC}"
+            echo -e "  ${YELLOW}⚠️  This stage requires using ${AUTO_INVOKE_MODEL}.${NC}"
+            echo -e "  ${BLUE}→ Use /${AUTO_INVOKE_MODEL} command to invoke.${NC}"
         fi
         echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
     fi
 else
-    echo -e "${YELLOW}⚠${NC} yq 미설치 또는 config.yaml 없음 - 모델 강제 확인 건너뜀"
+    echo -e "${YELLOW}⚠${NC} yq not installed or config.yaml not found - Skipping model enforcement check"
 fi
 
-# 4. CLAUDE.md 표시
+# 4. Display CLAUDE.md
 echo ""
-echo -e "${BLUE}[4/5] 스테이지 지침 로드${NC}"
+echo -e "${BLUE}[4/5] Loading Stage Instructions${NC}"
 CLAUDE_MD="$STAGE_DIR/CLAUDE.md"
 
 if [ -f "$CLAUDE_MD" ]; then
     echo ""
     echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-    echo -e "${GREEN}스테이지 CLAUDE.md:${NC}"
+    echo -e "${GREEN}Stage CLAUDE.md:${NC}"
     echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
     cat "$CLAUDE_MD"
     echo ""
 else
-    echo -e "${YELLOW}⚠${NC} CLAUDE.md가 없습니다."
+    echo -e "${YELLOW}⚠${NC} CLAUDE.md not found."
 fi
 
-# 5. 다음 단계 안내
+# 5. Next steps guidance
 echo ""
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo -e "${GREEN}✓${NC} 스테이지 $STAGE_ID 시작됨"
+echo -e "${GREEN}✓${NC} Stage $STAGE_ID started"
 echo ""
-echo -e "${BLUE}작업 완료 후:${NC}"
-echo "  /handoff - 핸드오프 문서 생성"
-echo "  /checkpoint [설명] - 체크포인트 생성 (06, 07 스테이지)"
+echo -e "${BLUE}After completing work:${NC}"
+echo "  /handoff - Generate handoff document"
+echo "  /checkpoint [description] - Create checkpoint (stages 06, 07)"
 
-# AI 모델 호출 안내 추가
+# Add AI model invoke guidance
 if [ -n "$AUTO_INVOKE_MODEL" ] && [ "$AUTO_INVOKE_MODEL" != "null" ]; then
     echo ""
-    echo -e "${YELLOW}AI 모델 사용:${NC}"
-    echo "  /${AUTO_INVOKE_MODEL} \"프롬프트\" - ${AUTO_INVOKE_MODEL} 호출"
+    echo -e "${YELLOW}AI Model Usage:${NC}"
+    echo "  /${AUTO_INVOKE_MODEL} \"prompt\" - Invoke ${AUTO_INVOKE_MODEL}"
 fi
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"

package/template/scripts/show-status.sh

@@ -1,5 +1,5 @@
 #!/bin/bash
-# show-status.sh - 파이프라인 상태 표시
+# show-status.sh - Pipeline status display
 # claude-symphony workflow pipeline
 
 set -e
@@ -8,7 +8,7 @@ PROJECT_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
 PROGRESS_FILE="$PROJECT_ROOT/state/progress.json"
 CONFIG_FILE="$PROJECT_ROOT/config/pipeline.yaml"
 
-# 색상 정의
+# Color definitions
 RED='\033[0;31m'
 GREEN='\033[0;32m'
 YELLOW='\033[1;33m'
@@ -18,7 +18,7 @@ WHITE='\033[1;37m'
 GRAY='\033[0;90m'
 NC='\033[0m' # No Color
 
-# 옵션 처리
+# Option handling
 OUTPUT_JSON=false
 OUTPUT_BRIEF=false
 
@@ -31,30 +31,30 @@ while [[ "$#" -gt 0 ]]; do
     shift
 done
 
-# jq 확인
+# Check jq
 if ! command -v jq &> /dev/null; then
-    echo -e "${RED}오류:${NC} jq가 필요합니다."
+    echo -e "${RED}Error:${NC} jq is required."
     exit 1
 fi
 
-# progress.json 확인
+# Check progress.json
 if [ ! -f "$PROGRESS_FILE" ]; then
-    echo -e "${RED}오류:${NC} progress.json을 찾을 수 없습니다."
-    echo "  먼저 /init-project를 실행하세요."
+    echo -e "${RED}Error:${NC} Cannot find progress.json."
+    echo "  Please run /init-project first."
     exit 1
 fi
 
-# 데이터 추출
+# Extract data
 PROJECT_NAME=$(jq -r '.project_name // "unnamed"' "$PROGRESS_FILE")
 CURRENT_STAGE=$(jq -r '.current_stage // "none"' "$PROGRESS_FILE")
 CHECKPOINT_COUNT=$(jq -r '.checkpoints | length' "$PROGRESS_FILE")
 
-# 스테이지 정보 배열
+# Stage info arrays
 declare -a STAGE_IDS=("01-brainstorm" "02-research" "03-planning" "04-ui-ux" "05-task-management" "06-implementation" "07-refactoring" "08-qa" "09-testing" "10-deployment")
 declare -a STAGE_NAMES=("brainstorm" "research" "planning" "ui-ux" "task-mgmt" "implementation" "refactoring" "qa" "testing" "deployment")
 declare -a STAGE_AI=("Gemini+Claude" "Claude+MCP" "Gemini" "Gemini" "ClaudeCode" "ClaudeCode" "Codex" "ClaudeCode" "Codex" "ClaudeCode")
 
-# 완료된 스테이지 수 계산
+# Calculate completed stages
 COMPLETED=0
 CURRENT_NUM=0
 for i in "${!STAGE_IDS[@]}"; do
@@ -70,7 +70,7 @@ done
 TOTAL=10
 PERCENT=$((COMPLETED * 100 / TOTAL))
 
-# JSON 출력
+# JSON output
 if [ "$OUTPUT_JSON" = true ]; then
     jq -n \
         --arg project "$PROJECT_NAME" \
@@ -82,13 +82,13 @@ if [ "$OUTPUT_JSON" = true ]; then
     exit 0
 fi
 
-# 간략 출력
+# Brief output
 if [ "$OUTPUT_BRIEF" = true ]; then
-    echo "[$PROJECT_NAME] $COMPLETED/$TOTAL 완료 | 현재: $CURRENT_STAGE | 체크포인트: $CHECKPOINT_COUNT"
+    echo "[$PROJECT_NAME] $COMPLETED/$TOTAL completed | Current: $CURRENT_STAGE | Checkpoints: $CHECKPOINT_COUNT"
     exit 0
 fi
 
-# 진행률 바 생성
+# Generate progress bar
 progress_bar() {
     local percent=$1
     local width=20
@@ -100,7 +100,7 @@ progress_bar() {
     printf "]"
 }
 
-# 상태 아이콘 반환
+# Return status icon
 status_icon() {
     case $1 in
         completed) echo "✅" ;;
@@ -112,26 +112,26 @@ status_icon() {
     esac
 }
 
-# 상태 텍스트 (한글)
+# Status text
 status_text() {
     case $1 in
-        completed) echo "완료" ;;
-        in_progress) echo "진행중" ;;
-        pending) echo "대기" ;;
-        failed) echo "실패" ;;
-        paused) echo "중지" ;;
-        *) echo "대기" ;;
+        completed) echo "done" ;;
+        in_progress) echo "active" ;;
+        pending) echo "pending" ;;
+        failed) echo "failed" ;;
+        paused) echo "paused" ;;
+        *) echo "pending" ;;
     esac
 }
 
-# 출력
+# Output
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 echo -e "📊 ${WHITE}Pipeline Status:${NC} ${CYAN}$PROJECT_NAME${NC}"
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 echo -e "Progress: $(progress_bar $PERCENT) ${GREEN}$PERCENT%${NC} ($COMPLETED/$TOTAL)"
 echo ""
 
-# 스테이지 목록
+# Stage list
 for i in "${!STAGE_IDS[@]}"; do
     STAGE_ID="${STAGE_IDS[$i]}"
     STAGE_NAME="${STAGE_NAMES[$i]}"
@@ -143,14 +143,14 @@ for i in "${!STAGE_IDS[@]}"; do
 
     NUM=$(printf "%02d" $((i + 1)))
 
-    # 현재 스테이지 표시
+    # Mark current stage
     if [ "$STAGE_ID" == "$CURRENT_STAGE" ]; then
         ARROW=" ${YELLOW}←${NC}"
     else
         ARROW=""
     fi
 
-    # 색상 설정
+    # Color setting
     if [ "$STATUS" == "completed" ]; then
         NAME_COLOR=$GREEN
     elif [ "$STATUS" == "in_progress" ]; then
@@ -166,7 +166,7 @@ done
 echo ""
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 
-# 마지막 핸드오프 찾기
+# Find last handoff
 LAST_HANDOFF=""
 for ((i=${#STAGE_IDS[@]}-1; i>=0; i--)); do
     STAGE_ID="${STAGE_IDS[$i]}"
@@ -177,9 +177,9 @@ for ((i=${#STAGE_IDS[@]}-1; i>=0; i--)); do
 done
 
 if [ -n "$LAST_HANDOFF" ]; then
-    echo -e "체크포인트: ${CYAN}${CHECKPOINT_COUNT}개${NC} | 마지막 핸드오프: ${GREEN}${LAST_HANDOFF}${NC}"
+    echo -e "Checkpoints: ${CYAN}${CHECKPOINT_COUNT}${NC} | Last handoff: ${GREEN}${LAST_HANDOFF}${NC}"
 else
-    echo -e "체크포인트: ${CYAN}${CHECKPOINT_COUNT}개${NC} | 핸드오프: 없음"
+    echo -e "Checkpoints: ${CYAN}${CHECKPOINT_COUNT}${NC} | Handoff: None"
 fi
 
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"

package/template/scripts/smart-handoff.sh

@@ -1,6 +1,6 @@
 #!/bin/bash
 # claude-symphony Smart HANDOFF Script
-# 스마트 컨텍스트 추출 및 HANDOFF 생성
+# Smart context extraction and HANDOFF generation
 
 set -e
 
@@ -9,18 +9,18 @@ PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
 PROGRESS_FILE="$PROJECT_ROOT/state/progress.json"
 CONTEXT_DIR="$PROJECT_ROOT/state/context"
 
-# 색상 정의
+# Color definitions
 GREEN='\033[0;32m'
 BLUE='\033[0;34m'
 YELLOW='\033[1;33m'
 NC='\033[0m'
 
-# 로그 함수
+# Log functions
 log_info() { echo -e "${BLUE}[HANDOFF]${NC} $1"; }
 log_success() { echo -e "${GREEN}[HANDOFF]${NC} $1"; }
 log_warning() { echo -e "${YELLOW}[HANDOFF]${NC} $1"; }
 
-# 현재 스테이지 확인
+# Get current stage
 get_current_stage() {
     if [ -f "$PROGRESS_FILE" ]; then
         cat "$PROGRESS_FILE" 2>/dev/null | grep -o '"current_stage"[[:space:]]*:[[:space:]]*"[^"]*"' | cut -d'"' -f4
@@ -29,15 +29,15 @@ get_current_stage() {
     fi
 }
 
-# Git 변경 파일 추출
+# Extract changed files from Git
 extract_changed_files() {
-    log_info "변경된 파일 추출 중..."
+    log_info "Extracting changed files..."
 
     if git rev-parse --is-inside-work-tree > /dev/null 2>&1; then
-        echo "### 수정된 파일"
+        echo "### Modified Files"
         echo ""
-        echo "| 파일 | 변경 유형 | 변경량 |"
-        echo "|------|----------|--------|"
+        echo "| File | Change Type | Changes |"
+        echo "|------|-------------|---------|"
 
         git diff --stat HEAD~10 2>/dev/null | head -20 | while read -r line; do
             if [[ "$line" =~ ^[[:space:]]*([^|]+)\|[[:space:]]*([0-9]+) ]]; then
@@ -49,16 +49,16 @@ extract_changed_files() {
 
         echo ""
     else
-        echo "Git 저장소가 아닙니다."
+        echo "Not a Git repository."
     fi
 }
 
-# 최근 커밋 추출
+# Extract recent commits
 extract_recent_commits() {
-    log_info "최근 커밋 추출 중..."
+    log_info "Extracting recent commits..."
 
     if git rev-parse --is-inside-work-tree > /dev/null 2>&1; then
-        echo "### 최근 커밋"
+        echo "### Recent Commits"
         echo ""
 
         git log --oneline -5 2>/dev/null | while read -r line; do
@@ -69,83 +69,83 @@ extract_recent_commits() {
     fi
 }
 
-# HANDOFF 템플릿 생성
+# Generate HANDOFF template
 generate_handoff() {
     local stage="$1"
     local mode="$2"
     local stage_dir="$PROJECT_ROOT/stages/$stage"
     local handoff_file="$stage_dir/HANDOFF.md"
 
-    log_info "HANDOFF 생성 중: $stage"
+    log_info "Generating HANDOFF: $stage"
 
     mkdir -p "$stage_dir"
 
-    # 타임스탬프
+    # Timestamp
     local timestamp=$(date +%Y-%m-%d\ %H:%M:%S)
 
     cat > "$handoff_file" << EOF
 # HANDOFF - $stage
 
-> 생성 시간: $timestamp
-> 모드: $mode
+> Generated: $timestamp
+> Mode: $mode
 
-## 요약
+## Summary
 
-[스테이지 완료 상태를 1-2문장으로 요약]
+[Summarize stage completion status in 1-2 sentences]
 
-## 완료된 작업
+## Completed Tasks
 
-- [ ] 완료된 작업 1
-- [ ] 완료된 작업 2
-- [ ] 완료된 작업 3
+- [ ] Completed task 1
+- [ ] Completed task 2
+- [ ] Completed task 3
 
-## 핵심 결정사항
+## Key Decisions
 
-### 결정 1
-- **선택**: [선택한 옵션]
-- **이유**: [선택 이유]
-- **대안**: [고려한 대안]
+### Decision 1
+- **Choice**: [Selected option]
+- **Reason**: [Selection rationale]
+- **Alternatives**: [Considered alternatives]
 
 $(extract_changed_files)
 
 $(extract_recent_commits)
 
-## 대기 이슈
+## Pending Issues
 
-- [ ] 이슈 1 (우선순위: 높음)
-- [ ] 이슈 2 (우선순위: 중간)
+- [ ] Issue 1 (Priority: High)
+- [ ] Issue 2 (Priority: Medium)
 
-## 다음 단계
+## Next Steps
 
-1. [즉시 실행 가능한 첫 번째 액션]
-2. [두 번째 액션]
-3. [세 번째 액션]
+1. [First immediately actionable item]
+2. [Second action]
+3. [Third action]
 
-## 참조
+## References
 
-- 이전 HANDOFF: [링크]
-- 관련 문서: [링크]
+- Previous HANDOFF: [link]
+- Related documents: [link]
 
 ---
 
-## AI 호출 기록
+## AI Call Log
 
-| AI | 시간 | 목적 | 결과 |
-|----|------|------|------|
+| AI | Time | Purpose | Result |
+|----|------|---------|--------|
 | - | - | - | - |
 
 EOF
 
-    log_success "HANDOFF 생성 완료: $handoff_file"
+    log_success "HANDOFF generated: $handoff_file"
 }
 
-# 컴팩트 모드 HANDOFF
+# Compact mode HANDOFF
 generate_compact_handoff() {
     local stage="$1"
     local stage_dir="$PROJECT_ROOT/stages/$stage"
     local handoff_file="$stage_dir/HANDOFF.md"
 
-    log_info "컴팩트 HANDOFF 생성 중: $stage"
+    log_info "Generating compact HANDOFF: $stage"
 
     mkdir -p "$stage_dir"
 
@@ -156,29 +156,29 @@ generate_compact_handoff() {
 
 ## Critical
 
-[차단 이슈 및 즉시 해결 필요 사항]
+[Blocking issues and items requiring immediate resolution]
 
 ## Next Actions
 
-1. [첫 번째 즉시 실행 액션]
-2. [두 번째 액션]
+1. [First immediately actionable item]
+2. [Second action]
 
 ## Context
 
-[최소 필수 컨텍스트]
+[Minimum essential context]
 
 EOF
 
-    log_success "컴팩트 HANDOFF 생성 완료: $handoff_file"
+    log_success "Compact HANDOFF generated: $handoff_file"
 }
 
-# 복구용 상세 HANDOFF
+# Recovery detailed HANDOFF
 generate_recovery_handoff() {
     local stage="$1"
     local stage_dir="$PROJECT_ROOT/stages/$stage"
     local handoff_file="$stage_dir/HANDOFF_RECOVERY.md"
 
-    log_info "복구용 HANDOFF 생성 중: $stage"
+    log_info "Generating recovery HANDOFF: $stage"
 
     mkdir -p "$stage_dir"
 
@@ -189,14 +189,14 @@ generate_recovery_handoff() {
 
 ## Full Context
 
-### 현재 상태
-[상세 상태 설명]
+### Current State
+[Detailed state description]
 
-### 완료된 모든 작업
-[상세 작업 목록]
+### All Completed Tasks
+[Complete task list]
 
-### 모든 결정사항
-[결정사항 전체 목록]
+### All Decisions
+[Full decision list]
 
 $(extract_changed_files)
 
@@ -204,33 +204,33 @@ $(extract_recent_commits)
 
 ## Step-by-Step Recovery
 
-### 1단계: 환경 확인
+### Step 1: Verify Environment
 \`\`\`bash
-# 필요한 명령어
+# Required commands
 \`\`\`
 
-### 2단계: 상태 복원
-[복원 절차]
+### Step 2: Restore State
+[Restoration procedure]
 
-### 3단계: 작업 재개
-[재개 절차]
+### Step 3: Resume Work
+[Resume procedure]
 
-## 관련 체크포인트
+## Related Checkpoints
 
-- [체크포인트 목록]
+- [Checkpoint list]
 
 EOF
 
-    log_success "복구용 HANDOFF 생성 완료: $handoff_file"
+    log_success "Recovery HANDOFF generated: $handoff_file"
 }
 
-# 메인 실행
+# Main execution
 main() {
     local mode="${1:-default}"
     local stage="${2:-$(get_current_stage)}"
 
     if [ "$stage" = "unknown" ]; then
-        log_warning "현재 스테이지를 확인할 수 없습니다. 기본값 사용"
+        log_warning "Cannot determine current stage. Using default value"
         stage="00-unknown"
     fi
 
@@ -245,7 +245,7 @@ main() {
             generate_recovery_handoff "$stage"
             ;;
         *)
-            echo "사용법: $0 [default|compact|recovery] [stage_id]"
+            echo "Usage: $0 [default|compact|recovery] [stage_id]"
             exit 1
             ;;
     esac