# SuperClaude MCP Server - 빠른 시작 가이드 🚀

## 5분 안에 시작하기

### 1. 빠른 설치 (1분)

```bash
# 디렉토리 생성 및 이동
mkdir ~/superclaude-mcp && cd ~/superclaude-mcp

# 필요한 파일 다운로드 (위의 artifact 파일들을 저장)
# - superclaude-mcp-server.js
# - package.json

# 의존성 설치
npm install
```

### 2. Gemini CLI 설정 (2분)

```bash
# Gemini 설정 파일 열기
nano ~/.gemini/settings.json
```

다음 내용 추가:
```json
{
  "mcpServers": {
    "superclaude": {
      "command": "node",
      "args": ["~/superclaude-gemini-integration-mcp/superclaude-mcp-server.js"]
    }
  }
}
```

### 3. 첫 번째 명령어 실행 (2분)

```bash
# Gemini CLI 시작
gemini

# MCP 서버 확인
/mcp

# 첫 SuperClaude 명령어
"Use sc_build to create a React todo app"
```

## 핵심 명령어 Top 10

### 1. 프로젝트 생성
```bash
gemini "Use sc_build to create React app with TypeScript and TDD"
```

### 2. 페르소나 전환
```bash
gemini "Switch to frontend persona for UI development"
```

### 3. 코드 분석
```bash
gemini "Use sc_analyze to check code quality and architecture"
```

### 4. 문제 해결
```bash
gemini "Use sc_troubleshoot to debug the API timeout issue"
```

### 5. 보안 검사
```bash
gemini "Switch to security persona and run sc_scan"
```

### 6. 테스트 생성
```bash
gemini "Use sc_test to create comprehensive test suite"
```

### 7. 성능 최적화
```bash
gemini "Use sc_improve to optimize database queries"
```

### 8. 체크포인트
```bash
gemini "Create checkpoint before major refactoring"
```

### 9. 문서 생성
```bash
gemini "Use sc_document to create API documentation"
```

### 10. 배포
```bash
gemini "Use sc_deploy to staging with validation"
```

## 실전 시나리오

### 시나리오 1: 새 기능 개발

```bash
# 1. 아키텍트로 설계
gemini "Switch to architect persona and design user authentication feature"

# 2. 체크포인트 생성
gemini "Create checkpoint named feature-auth-start"

# 3. 구현
gemini "Use sc_build to implement auth module with --api --tdd"

# 4. 테스트
gemini "Switch to qa persona and use sc_test with full coverage"

# 5. 보안 검토
gemini "Switch to security persona and scan the auth implementation"
```

### 시나리오 2: 버그 수정

```bash
# 1. 문제 분석
gemini "Use sc_troubleshoot to investigate login failures"

# 2. 체크포인트
gemini "Create emergency checkpoint"

# 3. 수정
gemini "Fix the authentication bug based on troubleshooting results"

# 4. 검증
gemini "Run regression tests to ensure no side effects"
```

### 시나리오 3: 성능 개선

```bash
# 1. 토큰 최적화 모드
gemini "Set token mode to compressed for efficiency"

# 2. 성능 분석
gemini "Use sc_analyze with --performance flag on API endpoints"

# 3. 개선
gemini "Use sc_improve to optimize the identified bottlenecks"

# 4. 벤치마크
gemini "Run performance benchmarks to verify improvements"
```

## 프로 팁 💡

### 1. 별칭 설정으로 더 빠르게
```bash
# ~/.bashrc 또는 ~/.zshrc에 추가
alias gsc="gemini 'Execute SuperClaude command:'"
alias gsc-build="gemini 'Use sc_build to'"
alias gsc-fix="gemini 'Use sc_troubleshoot to fix'"
```

### 2. GEMINI.md로 자동화
프로젝트 루트에 `GEMINI.md` 생성:
```markdown
# Project Commands

When I say "build", use sc_build with our standard flags
When I say "check", run sc_analyze and sc_test
When I say "ship", run sc_deploy with validation
```

### 3. 워크플로우 스크립트
```bash
#!/bin/bash
# daily-workflow.sh

echo "🌅 Starting daily workflow..."

# 코드 품질 체크
gemini "Use sc_analyze for daily code review"

# 테스트 실행
gemini "Run all tests with coverage report"

# 보안 스캔
gemini "Quick security scan for new code"

echo "✅ Daily checks complete!"
```

## 문제 해결

### "MCP server not found"
```bash
# Gemini CLI 재시작
pkill gemini
gemini
```

### "Command not recognized"
```bash
# MCP 서버 상태 확인
gemini "/mcp"
# superclaude가 목록에 있는지 확인
```

### "Permission denied"
```bash
chmod +x ~/superclaude-mcp/superclaude-mcp-server.js
```

## 다음 단계

1. **고급 워크플로우 탐색**: `superclaude-workflows.js` 사용
2. **팀 설정 공유**: 설정 파일을 Git에 커밋
3. **커스텀 페르소나 추가**: 팀에 맞는 페르소나 정의
4. **자동화 확장**: CI/CD 파이프라인에 통합

## 도움말

- GitHub Issues: [SuperClaude MCP 이슈](https://github.com/your-repo)
- 커뮤니티: SuperClaude Discord
- 문서: [전체 문서](./README.md)

---

🎉 **축하합니다!** 이제 SuperClaude의 모든 기능을 Gemini CLI에서 사용할 수 있습니다!