orchestry-mcp/ORCHESTRY_CLAUDE_INSTRUCTIONS.md

Orchestry MCP Server for multi-session task management

# Orchestry Integration for Claude Sessions

## 자동 태스크 트래킹 가이드

Orchestry MCP가 설치되어 있으면, Claude는 자동으로 작업을 추적하고 다른 세션과 협업합니다.

### 🎯 자동으로 추적되는 상황들

#### 1. 새로운 기능 개발 시작
```
사용자: "인증 시스템을 만들어줘"
Claude: 
- 자동으로 "인증 시스템" 에픽 생성
- 하위 스토리들 (로그인, 회원가입, 비밀번호 재설정) 자동 생성
- 진행상황 실시간 업데이트
```

#### 2. 작업 진행 중
```
사용자: "로그인 API를 구현해줘"
Claude:
- "로그인 API 구현" 스토리를 자동으로 'in_progress'로 변경
- 완료 시 'completed'로 자동 업데이트
- 다음 작업을 위한 핸드오프 노트 작성
```

#### 3. 세션 시작/종료
```
새 세션 시작:
- sync_context로 이전 작업 내용 자동 확인
- 미완료 작업이나 핸드오프된 작업 확인

세션 종료:
- 작업 내용 자동 요약
- 다음 세션을 위한 컨텍스트 저장
```

### 🤝 협업 시나리오

#### 시나리오 1: 백엔드 → 프론트엔드 핸드오프
```
Session A (백엔드 담당):
1. "User API" 에픽 생성
2. CRUD API 구현 완료
3. 핸드오프: "API 완성, Swagger 문서 작성됨. 프론트엔드 통합 필요"

Session B (프론트엔드 담당):
1. sync_context로 Session A의 작업 확인
2. API 문서 확인 후 React 컴포넌트 개발
3. 진행상황 업데이트
```

#### 시나리오 2: 병렬 작업
```
Session A: "결제 시스템" 작업 중
Session B: "알림 시스템" 작업 중
Session C: check_team_status로 전체 상황 파악 후 "관리자 대시보드" 작업 시작
```

#### 시나리오 3: 도움 요청
```
Session A: 
- "복잡한 쿼리 최적화 필요" → request_collaboration(type: 'expertise')

Session B:
- 요청 확인 후 쿼리 최적화 솔루션 제공
- 결정사항 log_decision으로 기록
```

### 📊 프로젝트 상태 대시보드

Web UI (http://localhost:7530)에서 실시간으로 확인 가능:
- 모든 에픽/스토리 현황
- 각 세션의 작업 상태
- 핸드오프 대기 중인 작업
- 도움 요청 목록
- 프로젝트 진행률

### 🔧 설정 방법

1. **Orchestry MCP 설치**
```bash
npm install -g orchestry-mcp
```

2. **Claude에 추가**
```bash
claude mcp add orchestry-mcp
```

3. **프로젝트 생성**
```
Claude에서: "새 프로젝트 'My App' 생성해줘"
→ 자동으로 격리된 프로젝트 데이터베이스 생성
```

### 💡 베스트 프랙티스

1. **명확한 작업 정의**
   - 에픽: 큰 기능 단위 (인증 시스템, 결제 시스템)
   - 스토리: 구체적 구현 단위 (로그인 API, 결제 폼 UI)

2. **적극적인 컨텍스트 공유**
   - 중요한 결정은 즉시 log_decision
   - 막힌 부분은 request_collaboration
   - 작업 완료 시 명확한 핸드오프

3. **프로젝트 격리**
   - 각 프로젝트는 독립된 데이터베이스
   - switch_project로 프로젝트 전환
   - 여러 프로젝트 동시 진행 가능

### 🚀 실제 사용 예시

```
사용자: "전자상거래 웹사이트를 만들어보자"

Claude (자동 실행):
1. create_project("E-commerce Website", "Full-stack e-commerce platform")
2. track_epic("User Management", "User registration, login, profile")
3. track_epic("Product Catalog", "Product listing, search, categories")
4. track_epic("Shopping Cart", "Cart management, checkout process")
5. track_epic("Payment Integration", "Payment gateway integration")

사용자: "먼저 사용자 인증부터 구현해줘"

Claude (자동 실행):
1. track_story("User Management", "User Registration API", ["Email validation", "Password hashing", "JWT token generation"])
2. update_progress("User Registration API", "in_progress", "Starting implementation")
3. [코드 구현...]
4. update_progress("User Registration API", "completed", "API implemented with tests")
5. handoff_work("User Registration API", "Backend API complete. Frontend form needed.", ["Create registration form", "Add validation", "Connect to API"])
```

### 🔄 멀티 세션 워크플로우

```mermaid
graph LR
    A[Claude Session 1<br/>Backend Dev] -->|handoff| B[Claude Session 2<br/>Frontend Dev]
    C[Claude Session 3<br/>Testing] -->|feedback| A
    C -->|feedback| B
    D[Claude Session 4<br/>DevOps] -->|deploy| E[Production]
    A -->|completed| D
    B -->|completed| D
```

각 세션은 독립적으로 작동하면서도 Orchestry를 통해 완벽하게 동기화됩니다!