create-ax-project 1.0.0

package/template/scripts/run-stage.sh

@@ -0,0 +1,139 @@
+#!/bin/bash
+# run-stage.sh - 스테이지 실행
+# ax-templates workflow pipeline
+
+set -e
+
+STAGE_ID="$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 "$STAGE_ID" ]; then
+    echo "사용법: $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 "  08-qa            QA"
+    echo "  09-testing       테스팅"
+    echo "  10-deployment    배포"
+    exit 1
+fi
+
+# 스테이지 디렉토리 확인
+STAGE_DIR="$PROJECT_ROOT/stages/$STAGE_ID"
+
+if [ ! -d "$STAGE_DIR" ]; then
+    echo -e "${RED}오류:${NC} 스테이지를 찾을 수 없습니다: $STAGE_ID"
+    exit 1
+fi
+
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "🚀 스테이지 실행: $STAGE_ID"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+# 1. Pre-stage 훅 실행
+echo ""
+echo -e "${BLUE}[1/3] Pre-Stage 훅 실행${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 훅이 없습니다."
+fi
+
+# 2. 상태 업데이트
+echo ""
+echo -e "${BLUE}[2/3] 상태 업데이트${NC}"
+PROGRESS_FILE="$PROJECT_ROOT/state/progress.json"
+
+if command -v jq &> /dev/null; then
+    jq ".current_stage = \"$STAGE_ID\" | \
+        .stages.\"$STAGE_ID\".status = \"in_progress\" | \
+        .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 업데이트됨"
+else
+    echo -e "${YELLOW}⚠${NC} jq 미설치 - 수동 업데이트 필요"
+fi
+
+# 3. 모델 강제 실행 확인 (Issue #12, #14 해결)
+echo ""
+echo -e "${BLUE}[3/5] AI 모델 강제 실행 확인${NC}"
+STAGE_CONFIG="$STAGE_DIR/config.yaml"
+MODEL_ENFORCEMENT="$PROJECT_ROOT/config/model_enforcement.yaml"
+
+if command -v yq &> /dev/null && [ -f "$STAGE_CONFIG" ]; then
+    AUTO_INVOKE_ENABLED=$(yq '.auto_invoke.enabled // false' "$STAGE_CONFIG" 2>/dev/null)
+    AUTO_INVOKE_MODEL=$(yq '.auto_invoke.model // ""' "$STAGE_CONFIG" 2>/dev/null)
+    AUTO_INVOKE_MSG=$(yq '.auto_invoke.message // ""' "$STAGE_CONFIG" 2>/dev/null)
+    AUTO_INVOKE_REQUIRED=$(yq '.auto_invoke.required // false' "$STAGE_CONFIG" 2>/dev/null)
+
+    if [ "$AUTO_INVOKE_ENABLED" = "true" ]; then
+        echo ""
+        echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+        echo -e "${YELLOW}🤖 AI 모델 자동 호출 설정${NC}"
+        echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+        echo "  모델: $AUTO_INVOKE_MODEL"
+        echo "  필수: $AUTO_INVOKE_REQUIRED"
+        if [ -n "$AUTO_INVOKE_MSG" ] && [ "$AUTO_INVOKE_MSG" != "null" ]; then
+            echo ""
+            echo -e "  ${GREEN}$AUTO_INVOKE_MSG${NC}"
+        fi
+
+        if [ "$AUTO_INVOKE_REQUIRED" = "true" ]; then
+            echo ""
+            echo -e "  ${YELLOW}⚠️  이 스테이지는 ${AUTO_INVOKE_MODEL} 사용이 필수입니다.${NC}"
+            echo -e "  ${BLUE}→ /${AUTO_INVOKE_MODEL} 명령어로 호출하세요.${NC}"
+        fi
+        echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    fi
+else
+    echo -e "${YELLOW}⚠${NC} yq 미설치 또는 config.yaml 없음 - 모델 강제 확인 건너뜀"
+fi
+
+# 4. CLAUDE.md 표시
+echo ""
+echo -e "${BLUE}[4/5] 스테이지 지침 로드${NC}"
+CLAUDE_MD="$STAGE_DIR/CLAUDE.md"
+
+if [ -f "$CLAUDE_MD" ]; then
+    echo ""
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo -e "${GREEN}스테이지 CLAUDE.md:${NC}"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    cat "$CLAUDE_MD"
+    echo ""
+else
+    echo -e "${YELLOW}⚠${NC} CLAUDE.md가 없습니다."
+fi
+
+# 5. 다음 단계 안내
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo -e "${GREEN}✓${NC} 스테이지 $STAGE_ID 시작됨"
+echo ""
+echo -e "${BLUE}작업 완료 후:${NC}"
+echo "  /handoff - 핸드오프 문서 생성"
+echo "  /checkpoint [설명] - 체크포인트 생성 (06, 07 스테이지)"
+
+# AI 모델 호출 안내 추가
+if [ -n "$AUTO_INVOKE_MODEL" ] && [ "$AUTO_INVOKE_MODEL" != "null" ]; then
+    echo ""
+    echo -e "${YELLOW}AI 모델 사용:${NC}"
+    echo "  /${AUTO_INVOKE_MODEL} \"프롬프트\" - ${AUTO_INVOKE_MODEL} 호출"
+fi
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"

package/template/scripts/show-status.sh

@@ -0,0 +1,185 @@
+#!/bin/bash
+# show-status.sh - 파이프라인 상태 표시
+# ax-templates workflow pipeline
+
+set -e
+
+PROJECT_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+PROGRESS_FILE="$PROJECT_ROOT/state/progress.json"
+CONFIG_FILE="$PROJECT_ROOT/config/pipeline.yaml"
+
+# 색상 정의
+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
+OUTPUT_BRIEF=false
+
+while [[ "$#" -gt 0 ]]; do
+    case $1 in
+        --json) OUTPUT_JSON=true ;;
+        --brief) OUTPUT_BRIEF=true ;;
+        *) ;;
+    esac
+    shift
+done
+
+# jq 확인
+if ! command -v jq &> /dev/null; then
+    echo -e "${RED}오류:${NC} jq가 필요합니다."
+    exit 1
+fi
+
+# progress.json 확인
+if [ ! -f "$PROGRESS_FILE" ]; then
+    echo -e "${RED}오류:${NC} progress.json을 찾을 수 없습니다."
+    echo "  먼저 /init-project를 실행하세요."
+    exit 1
+fi
+
+# 데이터 추출
+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")
+
+# 스테이지 정보 배열
+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")
+
+# 완료된 스테이지 수 계산
+COMPLETED=0
+CURRENT_NUM=0
+for i in "${!STAGE_IDS[@]}"; do
+    STATUS=$(jq -r ".stages.\"${STAGE_IDS[$i]}\".status // \"pending\"" "$PROGRESS_FILE")
+    if [ "$STATUS" == "completed" ]; then
+        ((COMPLETED++))
+    fi
+    if [ "${STAGE_IDS[$i]}" == "$CURRENT_STAGE" ]; then
+        CURRENT_NUM=$((i + 1))
+    fi
+done
+
+TOTAL=10
+PERCENT=$((COMPLETED * 100 / TOTAL))
+
+# JSON 출력
+if [ "$OUTPUT_JSON" = true ]; then
+    jq -n \
+        --arg project "$PROJECT_NAME" \
+        --arg current "$CURRENT_STAGE" \
+        --argjson completed "$COMPLETED" \
+        --argjson total "$TOTAL" \
+        --argjson checkpoints "$CHECKPOINT_COUNT" \
+        '{project: $project, current_stage: $current, completed: $completed, total: $total, checkpoints: $checkpoints}'
+    exit 0
+fi
+
+# 간략 출력
+if [ "$OUTPUT_BRIEF" = true ]; then
+    echo "[$PROJECT_NAME] $COMPLETED/$TOTAL 완료 | 현재: $CURRENT_STAGE | 체크포인트: $CHECKPOINT_COUNT"
+    exit 0
+fi
+
+# 진행률 바 생성
+progress_bar() {
+    local percent=$1
+    local width=20
+    local filled=$((percent * width / 100))
+    local empty=$((width - filled))
+    printf "["
+    printf "%0.s█" $(seq 1 $filled) 2>/dev/null || true
+    printf "%0.s░" $(seq 1 $empty) 2>/dev/null || true
+    printf "]"
+}
+
+# 상태 아이콘 반환
+status_icon() {
+    case $1 in
+        completed) echo "✅" ;;
+        in_progress) echo "🔄" ;;
+        pending) echo "⏳" ;;
+        failed) echo "❌" ;;
+        paused) echo "⏸️" ;;
+        *) echo "⏳" ;;
+    esac
+}
+
+# 상태 텍스트 (한글)
+status_text() {
+    case $1 in
+        completed) echo "완료" ;;
+        in_progress) echo "진행중" ;;
+        pending) echo "대기" ;;
+        failed) echo "실패" ;;
+        paused) echo "중지" ;;
+        *) echo "대기" ;;
+    esac
+}
+
+# 출력
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo -e "📊 ${WHITE}Pipeline Status:${NC} ${CYAN}$PROJECT_NAME${NC}"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo -e "Progress: $(progress_bar $PERCENT) ${GREEN}$PERCENT%${NC} ($COMPLETED/$TOTAL)"
+echo ""
+
+# 스테이지 목록
+for i in "${!STAGE_IDS[@]}"; do
+    STAGE_ID="${STAGE_IDS[$i]}"
+    STAGE_NAME="${STAGE_NAMES[$i]}"
+    AI="${STAGE_AI[$i]}"
+
+    STATUS=$(jq -r ".stages.\"$STAGE_ID\".status // \"pending\"" "$PROGRESS_FILE")
+    ICON=$(status_icon "$STATUS")
+    STATUS_TXT=$(status_text "$STATUS")
+
+    NUM=$(printf "%02d" $((i + 1)))
+
+    # 현재 스테이지 표시
+    if [ "$STAGE_ID" == "$CURRENT_STAGE" ]; then
+        ARROW=" ${YELLOW}←${NC}"
+    else
+        ARROW=""
+    fi
+
+    # 색상 설정
+    if [ "$STATUS" == "completed" ]; then
+        NAME_COLOR=$GREEN
+    elif [ "$STATUS" == "in_progress" ]; then
+        NAME_COLOR=$YELLOW
+    else
+        NAME_COLOR=$GRAY
+    fi
+
+    printf " %s %s ${NAME_COLOR}%-14s${NC} %-8s ${GRAY}[%s]${NC}%b\n" \
+        "$NUM" "$ICON" "$STAGE_NAME" "$STATUS_TXT" "$AI" "$ARROW"
+done
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+# 마지막 핸드오프 찾기
+LAST_HANDOFF=""
+for ((i=${#STAGE_IDS[@]}-1; i>=0; i--)); do
+    STAGE_ID="${STAGE_IDS[$i]}"
+    if [ -f "$PROJECT_ROOT/stages/$STAGE_ID/HANDOFF.md" ]; then
+        LAST_HANDOFF="$STAGE_ID"
+        break
+    fi
+done
+
+if [ -n "$LAST_HANDOFF" ]; then
+    echo -e "체크포인트: ${CYAN}${CHECKPOINT_COUNT}개${NC} | 마지막 핸드오프: ${GREEN}${LAST_HANDOFF}${NC}"
+else
+    echo -e "체크포인트: ${CYAN}${CHECKPOINT_COUNT}개${NC} | 핸드오프: 없음"
+fi
+
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"

package/template/scripts/smart-handoff.sh

@@ -0,0 +1,254 @@
+#!/bin/bash
+# ax-templates Smart HANDOFF Script
+# 스마트 컨텍스트 추출 및 HANDOFF 생성
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+PROGRESS_FILE="$PROJECT_ROOT/state/progress.json"
+CONTEXT_DIR="$PROJECT_ROOT/state/context"
+
+# 색상 정의
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+YELLOW='\033[1;33m'
+NC='\033[0m'
+
+# 로그 함수
+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() {
+    if [ -f "$PROGRESS_FILE" ]; then
+        cat "$PROGRESS_FILE" 2>/dev/null | grep -o '"current_stage"[[:space:]]*:[[:space:]]*"[^"]*"' | cut -d'"' -f4
+    else
+        echo "unknown"
+    fi
+}
+
+# Git 변경 파일 추출
+extract_changed_files() {
+    log_info "변경된 파일 추출 중..."
+
+    if git rev-parse --is-inside-work-tree > /dev/null 2>&1; then
+        echo "### 수정된 파일"
+        echo ""
+        echo "| 파일 | 변경 유형 | 변경량 |"
+        echo "|------|----------|--------|"
+
+        git diff --stat HEAD~10 2>/dev/null | head -20 | while read -r line; do
+            if [[ "$line" =~ ^[[:space:]]*([^|]+)\|[[:space:]]*([0-9]+) ]]; then
+                local file="${BASH_REMATCH[1]}"
+                local changes="${BASH_REMATCH[2]}"
+                echo "| ${file} | modified | ${changes} |"
+            fi
+        done
+
+        echo ""
+    else
+        echo "Git 저장소가 아닙니다."
+    fi
+}
+
+# 최근 커밋 추출
+extract_recent_commits() {
+    log_info "최근 커밋 추출 중..."
+
+    if git rev-parse --is-inside-work-tree > /dev/null 2>&1; then
+        echo "### 최근 커밋"
+        echo ""
+
+        git log --oneline -5 2>/dev/null | while read -r line; do
+            echo "- $line"
+        done
+
+        echo ""
+    fi
+}
+
+# HANDOFF 템플릿 생성
+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"
+
+    mkdir -p "$stage_dir"
+
+    # 타임스탬프
+    local timestamp=$(date +%Y-%m-%d\ %H:%M:%S)
+
+    cat > "$handoff_file" << EOF
+# HANDOFF - $stage
+
+> 생성 시간: $timestamp
+> 모드: $mode
+
+## 요약
+
+[스테이지 완료 상태를 1-2문장으로 요약]
+
+## 완료된 작업
+
+- [ ] 완료된 작업 1
+- [ ] 완료된 작업 2
+- [ ] 완료된 작업 3
+
+## 핵심 결정사항
+
+### 결정 1
+- **선택**: [선택한 옵션]
+- **이유**: [선택 이유]
+- **대안**: [고려한 대안]
+
+$(extract_changed_files)
+
+$(extract_recent_commits)
+
+## 대기 이슈
+
+- [ ] 이슈 1 (우선순위: 높음)
+- [ ] 이슈 2 (우선순위: 중간)
+
+## 다음 단계
+
+1. [즉시 실행 가능한 첫 번째 액션]
+2. [두 번째 액션]
+3. [세 번째 액션]
+
+## 참조
+
+- 이전 HANDOFF: [링크]
+- 관련 문서: [링크]
+
+---
+
+## AI 호출 기록
+
+| AI | 시간 | 목적 | 결과 |
+|----|------|------|------|
+| - | - | - | - |
+
+EOF
+
+    log_success "HANDOFF 생성 완료: $handoff_file"
+}
+
+# 컴팩트 모드 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"
+
+    mkdir -p "$stage_dir"
+
+    cat > "$handoff_file" << EOF
+# HANDOFF - $stage (Compact)
+
+> $(date +%Y-%m-%d\ %H:%M:%S)
+
+## Critical
+
+[차단 이슈 및 즉시 해결 필요 사항]
+
+## Next Actions
+
+1. [첫 번째 즉시 실행 액션]
+2. [두 번째 액션]
+
+## Context
+
+[최소 필수 컨텍스트]
+
+EOF
+
+    log_success "컴팩트 HANDOFF 생성 완료: $handoff_file"
+}
+
+# 복구용 상세 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"
+
+    mkdir -p "$stage_dir"
+
+    cat > "$handoff_file" << EOF
+# HANDOFF - $stage (Recovery)
+
+> $(date +%Y-%m-%d\ %H:%M:%S)
+
+## Full Context
+
+### 현재 상태
+[상세 상태 설명]
+
+### 완료된 모든 작업
+[상세 작업 목록]
+
+### 모든 결정사항
+[결정사항 전체 목록]
+
+$(extract_changed_files)
+
+$(extract_recent_commits)
+
+## Step-by-Step Recovery
+
+### 1단계: 환경 확인
+\`\`\`bash
+# 필요한 명령어
+\`\`\`
+
+### 2단계: 상태 복원
+[복원 절차]
+
+### 3단계: 작업 재개
+[재개 절차]
+
+## 관련 체크포인트
+
+- [체크포인트 목록]
+
+EOF
+
+    log_success "복구용 HANDOFF 생성 완료: $handoff_file"
+}
+
+# 메인 실행
+main() {
+    local mode="${1:-default}"
+    local stage="${2:-$(get_current_stage)}"
+
+    if [ "$stage" = "unknown" ]; then
+        log_warning "현재 스테이지를 확인할 수 없습니다. 기본값 사용"
+        stage="00-unknown"
+    fi
+
+    case "$mode" in
+        "default"|"smart")
+            generate_handoff "$stage" "smart"
+            ;;
+        "compact")
+            generate_compact_handoff "$stage"
+            ;;
+        "recovery")
+            generate_recovery_handoff "$stage"
+            ;;
+        *)
+            echo "사용법: $0 [default|compact|recovery] [stage_id]"
+            exit 1
+            ;;
+    esac
+}
+
+main "$@"

package/template/stages/01-brainstorm/CLAUDE.md

@@ -0,0 +1,103 @@
+# Stage 01: Brainstorming
+
+> ⚠️ **필수 AI 모델: Gemini**
+> 이 스테이지의 핵심 작업(아이디어 발산, 웹 리서치)은 `/gemini` 명령어로 수행하세요.
+> ClaudeCode는 결과 구조화에만 사용합니다.
+
+발산적 아이디어 생성 및 요구사항 탐색 단계
+
+## 🎭 페르소나: Creative Explorer
+
+> 당신은 Creative Explorer입니다.
+> 제약 없이 다양한 아이디어를 탐색하고, 혁신적인 관점을 제시하세요.
+> 실현 가능성보다는 가능성의 폭을 넓히는 데 집중하세요.
+
+### 특성
+- 발산적 사고
+- 제약 없는 아이디어
+- 다양한 관점
+- 즉흥적 연결
+
+### 권장 행동
+- 다양한 아이디어 제안
+- 비전통적 접근법 탐색
+- 연관성 확장
+- What-if 시나리오
+
+### 지양 행동
+- 즉각적인 실현 가능성 판단
+- 세부 기술 구현
+- 단일 해결책에 집중
+
+### AI 설정
+- **Temperature**: 0.9 (높은 창의성)
+- **창의성**: High
+
+## 실행 모델
+- **Primary**: Gemini (창의적 아이디어 생성, 웹 리서치)
+- **Secondary**: ClaudeCode (구조화, 실현 가능성 검토)
+- **Mode**: YOLO (Container) - 자율 실행 모드
+
+## 목표
+1. 프로젝트 브리프 기반 아이디어 발산
+2. 사용자 요구사항 심층 분석
+3. 초기 범위 및 제약조건 식별
+
+## 입력 파일
+- `inputs/project_brief.md` - 프로젝트 개요
+- `inputs/user_requirements.md` - 사용자 요구사항 (선택)
+
+## 출력 파일
+- `outputs/ideas.md` - 브레인스토밍 아이디어 목록
+- `outputs/requirements_analysis.md` - 요구사항 분석 결과
+- `HANDOFF.md` - 다음 스테이지 인계 문서
+
+## 워크플로우
+
+### 1. 아이디어 발산 (Gemini)
+```
+/gemini "프로젝트 브리프를 분석하고 다음을 수행해주세요:
+1. 핵심 기능 아이디어 10개 이상 브레인스토밍
+2. 각 아이디어의 장단점 분석
+3. 사용자 페르소나 3개 생성
+4. Reddit/HackerNews에서 유사 프로젝트 사례 조사"
+```
+
+### 2. 구조화 (ClaudeCode)
+- Gemini 결과를 구조화된 문서로 정리
+- 실현 가능성 평가 추가
+- 우선순위 매트릭스 생성
+
+### 3. 요구사항 분석
+- 기능적/비기능적 요구사항 분류
+- 제약조건 식별
+- MVP 범위 제안
+
+## 프롬프트 템플릿
+
+### ideation.md
+발산적 아이디어 생성용
+
+### persona.md
+사용자 페르소나 생성용
+
+### requirements.md
+요구사항 분석용
+
+## 완료 조건
+- [ ] 최소 10개 아이디어 생성
+- [ ] 3개 이상 사용자 페르소나 정의
+- [ ] 요구사항 분석 문서 완성
+- [ ] HANDOFF.md 생성
+
+## 다음 스테이지
+→ **02-research**: 기술 리서치 및 시장 분석
+
+## 주의사항
+- 이 단계에서는 아이디어 제한 없이 발산적 사고
+- 실현 가능성은 다음 단계에서 상세 검토
+- 모든 아이디어는 기록으로 남김 (나중에 재검토 가능)
+
+
+
+