# SuperClaude 기반 프로젝트 템플릿 🚀

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

[![Version](https://img.shields.io/badge/version-1.0.0-blue.svg)](https://github.com/your-repo/tpl-superclaude)

[![GitHub issues](https://img.shields.io/github/issues/your-repo/tpl-superclaude)](https://github.com/your-repo/tpl-superclaude/issues)

[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/your-repo/tpl-superclaude/blob/main/CONTRIBUTING.md)

이 템플릿은 SuperClaude v3 프레임워크를 기반으로 한 기본 프로젝트 구조를 제공합니다. Claude Code를 확장하여 개발 작업을 더 효율적으로 수행할 수 있도록 설계되었습니다. 이 템플릿을 사용하면 데이터 분석, 앱 개발, 웹 서비스 구축 등 다양한 프로젝트를 쉽게 시작할 수 있습니다.

**📢 상태**: 기본 템플릿으로, SuperClaude v3의 초기 릴리스에 기반합니다. 추가 커스터마이징을 권장합니다.

## 이 템플릿은 무엇인가요? 🤔

이 템플릿은 SuperClaude 프레임워크를 활용한 프로젝트의 시작점입니다. 주요 특징:

- 🛠️ **SuperClaude 명령어 지원**: 16개의 전문 명령어(예: `/sc:implement`, `/sc:analyze`)를 통해 개발 태스크를 처리.
- 🎭 **스마트 페르소나**: 도메인 전문가(architect, frontend 등)가 자동으로 참여.
- 🔧 **MCP 서버 통합**: 문서 검색, UI 생성, 브라우저 자동화 등 외부 도구 연동.
- 📋 **다양한 프로젝트 적용**: 데이터 분석(예: Pandas, Matplotlib), 앱 개발(예: React, Flask) 등에 활용 가능.
- ⚡ **토큰 최적화**: 긴 대화에서도 효율적으로 작동.

이 템플릿을 클론하거나 포크하여, 자신의 프로젝트에 맞게 확장하세요!

## 현재 상태 📊

✅ **잘 작동하는 부분**:

- SuperClaude 설치 및 기본 설정.
- 핵심 명령어와 페르소나 시스템.
- MCP 서버 기본 통합.

⚠️ **알려진 이슈**:

- SuperClaude v3 초기 버전이므로 버그 발생 가능.
- 프로젝트별 커스터마이징 필요 (문서 개선 중).

## 주요 기능 ✨

### 명령어 🛠️

SuperClaude의 16개 명령어를 활용하세요:

- **개발**: `/sc:implement`, `/sc:build`, `/sc:design`
- **분석**: `/sc:analyze`, `/sc:troubleshoot`, `/sc:explain`
- **품질**: `/sc:improve`, `/sc:test`, `/sc:cleanup`
- **기타**: `/sc:document`, `/sc:git`, `/sc:estimate`, `/sc:task`, `/sc:index`, `/sc:load`, `/sc:spawn`

### 스마트 페르소나 🎭

자동으로 적합한 전문가를 선택:

- 🏗️ **architect** - 시스템 설계.
- 🎨 **frontend** - UI/UX (React 등).
- ⚙️ **backend** - API (Flask, Django 등).
- *기타 8개 페르소나*.

### MCP 통합 🔧

- **Context7**: 라이브러리 문서 검색 (예: Pandas API).
- **Sequential**: 다단계 태스크 처리.
- **Magic**: UI 컴포넌트 생성 (React 컴포넌트).
- **Playwright**: 브라우저 테스트.

## v2에서 업그레이드 시 주의사항 ⚠️

v2 사용자는 먼저 기존 파일을 정리하세요:

1. v2 제거.
2. 디렉토리 삭제: `SuperClaude/`, `~/.claude/shared/` 등.
3. v3 설치 진행.

   - 명령어 변경: v2 `/build` → v3 `/sc:implement`.

## 설치 📦

SuperClaude를 설치하고 이 템플릿을 설정하는 2단계 과정입니다.

### 단계 1: 패키지 설치

**PyPI에서 (권장)**:

```bash
uv add SuperClaude
```

**소스에서**:

```bash
git clone https://github.com/NomenAK/SuperClaude.git
cd SuperClaude
uv sync
```

**UV 설치 (필요 시)**:

```bash
curl -Ls https://astral.sh/uv/install.sh | sh
uv venv
source .venv/bin/activate
uv pip install SuperClaude
```

### 단계 2: 설치자 실행

```bash
SuperClaude install  # 빠른 설치
# 또는
SuperClaude install --interactive  # 컴포넌트 선택
SuperClaude install --minimal  # 최소 설치
SuperClaude install --profile developer  # 개발자 모드
```

**Python 3.7+가 필요합니다.** (Linux: `sudo apt install python3 python3-pip`)

템플릿 클론 후, 프로젝트 디렉토리에서 SuperClaude를 실행하세요.

## 템플릿 활용 예시 🔄

이 템플릿을 사용해 다양한 프로젝트를 시작하세요:

1. **데이터 분석 프로젝트**:

   - 라이브러리: Pandas, NumPy, Matplotlib.
   - 명령어 예: `/sc:analyze 데이터셋 분석` – 데이터 탐색 및 시각화.
   - MCP: Context7로 Pandas 문서 검색.
1. **앱 개발 프로젝트**:

   - 프론트엔드: React 앱 생성 (`/sc:implement React 컴포넌트`).
   - 백엔드: Flask API 구축 (`/sc:design API 엔드포인트`).
   - 테스트: `/sc:test unit 테스트 작성`, Playwright로 E2E 테스트.
1. **기타 프로젝트**:

   - 웹 서비스: `/sc:build Docker 컨테이너`.
   - 문서화: `/sc:document README 업데이트`.

프로젝트 구조를 `src/`, `data/`, `tests/` 등으로 확장하세요.

## 향후 계획 🔮

- v4: 훅 시스템 재도입, 추가 MCP 통합.
- 더 많은 페르소나와 크로스-CLI 지원.

## 설정 ⚙️

`~/.claude/settings.json` 편집으로 커스터마이징. 대부분 기본 설정으로 충분합니다.

## 문서 📖

- [User Guide](https://github.com/NomenAK/SuperClaude/blob/master/Docs/superclaude-user-guide.md)
- [Commands Guide](https://github.com/NomenAK/SuperClaude/blob/master/Docs/commands-guide.md)

## 프로젝트 구조 📁

```
tpl-superclaude/
├── README.md             # 프로젝트
├── src/                  # 소스 코드
├── data/                 # 데이터 파일
├── tests/                # 테스트
└── setup.py              # 설치 스크립트
```

## FAQ 🙋

**Q: 이 템플릿으로 어떤 프로젝트를 할 수 있나요?**

A: 데이터 분석, 앱 개발 등 다양하게. SuperClaude 명령어로 자동화하세요.

## 라이선스

MIT - [LICENSE 파일 참조](https://opensource.org/licenses/MIT)

*SuperClaude를 활용한 효율적인 개발을 시작하세요! 🙂*