create-ax-project 1.0.0

package/template/scripts/create-checkpoint.sh

@@ -0,0 +1,116 @@
+#!/bin/bash
+# create-checkpoint.sh - 체크포인트 생성
+# ax-templates workflow pipeline
+
+set -e
+
+DESCRIPTION="$1"
+PROJECT_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+PROGRESS_FILE="$PROJECT_ROOT/state/progress.json"
+TIMESTAMP=$(date +%Y%m%d-%H%M)
+TIMESTAMP_ISO=$(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
+
+# 현재 스테이지 확인
+if command -v jq &> /dev/null; then
+    CURRENT_STAGE=$(jq -r '.current_stage' "$PROGRESS_FILE")
+else
+    echo -e "${RED}오류:${NC} jq가 필요합니다."
+    exit 1
+fi
+
+if [ -z "$CURRENT_STAGE" ] || [ "$CURRENT_STAGE" == "null" ]; then
+    echo -e "${RED}오류:${NC} 현재 진행 중인 스테이지가 없습니다."
+    exit 1
+fi
+
+# 기본 설명
+if [ -z "$DESCRIPTION" ]; then
+    DESCRIPTION="체크포인트 - $CURRENT_STAGE"
+fi
+
+# 체크포인트 ID 생성
+STAGE_NUM=$(echo "$CURRENT_STAGE" | cut -d'-' -f1)
+CP_ID="CP-$STAGE_NUM-$TIMESTAMP"
+
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "💾 체크포인트 생성: $CP_ID"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "  스테이지: $CURRENT_STAGE"
+echo "  설명: $DESCRIPTION"
+echo ""
+
+# 체크포인트 디렉토리 생성
+CP_DIR="$PROJECT_ROOT/state/checkpoints/$CP_ID"
+mkdir -p "$CP_DIR"
+
+# 1. 상태 파일 복사
+echo -e "${BLUE}[1/4] 상태 파일 복사${NC}"
+cp "$PROGRESS_FILE" "$CP_DIR/progress.json"
+echo -e "${GREEN}✓${NC} progress.json 복사됨"
+
+# 2. 스테이지 outputs 복사
+echo -e "${BLUE}[2/4] 스테이지 출력 파일 복사${NC}"
+STAGE_DIR="$PROJECT_ROOT/stages/$CURRENT_STAGE"
+if [ -d "$STAGE_DIR/outputs" ]; then
+    cp -r "$STAGE_DIR/outputs" "$CP_DIR/outputs"
+    FILE_COUNT=$(find "$CP_DIR/outputs" -type f | wc -l)
+    echo -e "${GREEN}✓${NC} outputs 복사됨 ($FILE_COUNT 파일)"
+else
+    mkdir -p "$CP_DIR/outputs"
+    echo -e "${YELLOW}⚠${NC} outputs 디렉토리 없음 (빈 디렉토리 생성)"
+fi
+
+# 3. HANDOFF.md 복사 (있는 경우)
+echo -e "${BLUE}[3/4] HANDOFF.md 복사${NC}"
+if [ -f "$STAGE_DIR/HANDOFF.md" ]; then
+    cp "$STAGE_DIR/HANDOFF.md" "$CP_DIR/"
+    echo -e "${GREEN}✓${NC} HANDOFF.md 복사됨"
+else
+    echo -e "${YELLOW}⚠${NC} HANDOFF.md 없음"
+fi
+
+# 4. 메타데이터 생성
+echo -e "${BLUE}[4/4] 메타데이터 생성${NC}"
+cat > "$CP_DIR/metadata.json" << EOF
+{
+    "id": "$CP_ID",
+    "stage": "$CURRENT_STAGE",
+    "description": "$DESCRIPTION",
+    "created_at": "$TIMESTAMP_ISO",
+    "files": []
+}
+EOF
+
+# 파일 목록 추가
+if command -v jq &> /dev/null; then
+    FILES=$(find "$CP_DIR" -type f -not -name "metadata.json" | jq -R -s -c 'split("\n") | map(select(length > 0))')
+    jq ".files = $FILES" "$CP_DIR/metadata.json" > "$CP_DIR/metadata.json.tmp" && mv "$CP_DIR/metadata.json.tmp" "$CP_DIR/metadata.json"
+fi
+echo -e "${GREEN}✓${NC} 메타데이터 생성됨"
+
+# 5. progress.json에 체크포인트 추가
+echo ""
+echo -e "${BLUE}상태 업데이트${NC}"
+jq ".checkpoints += [{\"id\": \"$CP_ID\", \"stage\": \"$CURRENT_STAGE\", \"description\": \"$DESCRIPTION\", \"created_at\": \"$TIMESTAMP_ISO\"}] | \
+    .stages.\"$CURRENT_STAGE\".checkpoint_id = \"$CP_ID\"" \
+    "$PROGRESS_FILE" > "${PROGRESS_FILE}.tmp" && mv "${PROGRESS_FILE}.tmp" "$PROGRESS_FILE"
+echo -e "${GREEN}✓${NC} progress.json 업데이트됨"
+
+# 완료 메시지
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo -e "${GREEN}✓${NC} 체크포인트 생성 완료!"
+echo ""
+echo "  ID: $CP_ID"
+echo "  위치: state/checkpoints/$CP_ID/"
+echo ""
+echo -e "${BLUE}복구 명령어:${NC}"
+echo "  scripts/restore-checkpoint.sh $CP_ID"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"

package/template/scripts/gemini-wrapper.sh

@@ -0,0 +1,96 @@
+#!/bin/bash
+# gemini-wrapper.sh - tmux 기반 Gemini CLI 래퍼
+# ax-templates workflow pipeline
+# tmux wait-for 채널 기반 동기화 방식 (폴링 없음, 즉시 반응)
+
+SESSION_NAME="ax-gemini"
+CHANNEL="ax-gemini-done-$$"
+OUTPUT_FILE="/tmp/ax-gemini-output-$$"
+PROMPT="$1"
+TIMEOUT="${2:-300}"  # 기본 5분 타임아웃
+
+# 색상 정의
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# 사용법
+if [ -z "$PROMPT" ]; then
+    echo "사용법: $0 \"<prompt>\" [timeout_seconds]"
+    echo "예시: $0 \"Reddit에서 Claude Code 관련 게시물을 찾아줘\" 300"
+    exit 1
+fi
+
+# tmux 확인
+if ! command -v tmux &> /dev/null; then
+    echo -e "${RED}오류:${NC} tmux가 설치되어 있지 않습니다."
+    echo "설치: brew install tmux (macOS) 또는 apt install tmux (Ubuntu)"
+    exit 1
+fi
+
+# Gemini CLI 확인
+if ! command -v gemini &> /dev/null; then
+    echo -e "${YELLOW}경고:${NC} gemini CLI가 설치되어 있지 않습니다."
+    echo "Gemini CLI 없이 시뮬레이션 모드로 실행합니다."
+    echo ""
+    echo "[시뮬레이션] Gemini 응답:"
+    echo "---"
+    echo "Gemini CLI가 설치되면 실제 응답이 표시됩니다."
+    echo "프롬프트: $PROMPT"
+    exit 0
+fi
+
+# 임시 파일 정리
+cleanup() {
+    rm -f "$OUTPUT_FILE"
+}
+trap cleanup EXIT
+
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo -e "${BLUE}🤖 Gemini CLI 호출${NC}"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "  세션: $SESSION_NAME"
+echo "  타임아웃: ${TIMEOUT}초"
+echo ""
+
+# tmux 세션 확인/생성
+if ! tmux has-session -t "$SESSION_NAME" 2>/dev/null; then
+    echo -e "${YELLOW}⚠${NC} 새 tmux 세션 생성: $SESSION_NAME"
+    tmux new-session -d -s "$SESSION_NAME"
+    sleep 1
+fi
+
+# 프롬프트 이스케이프
+ESCAPED_PROMPT=$(printf '%s' "$PROMPT" | sed 's/"/\\"/g' | sed "s/'/'\\\\''/g")
+
+# Gemini CLI 실행 + 완료 시 채널에 시그널
+echo -e "${BLUE}Gemini 호출 중...${NC}"
+tmux send-keys -t "$SESSION_NAME" "gemini \"$ESCAPED_PROMPT\" 2>&1 | tee $OUTPUT_FILE; tmux wait-for -S $CHANNEL" Enter
+
+# 타임아웃 처리를 위해 백그라운드 타이머
+(sleep "$TIMEOUT" && tmux wait-for -S "$CHANNEL" 2>/dev/null) &
+TIMER_PID=$!
+
+# 채널 시그널 대기 (블로킹)
+tmux wait-for "$CHANNEL"
+kill $TIMER_PID 2>/dev/null || true
+
+# 결과 출력
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo -e "${GREEN}📄 Gemini 응답:${NC}"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+if [[ -f "$OUTPUT_FILE" ]]; then
+    cat "$OUTPUT_FILE"
+else
+    echo -e "${RED}오류:${NC} 출력을 캡처하지 못했습니다."
+    exit 1
+fi
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo -e "${GREEN}✓${NC} Gemini 호출 완료"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"

package/template/scripts/init-project.sh

@@ -0,0 +1,109 @@
+#!/bin/bash
+# init-project.sh - 새 프로젝트 초기화
+# ax-templates workflow pipeline
+
+set -e
+
+PROJECT_NAME="$1"
+PROJECT_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+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
+
+# 사용법
+if [ -z "$PROJECT_NAME" ]; then
+    echo "사용법: $0 <project-name>"
+    echo "예시: $0 my-saas-app"
+    exit 1
+fi
+
+# 프로젝트 이름 검증
+if ! [[ "$PROJECT_NAME" =~ ^[a-z0-9-]+$ ]]; then
+    echo -e "${RED}오류:${NC} 프로젝트 이름은 영문 소문자, 숫자, 하이픈만 허용됩니다."
+    exit 1
+fi
+
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "🚀 프로젝트 초기화: $PROJECT_NAME"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+# 1. 프로젝트 디렉토리 생성
+PROJECT_DIR="$PROJECT_ROOT/projects/$PROJECT_NAME"
+
+if [ -d "$PROJECT_DIR" ]; then
+    echo -e "${RED}오류:${NC} 프로젝트 '$PROJECT_NAME'이(가) 이미 존재합니다."
+    exit 1
+fi
+
+mkdir -p "$PROJECT_DIR"
+echo -e "${GREEN}✓${NC} 프로젝트 디렉토리 생성: $PROJECT_DIR"
+
+# 2. 상태 파일 초기화
+PROGRESS_FILE="$PROJECT_ROOT/state/progress.json"
+
+if command -v jq &> /dev/null; then
+    jq ".pipeline.project_name = \"$PROJECT_NAME\" | \
+        .pipeline.started_at = \"$TIMESTAMP\" | \
+        .pipeline.updated_at = \"$TIMESTAMP\" | \
+        .current_stage = \"01-brainstorm\"" \
+        "$PROGRESS_FILE" > "${PROGRESS_FILE}.tmp" && mv "${PROGRESS_FILE}.tmp" "$PROGRESS_FILE"
+    echo -e "${GREEN}✓${NC} 상태 파일 업데이트됨"
+else
+    echo -e "${YELLOW}⚠${NC} jq 미설치 - 상태 파일 수동 업데이트 필요"
+fi
+
+# 3. 입력 파일 템플릿 생성
+BRAINSTORM_DIR="$PROJECT_ROOT/stages/01-brainstorm"
+mkdir -p "$BRAINSTORM_DIR/inputs"
+
+cat > "$BRAINSTORM_DIR/inputs/project_brief.md" << 'EOF'
+# Project Brief
+
+## 프로젝트 이름
+{{PROJECT_NAME}}
+
+## 한 줄 설명
+[프로젝트를 한 줄로 설명해주세요]
+
+## 문제 정의
+[해결하려는 문제는 무엇인가요?]
+
+## 타겟 사용자
+[주요 사용자는 누구인가요?]
+
+## 핵심 기능 (초안)
+1. [기능 1]
+2. [기능 2]
+3. [기능 3]
+
+## 성공 기준
+[프로젝트가 성공했다고 판단하는 기준은?]
+
+## 제약조건
+- 일정:
+- 예산:
+- 기술:
+
+## 참고 자료
+- [URL 또는 문서]
+EOF
+
+sed -i '' "s/{{PROJECT_NAME}}/$PROJECT_NAME/g" "$BRAINSTORM_DIR/inputs/project_brief.md" 2>/dev/null || \
+sed -i "s/{{PROJECT_NAME}}/$PROJECT_NAME/g" "$BRAINSTORM_DIR/inputs/project_brief.md"
+
+echo -e "${GREEN}✓${NC} 프로젝트 브리프 템플릿 생성: stages/01-brainstorm/inputs/project_brief.md"
+
+# 4. 완료 메시지
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo -e "${GREEN}✓${NC} 프로젝트 '$PROJECT_NAME' 초기화 완료!"
+echo ""
+echo -e "${BLUE}다음 단계:${NC}"
+echo "1. stages/01-brainstorm/inputs/project_brief.md 작성"
+echo "2. /run-stage 01-brainstorm 실행"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"

package/template/scripts/list-stages.sh

@@ -0,0 +1,245 @@
+#!/bin/bash
+# list-stages.sh - 스테이지 목록 및 상세 정보 표시
+# ax-templates workflow pipeline
+
+set -e
+
+PROJECT_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+PROGRESS_FILE="$PROJECT_ROOT/state/progress.json"
+STAGES_DIR="$PROJECT_ROOT/stages"
+
+# 색상 정의
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+WHITE='\033[1;37m'
+GRAY='\033[0;90m'
+NC='\033[0m' # No Color
+
+# 옵션 및 인자 처리
+OUTPUT_JSON=false
+FILTER_PENDING=false
+FILTER_COMPLETED=false
+STAGE_NUM=""
+
+while [[ "$#" -gt 0 ]]; do
+    case $1 in
+        --json) OUTPUT_JSON=true ;;
+        --pending) FILTER_PENDING=true ;;
+        --completed) FILTER_COMPLETED=true ;;
+        [0-9]*) STAGE_NUM="$1" ;;
+        *) ;;
+    esac
+    shift
+done
+
+# jq 확인
+if ! command -v jq &> /dev/null; then
+    echo -e "${RED}오류:${NC} jq가 필요합니다."
+    exit 1
+fi
+
+# 스테이지 정보 배열
+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-management" "implementation" "refactoring" "qa" "testing" "deployment")
+declare -a STAGE_AI=("Gemini+Claude" "Claude+MCP" "Gemini" "Gemini" "ClaudeCode" "ClaudeCode" "Codex" "ClaudeCode" "Codex" "ClaudeCode")
+declare -a STAGE_MODES=("YOLO" "Plan Mode" "Plan Mode" "Plan Mode" "Plan Mode" "Plan+Sandbox" "Deep Dive" "Plan+Sandbox" "Playwright" "Headless")
+declare -a STAGE_SHORTCUTS=("brainstorm" "research" "planning" "ui-ux" "tasks" "implement" "refactor" "qa" "test" "deploy")
+
+# 현재 스테이지 가져오기
+if [ -f "$PROGRESS_FILE" ]; then
+    CURRENT_STAGE=$(jq -r '.current_stage // "none"' "$PROGRESS_FILE")
+else
+    CURRENT_STAGE="none"
+fi
+
+# 상태 아이콘 반환
+status_icon() {
+    case $1 in
+        completed) echo "✅" ;;
+        in_progress) echo "🔄" ;;
+        pending) echo "⏳" ;;
+        failed) echo "❌" ;;
+        *) echo "⏳" ;;
+    esac
+}
+
+# 특정 스테이지 상세 보기
+show_stage_detail() {
+    local num=$1
+    local idx=$((num - 1))
+
+    if [ $idx -lt 0 ] || [ $idx -ge 10 ]; then
+        echo -e "${RED}오류:${NC} 유효한 스테이지 번호를 입력하세요 (01-10)"
+        exit 1
+    fi
+
+    local STAGE_ID="${STAGE_IDS[$idx]}"
+    local STAGE_NAME="${STAGE_NAMES[$idx]}"
+    local AI="${STAGE_AI[$idx]}"
+    local MODE="${STAGE_MODES[$idx]}"
+    local SHORTCUT="${STAGE_SHORTCUTS[$idx]}"
+    local STAGE_PATH="$STAGES_DIR/$STAGE_ID"
+    local CONFIG_PATH="$STAGE_PATH/config.yaml"
+
+    # 상태 가져오기
+    if [ -f "$PROGRESS_FILE" ]; then
+        STATUS=$(jq -r ".stages.\"$STAGE_ID\".status // \"pending\"" "$PROGRESS_FILE")
+    else
+        STATUS="pending"
+    fi
+
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    printf "📋 ${WHITE}Stage %02d: %s${NC}\n" "$num" "${STAGE_NAME^}"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo -e "AI Model:    ${CYAN}$AI${NC}"
+    echo -e "Mode:        ${CYAN}$MODE${NC}"
+    echo -e "Status:      $(status_icon $STATUS) $STATUS"
+
+    # config.yaml에서 추가 정보 가져오기
+    if [ -f "$CONFIG_PATH" ]; then
+        # timeout 추출 (yq가 있으면 사용, 없으면 grep)
+        if command -v yq &> /dev/null; then
+            TIMEOUT=$(yq -r '.timeout // "60"' "$CONFIG_PATH")
+            CHECKPOINT=$(yq -r '.checkpoint_required // false' "$CONFIG_PATH")
+        else
+            TIMEOUT=$(grep "timeout:" "$CONFIG_PATH" 2>/dev/null | head -1 | awk '{print $2}' || echo "60")
+            CHECKPOINT=$(grep "checkpoint_required:" "$CONFIG_PATH" 2>/dev/null | head -1 | awk '{print $2}' || echo "false")
+        fi
+        echo -e "Timeout:     ${TIMEOUT}분"
+        if [ "$CHECKPOINT" == "true" ]; then
+            echo -e "Checkpoint:  ${YELLOW}필수${NC}"
+        fi
+    fi
+
+    echo ""
+
+    # Inputs
+    echo -e "${BLUE}[Inputs]${NC}"
+    if [ -d "$STAGE_PATH/inputs" ]; then
+        find "$STAGE_PATH/inputs" -type f -name "*.md" -o -name "*.json" -o -name "*.yaml" 2>/dev/null | while read -r f; do
+            echo " • $(basename "$f")"
+        done
+    fi
+    if [ $idx -gt 0 ]; then
+        PREV_IDX=$((idx - 1))
+        PREV_STAGE="${STAGE_IDS[$PREV_IDX]}"
+        echo -e " ${GRAY}• $PREV_STAGE/outputs/*${NC}"
+    fi
+    if [ -z "$(find "$STAGE_PATH/inputs" -type f 2>/dev/null)" ] && [ $idx -eq 0 ]; then
+        echo " (없음 - 첫 번째 스테이지)"
+    fi
+
+    echo ""
+
+    # Outputs
+    echo -e "${BLUE}[Outputs]${NC}"
+    if [ -d "$STAGE_PATH/outputs" ]; then
+        for f in "$STAGE_PATH/outputs"/*; do
+            if [ -e "$f" ]; then
+                echo " • $(basename "$f")"
+            fi
+        done
+    fi
+    if [ -d "$STAGE_PATH/templates" ]; then
+        echo -e " ${GRAY}(템플릿 참조: templates/)${NC}"
+    fi
+
+    echo ""
+
+    # Quick Commands
+    echo -e "${BLUE}[Quick Commands]${NC}"
+    echo " • /$SHORTCUT      - 이 스테이지 바로 시작"
+    printf " • /run-stage %02d  - 전제조건 확인 후 시작\n" "$num"
+
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+}
+
+# 특정 스테이지 상세 보기
+if [ -n "$STAGE_NUM" ]; then
+    # 앞의 0 제거
+    STAGE_NUM=$((10#$STAGE_NUM))
+    show_stage_detail "$STAGE_NUM"
+    exit 0
+fi
+
+# JSON 출력
+if [ "$OUTPUT_JSON" = true ]; then
+    echo "["
+    for i in "${!STAGE_IDS[@]}"; do
+        STAGE_ID="${STAGE_IDS[$i]}"
+        STATUS="pending"
+        if [ -f "$PROGRESS_FILE" ]; then
+            STATUS=$(jq -r ".stages.\"$STAGE_ID\".status // \"pending\"" "$PROGRESS_FILE")
+        fi
+
+        if [ $i -gt 0 ]; then echo ","; fi
+        printf '{"id":"%s","name":"%s","ai":"%s","mode":"%s","status":"%s"}' \
+            "$STAGE_ID" "${STAGE_NAMES[$i]}" "${STAGE_AI[$i]}" "${STAGE_MODES[$i]}" "$STATUS"
+    done
+    echo "]"
+    exit 0
+fi
+
+# 목록 표시
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo -e "📋 ${WHITE}Pipeline Stages${NC}"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+printf " ${GRAY}##  %-16s %-14s %-12s Status${NC}\n" "Stage" "AI Model" "Mode"
+echo "─────────────────────────────────────────────────────────────"
+
+for i in "${!STAGE_IDS[@]}"; do
+    STAGE_ID="${STAGE_IDS[$i]}"
+    STAGE_NAME="${STAGE_NAMES[$i]}"
+    AI="${STAGE_AI[$i]}"
+    MODE="${STAGE_MODES[$i]}"
+
+    # 상태 가져오기
+    STATUS="pending"
+    if [ -f "$PROGRESS_FILE" ]; then
+        STATUS=$(jq -r ".stages.\"$STAGE_ID\".status // \"pending\"" "$PROGRESS_FILE")
+    fi
+
+    # 필터링
+    if [ "$FILTER_PENDING" = true ] && [ "$STATUS" != "pending" ]; then
+        continue
+    fi
+    if [ "$FILTER_COMPLETED" = true ] && [ "$STATUS" != "completed" ]; then
+        continue
+    fi
+
+    ICON=$(status_icon "$STATUS")
+    NUM=$(printf "%02d" $((i + 1)))
+
+    # 현재 스테이지 표시
+    if [ "$STAGE_ID" == "$CURRENT_STAGE" ]; then
+        ARROW=" ${YELLOW}←${NC}"
+    else
+        ARROW=""
+    fi
+
+    printf " %s  %-16s %-14s %-12s %s%b\n" "$NUM" "$STAGE_NAME" "$AI" "$MODE" "$ICON" "$ARROW"
+done
+
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+# 다음 단계 안내
+if [ "$CURRENT_STAGE" != "none" ] && [ -n "$CURRENT_STAGE" ]; then
+    CURRENT_NUM=$(echo "$CURRENT_STAGE" | cut -d'-' -f1)
+    CURRENT_NUM=$((10#$CURRENT_NUM))
+    NEXT_NUM=$((CURRENT_NUM + 1))
+
+    if [ $NEXT_NUM -le 10 ]; then
+        NEXT_SHORTCUT="${STAGE_SHORTCUTS[$((NEXT_NUM - 1))]}"
+        printf "현재: ${CYAN}%s${NC} | 다음: ${GREEN}/run-stage %02d${NC} 또는 ${GREEN}/%s${NC}\n" \
+            "$CURRENT_STAGE" "$NEXT_NUM" "$NEXT_SHORTCUT"
+    else
+        echo -e "현재: ${CYAN}$CURRENT_STAGE${NC} | ${GREEN}파이프라인 완료!${NC}"
+    fi
+else
+    echo -e "시작: ${GREEN}/init-project [name]${NC} 또는 ${GREEN}/run-stage 01${NC}"
+fi
+
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"