create-ax-project 1.0.0

package/template/.claude/hooks/output-validator.sh

@@ -0,0 +1,289 @@
+#!/bin/bash
+# ax-templates Output Validator Hook
+# 스테이지 산출물 검증
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+CONFIG_FILE="$PROJECT_ROOT/config/output_validation.yaml"
+PROGRESS_FILE="$PROJECT_ROOT/state/progress.json"
+VALIDATIONS_DIR="$PROJECT_ROOT/state/validations"
+
+# 색상 정의
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+# 결과 아이콘
+PASS="✅"
+FAIL="❌"
+WARN="⚠️"
+INFO="ℹ️"
+
+# 로그 함수
+log_pass() { echo -e "${GREEN}${PASS}${NC} $1"; }
+log_fail() { echo -e "${RED}${FAIL}${NC} $1"; }
+log_warn() { echo -e "${YELLOW}${WARN}${NC} $1"; }
+log_info() { echo -e "${BLUE}${INFO}${NC} $1"; }
+
+# 검증 결과 저장
+TOTAL_CHECKS=0
+PASSED_CHECKS=0
+FAILED_CHECKS=0
+WARNINGS=0
+
+# 현재 스테이지 확인
+get_current_stage() {
+    if [ -f "$PROGRESS_FILE" ]; then
+        cat "$PROGRESS_FILE" 2>/dev/null | grep -o '"current_stage"[[:space:]]*:[[:space:]]*"[^"]*"' | cut -d'"' -f4
+    else
+        echo "unknown"
+    fi
+}
+
+# 파일 존재 확인
+check_file_exists() {
+    local file_path="$1"
+    local required="$2"
+    local full_path="$PROJECT_ROOT/$file_path"
+
+    TOTAL_CHECKS=$((TOTAL_CHECKS + 1))
+
+    if [ -e "$full_path" ]; then
+        log_pass "$file_path 존재"
+        PASSED_CHECKS=$((PASSED_CHECKS + 1))
+        return 0
+    else
+        if [ "$required" = "true" ]; then
+            log_fail "$file_path 누락"
+            FAILED_CHECKS=$((FAILED_CHECKS + 1))
+            return 1
+        else
+            log_warn "$file_path 누락 (선택사항)"
+            WARNINGS=$((WARNINGS + 1))
+            return 0
+        fi
+    fi
+}
+
+# 디렉토리 확인
+check_directory_exists() {
+    local dir_path="$1"
+    local full_path="$PROJECT_ROOT/$dir_path"
+
+    TOTAL_CHECKS=$((TOTAL_CHECKS + 1))
+
+    if [ -d "$full_path" ]; then
+        log_pass "$dir_path 디렉토리 존재"
+        PASSED_CHECKS=$((PASSED_CHECKS + 1))
+        return 0
+    else
+        log_fail "$dir_path 디렉토리 누락"
+        FAILED_CHECKS=$((FAILED_CHECKS + 1))
+        return 1
+    fi
+}
+
+# 파일 최소 크기 확인
+check_file_size() {
+    local file_path="$1"
+    local min_size="$2"
+    local full_path="$PROJECT_ROOT/$file_path"
+
+    if [ -f "$full_path" ]; then
+        local size=$(wc -c < "$full_path")
+        TOTAL_CHECKS=$((TOTAL_CHECKS + 1))
+
+        if [ "$size" -ge "$min_size" ]; then
+            log_pass "$file_path 크기 충족 (${size} bytes >= ${min_size})"
+            PASSED_CHECKS=$((PASSED_CHECKS + 1))
+            return 0
+        else
+            log_fail "$file_path 크기 미달 (${size} bytes < ${min_size})"
+            FAILED_CHECKS=$((FAILED_CHECKS + 1))
+            return 1
+        fi
+    fi
+}
+
+# 마크다운 섹션 확인
+check_markdown_sections() {
+    local file_path="$1"
+    shift
+    local sections=("$@")
+    local full_path="$PROJECT_ROOT/$file_path"
+
+    if [ -f "$full_path" ]; then
+        for section in "${sections[@]}"; do
+            TOTAL_CHECKS=$((TOTAL_CHECKS + 1))
+
+            if grep -q "^#.*$section" "$full_path" || grep -q "^##.*$section" "$full_path"; then
+                log_pass "$file_path: '$section' 섹션 존재"
+                PASSED_CHECKS=$((PASSED_CHECKS + 1))
+            else
+                log_fail "$file_path: '$section' 섹션 누락"
+                FAILED_CHECKS=$((FAILED_CHECKS + 1))
+            fi
+        done
+    fi
+}
+
+# 명령어 실행 검증
+run_validation_command() {
+    local name="$1"
+    local command="$2"
+    local required="$3"
+
+    TOTAL_CHECKS=$((TOTAL_CHECKS + 1))
+    log_info "실행 중: $name ($command)"
+
+    if eval "$command" > /dev/null 2>&1; then
+        log_pass "$name 통과"
+        PASSED_CHECKS=$((PASSED_CHECKS + 1))
+        return 0
+    else
+        if [ "$required" = "true" ]; then
+            log_fail "$name 실패"
+            FAILED_CHECKS=$((FAILED_CHECKS + 1))
+            return 1
+        else
+            log_warn "$name 실패 (선택사항)"
+            WARNINGS=$((WARNINGS + 1))
+            return 0
+        fi
+    fi
+}
+
+# 스테이지별 검증
+validate_stage() {
+    local stage="$1"
+    local stage_dir="$PROJECT_ROOT/stages/$stage"
+    local outputs_dir="$stage_dir/outputs"
+
+    echo ""
+    echo "=========================================="
+    echo "  산출물 검증: $stage"
+    echo "=========================================="
+    echo ""
+
+    # HANDOFF.md 확인 (모든 스테이지 공통)
+    check_file_exists "stages/$stage/HANDOFF.md" "true"
+
+    case "$stage" in
+        "01-brainstorm")
+            check_file_exists "stages/$stage/outputs/ideas.md" "true"
+            check_file_size "stages/$stage/outputs/ideas.md" 500
+            check_file_exists "stages/$stage/outputs/requirements_analysis.md" "true"
+            check_markdown_sections "stages/$stage/outputs/requirements_analysis.md" "기능" "비기능"
+            ;;
+
+        "02-research")
+            check_file_exists "stages/$stage/outputs/tech_research.md" "true"
+            check_file_size "stages/$stage/outputs/tech_research.md" 2000
+            check_file_exists "stages/$stage/outputs/feasibility_report.md" "true"
+            ;;
+
+        "03-planning")
+            check_file_exists "stages/$stage/outputs/architecture.md" "true"
+            check_file_exists "stages/$stage/outputs/tech_stack.md" "true"
+            check_file_exists "stages/$stage/outputs/project_plan.md" "true"
+            ;;
+
+        "06-implementation")
+            check_directory_exists "stages/$stage/outputs/source_code"
+            check_file_exists "stages/$stage/outputs/implementation_log.md" "true"
+
+            # 빌드 검증
+            if [ -f "$PROJECT_ROOT/package.json" ]; then
+                run_validation_command "lint" "npm run lint --prefix $PROJECT_ROOT" "true"
+                run_validation_command "typecheck" "npm run typecheck --prefix $PROJECT_ROOT" "true"
+            fi
+            ;;
+
+        "09-testing")
+            check_directory_exists "stages/$stage/outputs/tests"
+            check_file_exists "stages/$stage/outputs/test_report.md" "true"
+            check_file_exists "stages/$stage/outputs/coverage_report.md" "true"
+
+            # 테스트 검증
+            if [ -f "$PROJECT_ROOT/package.json" ]; then
+                run_validation_command "test" "npm run test --prefix $PROJECT_ROOT" "true"
+            fi
+            ;;
+
+        *)
+            log_info "스테이지 $stage에 대한 특정 검증 규칙 없음"
+            ;;
+    esac
+}
+
+# 결과 요약 출력
+print_summary() {
+    echo ""
+    echo "=========================================="
+    echo "  검증 결과 요약"
+    echo "=========================================="
+    echo ""
+    echo "총 검사: $TOTAL_CHECKS"
+    echo -e "${GREEN}통과: $PASSED_CHECKS${NC}"
+    echo -e "${RED}실패: $FAILED_CHECKS${NC}"
+    echo -e "${YELLOW}경고: $WARNINGS${NC}"
+    echo ""
+
+    # 점수 계산
+    if [ "$TOTAL_CHECKS" -gt 0 ]; then
+        local score=$(echo "scale=2; $PASSED_CHECKS / $TOTAL_CHECKS" | bc)
+        echo "점수: $score"
+
+        if [ "$FAILED_CHECKS" -eq 0 ]; then
+            echo -e "${GREEN}${PASS} 검증 통과${NC}"
+            return 0
+        else
+            echo -e "${RED}${FAIL} 검증 실패 - 스테이지 전환 차단됨${NC}"
+            return 1
+        fi
+    fi
+}
+
+# 결과 저장
+save_results() {
+    local stage="$1"
+    local timestamp=$(date +%Y%m%d_%H%M%S)
+
+    mkdir -p "$VALIDATIONS_DIR"
+
+    cat > "$VALIDATIONS_DIR/${stage}_${timestamp}.json" << EOF
+{
+    "stage": "$stage",
+    "timestamp": "$(date -u +%Y-%m-%dT%H:%M:%SZ)",
+    "total_checks": $TOTAL_CHECKS,
+    "passed": $PASSED_CHECKS,
+    "failed": $FAILED_CHECKS,
+    "warnings": $WARNINGS,
+    "score": $(echo "scale=2; $PASSED_CHECKS / $TOTAL_CHECKS" | bc 2>/dev/null || echo "0")
+}
+EOF
+}
+
+# 메인 실행
+main() {
+    local stage="${1:-$(get_current_stage)}"
+    local verbose="${2:-false}"
+
+    if [ "$stage" = "unknown" ]; then
+        log_fail "현재 스테이지를 확인할 수 없습니다."
+        exit 1
+    fi
+
+    validate_stage "$stage"
+    save_results "$stage"
+    print_summary
+}
+
+# 직접 실행 시에만 main 호출
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+    main "$@"
+fi

package/template/.claude/hooks/post-stage.sh

@@ -0,0 +1,123 @@
+#!/bin/bash
+# post-stage.sh - 스테이지 완료 후 훅
+# ax-templates workflow pipeline
+
+set -e
+
+STAGE_ID="$1"
+PROJECT_ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
+PROGRESS_FILE="$PROJECT_ROOT/state/progress.json"
+TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+# 색상 정의
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "📋 Post-Stage Hook: $STAGE_ID"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+# 1. 완료 조건 검증
+validate_completion() {
+    local stage_dir="$PROJECT_ROOT/stages/$STAGE_ID"
+    local config_file="$stage_dir/config.yaml"
+
+    echo "완료 조건 검증 중..."
+
+    # outputs 디렉토리 확인
+    if [ -d "$stage_dir/outputs" ]; then
+        local output_count=$(ls -1 "$stage_dir/outputs" 2>/dev/null | wc -l)
+        echo -e "  ${GREEN}✓${NC} 출력 파일: $output_count 개"
+    fi
+
+    return 0
+}
+
+# 2. HANDOFF.md 생성 알림
+check_handoff() {
+    local handoff_file="$PROJECT_ROOT/stages/$STAGE_ID/HANDOFF.md"
+
+    if [ ! -f "$handoff_file" ]; then
+        echo -e "  ${YELLOW}⚠${NC} HANDOFF.md 미생성"
+        echo "     /handoff 를 실행하여 핸드오프 문서를 생성해주세요."
+        return 1
+    fi
+
+    echo -e "  ${GREEN}✓${NC} HANDOFF.md 존재"
+
+    # 핸드오프 아카이브
+    local archive_name="${STAGE_ID}-$(date +%Y%m%d-%H%M).md"
+    cp "$handoff_file" "$PROJECT_ROOT/state/handoffs/$archive_name"
+    echo -e "  ${GREEN}✓${NC} 핸드오프 아카이브: state/handoffs/$archive_name"
+
+    return 0
+}
+
+# 3. progress.json 업데이트
+update_progress() {
+    echo "상태 업데이트 중..."
+
+    # jq로 상태 업데이트
+    if command -v jq &> /dev/null; then
+        local tmp_file=$(mktemp)
+        jq ".stages.\"$STAGE_ID\".status = \"completed\" | \
+            .stages.\"$STAGE_ID\".completed_at = \"$TIMESTAMP\" | \
+            .stages.\"$STAGE_ID\".handoff_generated = true | \
+            .pipeline.updated_at = \"$TIMESTAMP\"" \
+            "$PROGRESS_FILE" > "$tmp_file" && mv "$tmp_file" "$PROGRESS_FILE"
+
+        echo -e "  ${GREEN}✓${NC} progress.json 업데이트됨"
+    else
+        echo -e "  ${YELLOW}⚠${NC} jq 미설치 - 수동 업데이트 필요"
+    fi
+
+    return 0
+}
+
+# 4. 체크포인트 생성 알림 (필수 스테이지)
+remind_checkpoint() {
+    local stage_num=$(echo "$STAGE_ID" | cut -d'-' -f1)
+
+    if [ "$stage_num" == "06" ] || [ "$stage_num" == "07" ]; then
+        echo ""
+        echo -e "${BLUE}📌 체크포인트 알림${NC}"
+        echo "  이 스테이지는 체크포인트 생성이 권장됩니다."
+        echo "  /checkpoint \"스테이지 완료\" 를 실행해주세요."
+    fi
+}
+
+# 5. 다음 스테이지 안내
+show_next_stage() {
+    local config_file="$PROJECT_ROOT/stages/$STAGE_ID/config.yaml"
+    local next_stage=""
+
+    if [ -f "$config_file" ]; then
+        next_stage=$(grep "next_stage:" "$config_file" | cut -d'"' -f2 | head -1)
+    fi
+
+    echo ""
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+    if [ -z "$next_stage" ] || [ "$next_stage" == "null" ]; then
+        echo -e "${GREEN}🎉 파이프라인 완료!${NC}"
+        echo "  모든 스테이지가 완료되었습니다."
+    else
+        echo -e "${GREEN}✓${NC} 스테이지 $STAGE_ID 완료"
+        echo ""
+        echo -e "${BLUE}다음 스테이지: $next_stage${NC}"
+        echo "  실행: /run-stage $next_stage"
+    fi
+
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+}
+
+# 실행
+echo ""
+validate_completion
+check_handoff
+update_progress
+remind_checkpoint
+show_next_stage

package/template/.claude/hooks/pre-stage.sh

@@ -0,0 +1,186 @@
+#!/bin/bash
+# pre-stage.sh - 스테이지 실행 전 훅
+# ax-templates workflow pipeline
+
+set -e
+
+STAGE_ID="$1"
+PROJECT_ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
+PROGRESS_FILE="$PROJECT_ROOT/state/progress.json"
+
+# 색상 정의
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+NC='\033[0m' # No Color
+
+CONTEXT_TRIGGER_FILE="$PROJECT_ROOT/state/context/auto-trigger.json"
+
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "🔍 Pre-Stage Hook: $STAGE_ID"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+# 1. 이전 스테이지 완료 여부 확인
+check_prerequisites() {
+    local stage_num=$(echo "$STAGE_ID" | cut -d'-' -f1)
+
+    # 01 스테이지는 전제조건 없음
+    if [ "$stage_num" == "01" ]; then
+        echo -e "${GREEN}✓${NC} 첫 번째 스테이지 - 전제조건 없음"
+        return 0
+    fi
+
+    # 이전 스테이지 번호 계산
+    local prev_num=$(printf "%02d" $((10#$stage_num - 1)))
+    local prev_stage=$(ls "$PROJECT_ROOT/stages/" | grep "^${prev_num}-" | head -1)
+
+    if [ -z "$prev_stage" ]; then
+        echo -e "${RED}✗${NC} 이전 스테이지를 찾을 수 없습니다: $prev_num"
+        return 1
+    fi
+
+    # 이전 스테이지 상태 확인
+    local prev_status=$(jq -r ".stages.\"$prev_stage\".status" "$PROGRESS_FILE" 2>/dev/null || echo "pending")
+
+    if [ "$prev_status" != "completed" ]; then
+        echo -e "${RED}✗${NC} 이전 스테이지 미완료: $prev_stage (상태: $prev_status)"
+        echo "  먼저 이전 스테이지를 완료해주세요."
+        return 1
+    fi
+
+    echo -e "${GREEN}✓${NC} 이전 스테이지 완료: $prev_stage"
+    return 0
+}
+
+# 2. HANDOFF.md 존재 확인
+check_handoff() {
+    local stage_num=$(echo "$STAGE_ID" | cut -d'-' -f1)
+
+    # 01 스테이지는 핸드오프 불필요
+    if [ "$stage_num" == "01" ]; then
+        echo -e "${GREEN}✓${NC} 첫 번째 스테이지 - 핸드오프 불필요"
+        return 0
+    fi
+
+    local prev_num=$(printf "%02d" $((10#$stage_num - 1)))
+    local prev_stage=$(ls "$PROJECT_ROOT/stages/" | grep "^${prev_num}-" | head -1)
+    local handoff_file="$PROJECT_ROOT/stages/$prev_stage/HANDOFF.md"
+
+    if [ ! -f "$handoff_file" ]; then
+        echo -e "${RED}✗${NC} HANDOFF.md 없음: $handoff_file"
+        echo "  이전 스테이지에서 /handoff 를 실행해주세요."
+        return 1
+    fi
+
+    echo -e "${GREEN}✓${NC} HANDOFF.md 존재: $prev_stage/HANDOFF.md"
+    return 0
+}
+
+# 3. 필수 입력 파일 확인
+check_inputs() {
+    local config_file="$PROJECT_ROOT/stages/$STAGE_ID/config.yaml"
+
+    if [ ! -f "$config_file" ]; then
+        echo -e "${YELLOW}⚠${NC} config.yaml 없음 - 입력 파일 검증 스킵"
+        return 0
+    fi
+
+    # YAML에서 required inputs 추출 (간단한 파싱)
+    local inputs=$(grep -A100 "^inputs:" "$config_file" | grep -A50 "required:" | grep "name:" | head -5)
+
+    if [ -z "$inputs" ]; then
+        echo -e "${GREEN}✓${NC} 필수 입력 파일 없음"
+        return 0
+    fi
+
+    echo "필수 입력 파일 확인 중..."
+    # 실제 구현에서는 YAML 파서 사용 권장
+    echo -e "${GREEN}✓${NC} 입력 파일 검증 완료"
+    return 0
+}
+
+# 4. 체크포인트 확인 (필수 스테이지)
+check_checkpoint() {
+    local stage_num=$(echo "$STAGE_ID" | cut -d'-' -f1)
+
+    # 06, 07 스테이지는 이전 체크포인트 확인
+    if [ "$stage_num" == "07" ]; then
+        local cp_count=$(jq '.checkpoints | length' "$PROGRESS_FILE" 2>/dev/null || echo "0")
+
+        if [ "$cp_count" == "0" ]; then
+            echo -e "${YELLOW}⚠${NC} 경고: 체크포인트가 없습니다."
+            echo "  리팩토링 전 체크포인트 생성을 권장합니다."
+            echo "  /checkpoint 를 실행해주세요."
+        else
+            echo -e "${GREEN}✓${NC} 체크포인트 존재: $cp_count 개"
+        fi
+    fi
+
+    return 0
+}
+
+# 5. 컨텍스트 상태 확인 (50% 이하 경고)
+check_context_status() {
+    if [ ! -f "$CONTEXT_TRIGGER_FILE" ]; then
+        echo -e "${GREEN}✓${NC} 컨텍스트 상태 정상"
+        return 0
+    fi
+
+    local TRIGGERED=$(jq -r '.triggered // false' "$CONTEXT_TRIGGER_FILE" 2>/dev/null || echo "false")
+    local REMAINING=$(jq -r '.remaining // 100' "$CONTEXT_TRIGGER_FILE" 2>/dev/null || echo "100")
+    local LEVEL=$(jq -r '.level // "warning"' "$CONTEXT_TRIGGER_FILE" 2>/dev/null || echo "warning")
+
+    if [ "$TRIGGERED" = "true" ]; then
+        echo ""
+        echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+        if [ "$LEVEL" = "critical" ]; then
+            echo -e "${RED}⚠️ 컨텍스트 크리티컬 상태 (${REMAINING}% 남음)${NC}"
+            echo ""
+            echo "자동 스냅샷이 저장되었습니다."
+            echo "스테이지 시작 전 /compact 또는 /clear를 권장합니다."
+            echo ""
+            echo -e "${YELLOW}계속 진행하시겠습니까? (y/n)${NC}"
+        else
+            echo -e "${YELLOW}⚠️ 컨텍스트 부족 경고 (${REMAINING}% 남음)${NC}"
+            echo ""
+            echo "자동 스냅샷이 저장되었습니다."
+            echo "긴 작업 스테이지의 경우 /compact 실행을 권장합니다."
+            echo ""
+            echo -e "${CYAN}계속 진행하시겠습니까? (y/n)${NC}"
+        fi
+
+        read -r response </dev/tty 2>/dev/null || response="y"
+
+        if [ "$response" != "y" ] && [ "$response" != "Y" ]; then
+            echo ""
+            echo "스테이지 시작이 취소되었습니다."
+            echo "  → /compact 실행 후 다시 시도해주세요."
+            echo "  → 스냅샷 위치: state/context/"
+            echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+            return 1
+        fi
+
+        echo ""
+        echo -e "${GREEN}✓${NC} 사용자 확인 완료 - 스테이지 진행"
+        echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+        return 0
+    fi
+
+    echo -e "${GREEN}✓${NC} 컨텍스트 상태 정상"
+    return 0
+}
+
+# 실행
+echo ""
+check_context_status || exit 1
+check_prerequisites || exit 1
+check_handoff || exit 1
+check_inputs || exit 1
+check_checkpoint
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo -e "${GREEN}✓${NC} Pre-Stage Hook 완료 - 스테이지 실행 가능"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"

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

@@ -0,0 +1,90 @@
+#!/bin/bash
+# session-start.sh - 세션 시작 시 자동 복구
+# ax-templates workflow pipeline
+#
+# SessionStart hook: Claude Code 세션 시작/재개 시 실행
+# /compact 후 저장된 스냅샷이 있으면 자동으로 컨텍스트 복구 안내
+
+set -e
+
+PROJECT_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+TRIGGER_FILE="$PROJECT_ROOT/state/context/auto-trigger.json"
+CONTEXT_DIR="$PROJECT_ROOT/state/context"
+PROGRESS_FILE="$PROJECT_ROOT/state/progress.json"
+
+# 컨텍스트 디렉토리 확인
+mkdir -p "$CONTEXT_DIR"
+
+# jq 필요
+if ! command -v jq &> /dev/null; then
+    exit 0
+fi
+
+# 1. 트리거 파일 확인 - compact가 실행되었는지
+if [ ! -f "$TRIGGER_FILE" ]; then
+    exit 0  # 복구 필요 없음
+fi
+
+COMPACT_SCHEDULED=$(jq -r '.compact_scheduled // false' "$TRIGGER_FILE" 2>/dev/null || echo "false")
+if [ "$COMPACT_SCHEDULED" != "true" ]; then
+    exit 0  # compact가 예정되지 않았음
+fi
+
+# 2. 최근 스냅샷 찾기
+LATEST_SNAPSHOT=$(ls -1t "$CONTEXT_DIR"/auto-snapshot-*.md 2>/dev/null | head -1)
+if [ -z "$LATEST_SNAPSHOT" ]; then
+    # 스냅샷 없음 - 트리거 파일 정리
+    rm -f "$TRIGGER_FILE"
+    exit 0
+fi
+
+# 3. 현재 스테이지 정보
+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에게 전달)
+RECOVERY_CONTEXT=$(cat << EOF
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🔄 세션 복구 - 자동 /compact 후 재시작
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+## 복구 정보
+- 스냅샷: $(basename "$LATEST_SNAPSHOT")
+- 스테이지: $CURRENT_STAGE
+- 저장 시간: $(jq -r '.timestamp // "unknown"' "$TRIGGER_FILE" 2>/dev/null)
+
+## 스냅샷 내용
+$(cat "$LATEST_SNAPSHOT" 2>/dev/null | head -50)
+
+## 복구 지침
+1. 위 스냅샷 내용을 참고하여 작업 컨텍스트 파악
+2. stages/$CURRENT_STAGE/CLAUDE.md 확인
+3. 중단된 작업부터 재개
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+EOF
+)
+
+# 5. JSON 출력 (Claude에게 컨텍스트 전달)
+# additionalContext를 통해 Claude가 복구 정보를 받음
+cat << EOF
+{
+    "hookSpecificOutput": {
+        "hookEventName": "SessionStart",
+        "additionalContext": $(echo "$RECOVERY_CONTEXT" | jq -Rs .)
+    }
+}
+EOF
+
+# 6. 트리거 파일 정리 (복구 완료 표시)
+jq '. + {"recovered": true, "recovery_time": "'"$(date -Iseconds)"'"}' \
+    "$TRIGGER_FILE" > "$TRIGGER_FILE.tmp" && mv "$TRIGGER_FILE.tmp" "$TRIGGER_FILE"
+
+# 일정 시간 후 트리거 파일 삭제 (다음 세션에서 중복 복구 방지)
+# 백그라운드에서 5분 후 삭제
+(sleep 300 && rm -f "$TRIGGER_FILE" 2>/dev/null) &
+
+exit 0