create-ax-project 1.0.0

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

@@ -0,0 +1,115 @@
+#!/bin/bash
+# statusline.sh - Claude Code Statusline API를 통한 실시간 컨텍스트 모니터링
+# ax-templates workflow pipeline
+#
+# Claude Code가 ~300ms마다 JSON을 stdin으로 전달합니다.
+# 이 스크립트는 remaining_percentage를 분석하여 임계값 도달 시 자동 조치를 수행합니다.
+
+set -e
+
+PROJECT_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+STATE_FILE="$PROJECT_ROOT/state/context/auto-trigger.json"
+PROGRESS_FILE="$PROJECT_ROOT/state/progress.json"
+CONTEXT_DIR="$PROJECT_ROOT/state/context"
+
+# 컨텍스트 디렉토리 확인
+mkdir -p "$CONTEXT_DIR"
+
+# stdin에서 JSON 읽기
+input=$(cat)
+
+# JSON 파싱 (jq 필요)
+if ! command -v jq &> /dev/null; then
+    echo "[CTX] jq 필요"
+    exit 0
+fi
+
+# 컨텍스트 데이터 추출
+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")
+
+# 현재 스테이지 가져오기
+if [ -f "$PROGRESS_FILE" ]; then
+    CURRENT_STAGE=$(jq -r '.current_stage // "none"' "$PROGRESS_FILE" 2>/dev/null || echo "none")
+else
+    CURRENT_STAGE="none"
+fi
+
+# 숫자 비교를 위한 정수 변환
+REMAINING_INT=$(printf "%.0f" "$REMAINING" 2>/dev/null || echo "100")
+
+# 상태 및 색상 결정
+# 임계값: 60% 경고, 50% 자동저장, 40% 크리티컬
+if [ "$REMAINING_INT" -le 40 ]; then
+    # 40% 이하: 크리티컬 - /clear 권고
+    STATUS_ICON="🔴"
+    STATUS_TEXT="CTX≤40%"
+    NEEDS_ACTION="critical"
+elif [ "$REMAINING_INT" -le 50 ]; then
+    # 50% 이하: 자동 스냅샷 트리거
+    STATUS_ICON="⚠️"
+    STATUS_TEXT="CTX≤50%"
+    NEEDS_ACTION="warning"
+elif [ "$REMAINING_INT" -le 60 ]; then
+    # 60% 이하: 경고 표시
+    STATUS_ICON="⚡"
+    STATUS_TEXT="CTX≤60%"
+    NEEDS_ACTION="notice"
+else
+    # 정상
+    STATUS_ICON="✓"
+    STATUS_TEXT=""
+    NEEDS_ACTION="none"
+fi
+
+# 50% 이하일 때 자동 조치
+if [ "$NEEDS_ACTION" = "warning" ] || [ "$NEEDS_ACTION" = "critical" ]; then
+    # 이미 트리거 되었는지 확인 (중복 방지)
+    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")
+
+        # 같은 레벨에서 이미 트리거 되었으면 스킵
+        if [ "$TRIGGERED" = "true" ]; then
+            # 더 낮은 레벨로 떨어지면 다시 트리거
+            if [ "$REMAINING_INT" -lt "$TRIGGER_REMAINING" ]; then
+                ALREADY_TRIGGERED=false
+            else
+                ALREADY_TRIGGERED=true
+            fi
+        fi
+    fi
+
+    if [ "$ALREADY_TRIGGERED" = false ]; then
+        # 트리거 상태 기록
+        cat > "$STATE_FILE" << EOF
+{
+    "triggered": true,
+    "timestamp": "$(date -Iseconds)",
+    "remaining": $REMAINING_INT,
+    "level": "$NEEDS_ACTION",
+    "stage": "$CURRENT_STAGE"
+}
+EOF
+
+        # 자동 스냅샷 생성 (백그라운드)
+        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% 이상) 트리거 상태 리셋
+if [ "$REMAINING_INT" -ge 70 ] && [ -f "$STATE_FILE" ]; then
+    rm -f "$STATE_FILE"
+fi
+
+# 상태줄 출력
+if [ -n "$STATUS_TEXT" ]; then
+    echo "[$MODEL] $STATUS_ICON $STATUS_TEXT ${REMAINING_INT}% | Stage: $CURRENT_STAGE"
+else
+    echo "[$MODEL] $STATUS_ICON ${REMAINING_INT}% | Stage: $CURRENT_STAGE"
+fi

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

@@ -0,0 +1,104 @@
+#!/bin/bash
+# stop.sh - Claude 응답 완료 후 컨텍스트 자동 관리
+# ax-templates workflow pipeline
+#
+# Stop hook: Claude 응답이 완료된 후 실행됨
+# 컨텍스트가 50% 이하이면 자동으로 /compact 실행
+
+set -e
+
+PROJECT_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+TRIGGER_FILE="$PROJECT_ROOT/state/context/auto-trigger.json"
+COOLDOWN_FILE="$PROJECT_ROOT/state/context/.last-compact"
+CONTEXT_DIR="$PROJECT_ROOT/state/context"
+PROGRESS_FILE="$PROJECT_ROOT/state/progress.json"
+
+# 쿨다운 시간 (초) - 5분
+COOLDOWN_SECONDS=300
+
+# 컨텍스트 디렉토리 확인
+mkdir -p "$CONTEXT_DIR"
+
+# jq 필요
+if ! command -v jq &> /dev/null; then
+    exit 0
+fi
+
+# stdin에서 hook 데이터 읽기
+input=$(cat)
+
+# 1. 트리거 파일 확인 (statusline.sh에서 생성)
+if [ ! -f "$TRIGGER_FILE" ]; then
+    exit 0  # 트리거 없음 - 정상 상태
+fi
+
+TRIGGERED=$(jq -r '.triggered // false' "$TRIGGER_FILE" 2>/dev/null || echo "false")
+if [ "$TRIGGERED" != "true" ]; then
+    exit 0
+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% 이하가 아니면 스킵
+if [ "$REMAINING" -gt 50 ]; then
+    exit 0
+fi
+
+# 2. 쿨다운 확인 (5분 내 재실행 방지)
+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
+        # 쿨다운 중 - 스킵
+        REMAINING_COOLDOWN=$((COOLDOWN_SECONDS - ELAPSED))
+        exit 0
+    fi
+fi
+
+# 3. tmux 세션 확인
+if [ -z "$TMUX" ]; then
+    # tmux 세션이 아님 - 수동 안내만 제공
+    echo ""
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo "⚠️  컨텍스트 ${REMAINING}% - /compact 실행을 권장합니다"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    exit 0
+fi
+
+# 4. 스냅샷 저장 확인 (이미 statusline.sh에서 저장했어야 함)
+LATEST_SNAPSHOT=$(ls -1t "$CONTEXT_DIR"/auto-snapshot-*.md 2>/dev/null | head -1)
+if [ -z "$LATEST_SNAPSHOT" ]; then
+    # 스냅샷 없음 - 먼저 저장
+    "$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
+
+# 스냅샷이 여전히 없으면 안전을 위해 스킵
+if [ -z "$LATEST_SNAPSHOT" ]; then
+    echo ""
+    echo "⚠️  스냅샷 저장 실패 - /compact 자동 실행 취소"
+    exit 0
+fi
+
+# 5. 사전 알림
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "🔄 컨텍스트 ${REMAINING}% - 자동 /compact 실행 중..."
+echo "   스냅샷: $(basename "$LATEST_SNAPSHOT")"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+# 6. 쿨다운 타이머 기록
+date +%s > "$COOLDOWN_FILE"
+
+# 7. 트리거 파일에 compact 예정 표시
+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  # 잠시 대기 (출력이 보이도록)
+tmux send-keys "/compact" Enter
+
+exit 0

package/template/.claude/settings.json

@@ -0,0 +1,149 @@
+{
+  "name": "ax-templates",
+  "version": "1.2.0",
+  "description": "Multi-AI Workflow Pipeline Template System",
+
+  "statusline": {
+    "script": ".claude/hooks/statusline.sh",
+    "enabled": true
+  },
+
+  "context_management": {
+    "warning_threshold_percent": 60,
+    "action_threshold_percent": 50,
+    "critical_threshold_percent": 40,
+    "auto_snapshot_on_warning": true,
+    "auto_compact_enabled": true,
+    "auto_recovery_enabled": true,
+    "compact_cooldown_seconds": 300,
+    "snapshot_dir": "state/context"
+  },
+
+  "hooks_info": {
+    "note": "실제 hooks 설정은 settings.local.json에 있음",
+    "stop": ".claude/hooks/stop.sh - 자동 /compact",
+    "session_start": ".claude/hooks/session-start.sh - 자동 복구"
+  },
+
+  "commands": {
+    "init-project": {
+      "description": "새 프로젝트 초기화",
+      "file": "commands/init-project.md"
+    },
+    "run-stage": {
+      "description": "스테이지 실행",
+      "file": "commands/run-stage.md"
+    },
+    "handoff": {
+      "description": "핸드오프 문서 생성",
+      "file": "commands/handoff.md"
+    },
+    "checkpoint": {
+      "description": "체크포인트 생성",
+      "file": "commands/checkpoint.md"
+    },
+    "gemini": {
+      "description": "Gemini CLI 호출 (tmux)",
+      "file": "commands/gemini.md"
+    },
+    "codex": {
+      "description": "Codex CLI 호출 (tmux)",
+      "file": "commands/codex.md"
+    },
+    "status": {
+      "description": "파이프라인 상태 확인",
+      "file": "commands/status.md"
+    },
+    "stages": {
+      "description": "스테이지 목록 및 상세",
+      "file": "commands/stages.md"
+    },
+    "restore": {
+      "description": "체크포인트 복구",
+      "file": "commands/restore.md"
+    },
+    "next": {
+      "description": "다음 스테이지 전환",
+      "file": "commands/next.md"
+    },
+    "context": {
+      "description": "컨텍스트 상태 관리",
+      "file": "commands/context.md"
+    },
+    "brainstorm": {
+      "description": "01-brainstorm 스테이지 시작",
+      "file": "commands/brainstorm.md"
+    },
+    "research": {
+      "description": "02-research 스테이지 시작",
+      "file": "commands/research.md"
+    },
+    "planning": {
+      "description": "03-planning 스테이지 시작",
+      "file": "commands/planning.md"
+    },
+    "ui-ux": {
+      "description": "04-ui-ux 스테이지 시작",
+      "file": "commands/ui-ux.md"
+    },
+    "tasks": {
+      "description": "05-task-management 스테이지 시작",
+      "file": "commands/tasks.md"
+    },
+    "implement": {
+      "description": "06-implementation 스테이지 시작",
+      "file": "commands/implement.md"
+    },
+    "refactor": {
+      "description": "07-refactoring 스테이지 시작",
+      "file": "commands/refactor.md"
+    },
+    "qa": {
+      "description": "08-qa 스테이지 시작",
+      "file": "commands/qa.md"
+    },
+    "test": {
+      "description": "09-testing 스테이지 시작",
+      "file": "commands/test.md"
+    },
+    "deploy": {
+      "description": "10-deployment 스테이지 시작",
+      "file": "commands/deploy.md"
+    },
+    "collaborate": {
+      "description": "Multi-AI 협업 실행",
+      "file": "commands/collaborate.md"
+    },
+    "benchmark": {
+      "description": "AI 모델 벤치마킹",
+      "file": "commands/benchmark.md"
+    },
+    "fork": {
+      "description": "파이프라인 분기 관리",
+      "file": "commands/fork.md"
+    },
+    "validate": {
+      "description": "산출물 검증 실행",
+      "file": "commands/validate.md"
+    }
+  },
+
+  "skills": {
+    "smart-handoff": {
+      "description": "스마트 컨텍스트 추출 및 HANDOFF 생성",
+      "directory": "skills/smart-handoff"
+    },
+    "ai-collaboration": {
+      "description": "Multi-AI 협업 오케스트레이션",
+      "directory": "skills/ai-collaboration"
+    },
+    "auto-checkpoint": {
+      "description": "자동 체크포인트 생성",
+      "directory": "skills/auto-checkpoint"
+    },
+    "output-validator": {
+      "description": "산출물 검증 및 품질 확인",
+      "directory": "skills/output-validator"
+    }
+  }
+}

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

@@ -0,0 +1,61 @@
+# AI Collaboration Skill
+
+Multi-AI 협업 및 오케스트레이션 스킬
+
+## 개요
+
+여러 AI 모델(Claude, Gemini, Codex)을 협업시켜 더 나은 결과물을 생성합니다:
+- 병렬 실행으로 다양한 관점 확보
+- 순차 핸드오프로 점진적 개선
+- 토론 모드로 최적 결론 도출
+
+## 트리거
+
+- `/collaborate` 명령어
+- 복잡한 태스크 감지 시 자동 제안
+- 낮은 확신도 감지 시
+
+## 협업 모드
+
+### 1. Parallel Execution (병렬 실행)
+동일 작업을 여러 AI가 동시 수행 → 최적 결과 선택
+
+```bash
+/collaborate --mode parallel --task "아이디어 생성" --models "gemini,claude"
+```
+
+### 2. Sequential Handoff (순차 핸드오프)
+AI 간 릴레이로 결과물 점진적 개선
+
+```bash
+/collaborate --mode sequential --chain "code_review"
+```
+
+### 3. Debate Mode (토론 모드)
+AI 간 토론으로 다양한 관점에서 최적 결론 도출
+
+```bash
+/collaborate --mode debate --topic "아키텍처 선택" --rounds 3
+```
+
+## 파일 구조
+
+```
+ai-collaboration/
+├── README.md          # 이 파일
+├── parallel.md        # 병렬 실행 가이드
+├── debate.md          # 토론 모드 가이드
+└── prompts/
+    └── CLAUDE.md      # AI 지침
+```
+
+## 설정
+
+`config/ai_collaboration.yaml` 참조
+
+## 출력
+
+- 각 AI 결과물
+- 비교 분석 리포트
+- 최종 선택/병합 결과
+- `state/collaborations/` 저장

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

@@ -0,0 +1,148 @@
+# AI Collaboration - Debate Mode
+
+## 토론 모드
+
+여러 AI 모델이 다양한 관점에서 토론하여 최적의 결론을 도출합니다.
+
+## 사용 시나리오
+
+1. **아키텍처 결정**: 여러 설계 대안 비교
+2. **기술 선택**: 프레임워크/라이브러리 선택
+3. **트레이드오프 분석**: 성능 vs 유지보수성 등
+
+## 토론 구조
+
+### 참가자 역할
+
+```yaml
+participants:
+  advocate:
+    model: "claude"
+    perspective: "기술적 실현 가능성"
+    stance: "안정적이고 검증된 접근법"
+
+  challenger:
+    model: "gemini"
+    perspective: "혁신적 접근법"
+    stance: "새로운 기술과 방법론"
+```
+
+### 토론 라운드
+
+```
+Round 1: 초기 입장 제시
+  - Advocate: [입장 + 근거]
+  - Challenger: [반대 입장 + 근거]
+
+Round 2: 반박 및 보완
+  - Advocate: [반박 + 추가 근거]
+  - Challenger: [반박 + 추가 근거]
+
+Round 3: 수렴 및 결론
+  - 공통점 도출
+  - 합의점 정리
+  - 최종 권장사항
+```
+
+## 토론 규칙
+
+```yaml
+rules:
+  rounds: 3
+  max_tokens_per_turn: 2000
+  require_evidence: true
+  convergence_check: true
+```
+
+### 증거 요구사항
+- 주장에는 반드시 근거 제시
+- 가능한 경우 수치/데이터 포함
+- 사례 인용 권장
+
+## 실행 방법
+
+### 1. 토론 주제 설정
+```bash
+/collaborate --mode debate --topic "모놀리식 vs 마이크로서비스"
+```
+
+### 2. 관점 할당
+```yaml
+debate_setup:
+  topic: "모놀리식 vs 마이크로서비스"
+  advocate:
+    model: "claude"
+    position: "모놀리식 (초기 단계)"
+  challenger:
+    model: "gemini"
+    position: "마이크로서비스 (확장성)"
+```
+
+### 3. 토론 진행
+각 라운드별로 순차적으로 응답 수집
+
+### 4. 결론 도출
+```yaml
+conclusion:
+  method: "consensus"  # or "vote", "weighted"
+  include_dissenting: true
+```
+
+## 출력 형식
+
+```markdown
+# Debate Results
+
+## Topic
+[토론 주제]
+
+## Round 1: Initial Positions
+
+### Advocate (Claude)
+**Position**: [입장]
+**Arguments**:
+1. [근거 1]
+2. [근거 2]
+
+### Challenger (Gemini)
+**Position**: [입장]
+**Arguments**:
+1. [근거 1]
+2. [근거 2]
+
+## Round 2: Rebuttals
+[반박 내용]
+
+## Round 3: Convergence
+[수렴 과정]
+
+## Conclusion
+
+### Consensus Points
+- [합의점 1]
+- [합의점 2]
+
+### Remaining Differences
+- [의견 차이]
+
+### Recommendation
+[최종 권장사항]
+
+### Dissenting Opinion
+[소수 의견 - 선택적]
+```
+
+## 결론 도출 방법
+
+### Consensus (합의)
+- 공통점 추출
+- 차이점 명시
+- 절충안 제시
+
+### Vote (투표)
+- 각 AI의 최종 선택
+- 다수결
+
+### Weighted (가중치)
+- 전문성에 따른 가중치
+- 가중 평균으로 결정

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

@@ -0,0 +1,96 @@
+# AI Collaboration - Parallel Execution
+
+## 병렬 실행 모드
+
+동일한 작업을 여러 AI 모델이 동시에 수행하여 다양한 결과물 중 최적을 선택합니다.
+
+## 사용 시나리오
+
+1. **아이디어 생성**: 다양한 관점의 아이디어 수집
+2. **코드 구현**: 여러 접근법 비교
+3. **문서 작성**: 스타일 비교
+
+## 실행 프로세스
+
+### 1. 작업 정의
+```yaml
+task:
+  description: "사용자 인증 시스템 설계"
+  type: "design"
+  constraints:
+    - "JWT 기반"
+    - "OAuth 지원"
+```
+
+### 2. 모델 선택
+```yaml
+models:
+  - gemini:
+      focus: "창의적 접근"
+  - claude:
+      focus: "실용적 구현"
+```
+
+### 3. 병렬 실행
+```bash
+# tmux 세션을 통한 동시 실행
+scripts/gemini-wrapper.sh "prompts/task.md" &
+# Claude는 현재 세션에서 실행
+```
+
+### 4. 결과 수집
+각 AI의 출력을 `state/collaborations/{task_id}/` 에 저장
+
+### 5. 평가 및 선택
+```yaml
+evaluation:
+  metrics:
+    - completeness: 0.3
+    - creativity: 0.3
+    - feasibility: 0.4
+```
+
+## 병합 전략
+
+### Best-of-N
+- 점수가 가장 높은 결과 선택
+- 임계값 이상(0.85)이면 자동 선택
+
+### Synthesis
+- 각 결과의 장점만 추출
+- 새로운 통합 결과물 생성
+
+## 출력 형식
+
+```markdown
+# Parallel Execution Results
+
+## Task
+[작업 설명]
+
+## Results
+
+### Gemini Result
+[결과 내용]
+**Score**: 0.82
+
+### Claude Result
+[결과 내용]
+**Score**: 0.88
+
+## Analysis
+| Metric | Gemini | Claude |
+|--------|--------|--------|
+| Completeness | 0.80 | 0.90 |
+| Creativity | 0.90 | 0.85 |
+| Feasibility | 0.75 | 0.90 |
+
+## Selected: Claude Result
+**Reason**: 높은 실현 가능성과 완성도
+```
+
+## 리소스 관리
+
+- 최대 동시 실행: 2개 모델
+- 토큰 예산: 협업당 50,000
+- 타임아웃: 모델당 5분