claude-symphony 0.0.1

package/template/.claude/skills/ai-collaboration/prompts/CLAUDE.md

@@ -0,0 +1,107 @@
+# AI Collaboration Skill - AI Instructions
+
+## 역할
+
+당신은 Multi-AI 협업 조정자입니다. 여러 AI 모델의 결과물을 조율하고 최적의 결과를 도출합니다.
+
+## 협업 모드별 지침
+
+### Parallel Execution Mode
+
+**목표**: 다양한 관점의 결과물 중 최적 선택
+
+**프로세스**:
+1. 작업을 명확히 정의
+2. 각 AI 모델에 적합한 프롬프트 준비
+3. 결과물 수집 및 평가
+4. 객관적 기준으로 선택/병합
+
+**평가 기준**:
+- 완성도 (Completeness): 요구사항 충족도
+- 창의성 (Creativity): 독창적 접근
+- 실현 가능성 (Feasibility): 구현 가능성
+
+### Sequential Handoff Mode
+
+**목표**: 각 AI의 강점을 순차적으로 활용
+
+**프로세스**:
+1. 체인 순서에 따라 작업 전달
+2. 각 단계에서 핵심 컨텍스트 유지
+3. 이전 결과물을 기반으로 개선
+4. 최종 통합 결과물 생성
+
+**핸드오프 포함 사항**:
+- 현재까지의 핵심 성과
+- 유지해야 할 결정사항
+- 다음 단계 명확한 지시
+
+### Debate Mode
+
+**목표**: 다양한 관점에서 최적 결론 도출
+
+**토론 진행 시**:
+1. 각 입장을 공정하게 대변
+2. 증거 기반 논증 요구
+3. 반박은 건설적으로
+4. 공통점과 차이점 명확히
+
+**결론 도출 시**:
+- 합의점 우선 정리
+- 미합의 사항 명시
+- 실행 가능한 권장사항 제시
+
+## 공통 원칙
+
+### 공정성
+- 특정 모델 편향 없이 평가
+- 객관적 기준 적용
+- 결과의 근거 명시
+
+### 효율성
+- 토큰 예산 준수
+- 중복 작업 최소화
+- 명확한 작업 분배
+
+### 통합성
+- 결과물 간 일관성 유지
+- 충돌 사항 해결
+- 최종 결과물 완성도 확보
+
+## 출력 형식
+
+### 협업 결과 리포트
+```markdown
+# Collaboration Report
+
+## Mode: [parallel/sequential/debate]
+## Task: [작업 설명]
+
+## Participants
+- [AI 1]: [역할/관점]
+- [AI 2]: [역할/관점]
+
+## Results Summary
+[각 AI의 핵심 기여]
+
+## Evaluation
+| Metric | AI 1 | AI 2 |
+|--------|------|------|
+
+## Final Decision
+[선택/병합 결과]
+
+## Rationale
+[결정 근거]
+```
+
+## 금지 사항
+
+- 근거 없는 모델 우대
+- 불완전한 결과물 선택
+- 핵심 정보 누락
+- 비교 없이 임의 선택
+
+
+
+

package/template/.claude/skills/auto-checkpoint/README.md

@@ -0,0 +1,77 @@
+# Auto-Checkpoint Skill
+
+자동 체크포인트 생성 및 스마트 롤백 스킬
+
+## 개요
+
+작업 안전망을 위한 자동 체크포인트 시스템:
+- 조건 기반 자동 체크포인트 생성
+- 스마트 롤백 제안 및 실행
+- 파이프라인 분기 지원
+
+## 트리거
+
+### 자동 트리거
+- 5개 태스크 완료마다
+- 100줄 이상 파일 변경 시
+- 파괴적 작업 감지 시
+- 30분 간격 (변경 있을 때)
+- 스테이지 완료 시
+
+### 수동 트리거
+- `/checkpoint` 명령어
+
+## 기능
+
+### 1. 자동 체크포인트 (trigger.md)
+- 조건 감지 및 체크포인트 생성
+- 메타데이터 기록
+- Git 태그 연동
+
+### 2. 스마트 롤백 (rollback.md)
+- 에러 분석 및 관련 체크포인트 찾기
+- 부분 롤백 지원 (파일/함수/스테이지)
+- 롤백 미리보기
+
+### 3. 파이프라인 분기
+- 여러 접근법 동시 탐색
+- 분기 비교 및 병합
+
+## 파일 구조
+
+```
+auto-checkpoint/
+├── README.md          # 이 파일
+├── trigger.md         # 체크포인트 트리거 가이드
+├── rollback.md        # 롤백 가이드
+└── prompts/
+    └── CLAUDE.md      # AI 지침
+```
+
+## 설정
+
+- `config/auto_checkpoint.yaml` - 자동 체크포인트
+- `config/smart_rollback.yaml` - 스마트 롤백
+- `config/pipeline_forking.yaml` - 파이프라인 분기
+
+## 사용 예시
+
+```bash
+# 수동 체크포인트 생성
+/checkpoint --name "feature-complete"
+
+# 롤백 제안 보기
+/restore --suggest
+
+# 특정 체크포인트로 롤백
+/restore --checkpoint "stage_06_complete_20240120"
+
+# 파이프라인 분기
+/fork --reason "아키텍처 대안 탐색"
+```
+
+## 저장 위치
+
+- 체크포인트: `state/checkpoints/`
+- 분기: `state/forks/`
+- 롤백 히스토리: `state/rollback_history/`

package/template/.claude/skills/auto-checkpoint/prompts/CLAUDE.md

@@ -0,0 +1,113 @@
+# Auto-Checkpoint Skill - AI Instructions
+
+## 역할
+
+당신은 체크포인트 및 롤백 관리 전문가입니다. 작업의 안전한 진행을 위해 체크포인트를 관리하고 문제 발생 시 스마트 롤백을 지원합니다.
+
+## 핵심 책임
+
+### 1. 체크포인트 트리거 감지
+
+다음 상황을 감지하여 체크포인트 생성을 제안하거나 실행합니다:
+
+- **태스크 완료**: 5개 태스크 완료 시
+- **파일 변경**: 100줄 이상 변경 시
+- **파괴적 작업**: rm, reset, drop 등 감지 시
+- **스테이지 완료**: 스테이지 종료 시
+
+### 2. 체크포인트 생성
+
+```
+체크포인트 생성 시 포함 사항:
+1. 현재 소스 코드
+2. 설정 파일
+3. 상태 파일 (progress.json 등)
+4. HANDOFF (있는 경우)
+5. 메타데이터 (트리거, 시간, 요약)
+```
+
+### 3. 롤백 제안
+
+에러 발생 시:
+1. 에러 유형 분석
+2. 관련 체크포인트 식별
+3. 적절한 롤백 범위 제안
+4. 영향 분석 제공
+
+## 체크포인트 생성 프로토콜
+
+### 자동 체크포인트
+```
+1. 트리거 조건 확인
+2. 현재 상태 검증
+3. 체크포인트 생성
+4. 간단한 알림 표시
+```
+
+### 파괴적 작업 전 체크포인트
+```
+1. 파괴적 패턴 감지
+2. **즉시 체크포인트 생성**
+3. 사용자에게 경고 표시
+4. 확인 후에만 작업 진행
+```
+
+## 롤백 프로토콜
+
+### 롤백 제안 시
+```markdown
+## 롤백 제안
+
+**에러 유형**: [분석된 에러]
+**권장 체크포인트**: [체크포인트 이름]
+**권장 범위**: [파일/함수/스테이지]
+
+### 영향 분석
+- 복원될 파일: [목록]
+- 잃게 될 변경: [요약]
+
+롤백을 진행하시겠습니까?
+```
+
+### 롤백 실행 시
+```
+1. 현재 상태 백업 (안전망)
+2. 체크포인트 유효성 검증
+3. 선택된 범위만 복원
+4. 무결성 확인
+5. 복구 가이드 제공
+```
+
+## 알림 형식
+
+### 체크포인트 생성 완료
+```
+✅ 체크포인트 생성: {name}
+   - 트리거: {reason}
+   - 파일: {count}개
+```
+
+### 롤백 완료
+```
+🔄 롤백 완료: {checkpoint} → 현재
+   - 복원 파일: {count}개
+   - 다음 단계: {recommendations}
+```
+
+## 금지 사항
+
+- 사용자 확인 없이 롤백 실행
+- 파괴적 작업 전 체크포인트 생략
+- 불완전한 체크포인트 생성
+- 롤백 후 복구 가이드 누락
+
+## 우선순위
+
+1. 데이터 보호 (체크포인트 생성)
+2. 사용자 경고 (파괴적 작업)
+3. 스마트 제안 (롤백 범위)
+4. 간결한 알림 (상태 표시)
+
+
+
+

package/template/.claude/skills/auto-checkpoint/rollback.md

@@ -0,0 +1,152 @@
+# Auto-Checkpoint - Rollback Guide
+
+## 스마트 롤백 시스템
+
+### 에러 발생 시 자동 분석
+
+```mermaid
+graph TD
+    A[에러 발생] --> B[에러 유형 분석]
+    B --> C[관련 체크포인트 검색]
+    C --> D[롤백 범위 계산]
+    D --> E[롤백 제안 표시]
+    E --> F{사용자 승인?}
+    F -->|Yes| G[롤백 실행]
+    F -->|No| H[수동 처리]
+```
+
+### 에러 유형별 롤백 전략
+
+| 에러 유형 | 권장 범위 | 자동 제안 |
+|----------|----------|----------|
+| 빌드 실패 | 파일 레벨 | ✅ |
+| 테스트 실패 | 함수 레벨 | ✅ |
+| 런타임 에러 | 파일 레벨 | ✅ |
+| 설정 에러 | 설정 파일만 | ✅ |
+| 심각한 오류 | 스테이지 레벨 | 확인 필요 |
+
+## 롤백 범위
+
+### 1. 파일 레벨 롤백
+```bash
+# 특정 파일만 체크포인트에서 복원
+/restore --checkpoint "auto_task_5" --files "src/auth/UserService.ts"
+```
+
+**적합한 상황**:
+- 단일 파일 변경으로 인한 오류
+- 특정 모듈 롤백
+
+### 2. 함수 레벨 롤백
+```bash
+# 특정 함수만 복원 (지원 언어: TS, JS, Python)
+/restore --checkpoint "auto_task_5" --function "UserService.login"
+```
+
+**적합한 상황**:
+- 리팩토링 중 특정 함수 문제
+- 부분적 로직 오류
+
+### 3. 스테이지 레벨 롤백
+```bash
+# 전체 스테이지 상태 복원
+/restore --checkpoint "stage_06_start"
+```
+
+**적합한 상황**:
+- 광범위한 문제
+- 아키텍처 수준 변경 취소
+
+### 4. 설정 파일만 롤백
+```bash
+/restore --checkpoint "auto_change" --config-only
+```
+
+**적합한 상황**:
+- 설정 변경으로 인한 오류
+- 환경 설정 문제
+
+## 롤백 미리보기
+
+```markdown
+## 롤백 미리보기
+
+**대상 체크포인트**: auto_task_5_20240120
+**롤백 범위**: 파일 레벨
+
+### 복원될 파일 (3개)
+| 파일 | 현재 크기 | 복원 크기 | 변경량 |
+|------|----------|----------|--------|
+| src/auth/UserService.ts | 250줄 | 180줄 | -70줄 |
+| src/types/auth.ts | 50줄 | 45줄 | -5줄 |
+| tests/auth.test.ts | 100줄 | 80줄 | -20줄 |
+
+### 잃게 될 변경사항
+- 비밀번호 해시 기능 추가 (UserService.ts:45-80)
+- 새 타입 정의 (auth.ts:40-50)
+- 관련 테스트 (auth.test.ts:70-100)
+
+### 영향받는 의존성
+- LoginForm 컴포넌트 (import 확인 필요)
+
+**이 롤백을 실행하시겠습니까? (y/n)**
+```
+
+## 롤백 실행 프로세스
+
+### 사전 작업
+1. 현재 상태 백업 체크포인트 생성
+2. 커밋되지 않은 변경사항 stash
+
+### 롤백 단계
+1. 체크포인트 유효성 검증
+2. 파일 추출
+3. 선택적 파일 복원
+4. 무결성 확인
+5. 상태 파일 업데이트
+
+### 사후 작업
+1. 검증 테스트 실행
+2. HANDOFF 업데이트
+3. 롤백 기록 저장
+
+## 복구 가이드 자동 생성
+
+```markdown
+## 파일 롤백 완료
+
+**체크포인트**: auto_task_5_20240120
+**복원된 파일**: 3개
+**시간**: 2024-01-20 14:45:00
+
+### 복구된 파일
+- src/auth/UserService.ts
+- src/types/auth.ts
+- tests/auth.test.ts
+
+### 권장 다음 단계
+1. 변경사항 확인: `git diff`
+2. 테스트 실행: `npm test`
+3. 문제가 해결되었다면:
+   - 원인 분석 후 다시 구현
+   - 더 작은 단위로 작업
+4. 문제가 지속된다면:
+   - 추가 롤백 필요 가능성
+   - `/restore --suggest` 실행
+```
+
+## 안전 장치
+
+### 롤백 차단 조건
+- 커밋되지 않은 변경사항 존재
+- 활성 프로세스 실행 중
+- 파일 잠금 상태
+
+### 확인 필요 조건
+- 스테이지 레벨 롤백
+- 10개 이상 파일 영향
+- 프로덕션 관련 파일 포함
+
+### 쿨다운
+- 연속 롤백 간 5분 대기
+- 같은 체크포인트 재롤백 경고

package/template/.claude/skills/auto-checkpoint/trigger.md

@@ -0,0 +1,122 @@
+# Auto-Checkpoint - Trigger Guide
+
+## 체크포인트 트리거 조건
+
+### 1. 태스크 완료 기반
+```yaml
+trigger:
+  condition: "tasks_completed"
+  threshold: 5
+  action: "create_checkpoint"
+```
+
+**감지 방법**:
+- TodoWrite에서 `completed` 상태 카운트
+- 커밋 기록 분석
+
+### 2. 파일 변경 기반
+```yaml
+trigger:
+  condition: "major_file_change"
+  threshold: 100  # lines
+  weights:
+    "*.ts": 1.0
+    "*.yaml": 0.5
+    "*.md": 0.3
+```
+
+**감지 방법**:
+```bash
+# 변경량 계산
+git diff --stat | awk '{sum+=$4} END {print sum}'
+```
+
+### 3. 파괴적 작업 전
+```yaml
+trigger:
+  condition: "destructive_action"
+  patterns:
+    - "rm -rf"
+    - "git reset --hard"
+    - "drop table"
+```
+
+**감지 시 동작**:
+1. 즉시 체크포인트 생성
+2. 사용자 확인 요청
+3. 확인 후 작업 진행
+
+### 4. 시간 기반
+```yaml
+trigger:
+  condition: "interval"
+  interval_minutes: 30
+  only_if_changes: true
+```
+
+### 5. 스테이지 기반
+```yaml
+trigger:
+  conditions:
+    on_stage_complete: true
+    on_stage_error: true
+```
+
+## 체크포인트 생성 프로세스
+
+```mermaid
+graph TD
+    A[트리거 감지] --> B{유효한 트리거?}
+    B -->|Yes| C[현재 상태 검증]
+    B -->|No| Z[무시]
+    C --> D[파일 수집]
+    D --> E[메타데이터 생성]
+    E --> F[아카이브 생성]
+    F --> G[무결성 검증]
+    G --> H[Git 태그 생성]
+    H --> I[오래된 체크포인트 정리]
+```
+
+## 메타데이터 형식
+
+```yaml
+checkpoint:
+  name: "auto_task_5_20240120_143022"
+  timestamp: "2024-01-20T14:30:22Z"
+  trigger: "tasks_completed"
+  stage: "06-implementation"
+  task_count: 25
+  files_changed: 12
+  git_commit: "abc1234"
+
+  summary:
+    completed_tasks: 5
+    modified_files:
+      - "src/auth/UserService.ts"
+      - "src/components/LoginForm.tsx"
+    key_changes: "사용자 인증 시스템 구현"
+```
+
+## 보존 정책
+
+```yaml
+retention:
+  max_checkpoints: 20
+  max_age_days: 30
+
+  # 절대 삭제 안함
+  milestones:
+    - stage_complete
+    - pre_destructive
+    - user_created
+```
+
+## 명명 규칙
+
+| 트리거 | 형식 | 예시 |
+|--------|------|------|
+| 태스크 | `auto_task_{count}_{timestamp}` | `auto_task_5_20240120` |
+| 파일변경 | `auto_change_{timestamp}` | `auto_change_20240120_143022` |
+| 파괴적 | `pre_destructive_{timestamp}` | `pre_destructive_20240120_143022` |
+| 스테이지 | `stage_{id}_{status}_{timestamp}` | `stage_06_complete_20240120` |
+| 수동 | `manual_{name}_{timestamp}` | `manual_feature_complete_20240120` |

package/template/.claude/skills/context-compression/README.md

@@ -0,0 +1,121 @@
+# Context Compression Skill
+
+토큰 사용량을 모니터링하고 컨텍스트를 압축하는 스킬입니다.
+
+## 트리거 조건
+
+이 스킬은 다음 조건에서 자동 활성화됩니다:
+
+1. **토큰 임계값 도달**
+   - 50,000 토큰 (warning_threshold): 경고
+   - 80,000 토큰 (limit_threshold): 압축 필수
+
+2. **스테이지 전환 시**
+   - 이전 스테이지 컨텍스트 정리
+   - 필수 정보만 유지
+
+3. **명시적 호출**
+   - `/context --compress` 명령
+
+## 기능
+
+### 1. 컨텍스트 분석 (analyze.md)
+- 현재 토큰 사용량 추정
+- 카테고리별 분류
+- 압축 가능 영역 식별
+
+### 2. 압축 실행 (compress.md)
+- 중요도 기반 필터링
+- 요약 생성
+- state.md 저장
+
+### 3. 복구 지원 (prompts/compression.md)
+- 저장된 컨텍스트 로드
+- 작업 상태 복원
+
+## 스킬 파일 구조
+
+```
+context-compression/
+├── README.md           # 이 파일
+├── analyze.md          # 컨텍스트 분석 로직
+├── compress.md         # 압축 로직
+└── prompts/
+    └── compression.md  # 압축 프롬프트
+```
+
+## 압축 전략
+
+### 유지 (Keep)
+- ✅ 결정사항 및 이유
+- ✅ 요구사항 명세
+- ✅ 아키텍처 선택
+- ✅ 현재 작업 상태
+- ✅ 에러 해결책 (최종)
+
+### 요약 (Summarize)
+- 📝 긴 토론 과정
+- 📝 탐색/조사 과정
+- 📝 여러 대안 비교
+
+### 제거 (Remove)
+- ❌ 오류 시행착오 과정
+- ❌ 중복된 시도
+- ❌ 임시 출력/로그
+- ❌ 이미 적용된 코드 diff
+
+## 사용 예시
+
+### 자동 경고
+
+```
+⚠️ 토큰 사용량 경고
+
+현재: ~52,000 토큰 (50,000 초과)
+
+권장 조치:
+1. /context --compress 실행
+2. 또는 /clear 후 state.md 복구
+
+계속 진행하면 80,000에서 자동 저장됩니다.
+```
+
+### 수동 압축
+
+```
+/context --compress
+
+컨텍스트 압축 중...
+
+[분석]
+- 총 토큰: ~65,000
+- 결정사항: ~5,000 (유지)
+- 토론 내용: ~40,000 (요약 → 8,000)
+- 오류 로그: ~20,000 (제거)
+
+[결과]
+- 압축 후: ~13,000 토큰
+- 절감: 80%
+
+state/context/state.md에 저장됨
+```
+
+## 관련 명령어
+
+- `/context` - 컨텍스트 상태 확인
+- `/context --compress` - 압축 실행
+- `/context --save` - 스냅샷 저장
+
+## 설정
+
+settings.json에서 임계값 조정:
+
+```json
+{
+  "context": {
+    "warning_threshold": 50000,
+    "limit_threshold": 80000,
+    "auto_save": true
+  }
+}
+```