docs: COMMAND.md 및 관련 명령어 파일 삭제
- COMMAND.md: 모든 명령어 목록 삭제 - .claude/commands/index.canvas: 명령어 인덱스 파일 삭제 - .claude/settings.json: MCP 서버 설정 업데이트
This commit is contained in:
233
README.md
233
README.md
@ -1,176 +1,105 @@
|
||||
# SuperClaude 기반 프로젝트 템플릿 🚀
|
||||
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://opensource.org/licenses/MIT) [](https://github.com/your-repo/tpl-superclaude) [](https://github.com/your-repo/tpl-superclaude/issues) [](https://github.com/your-repo/tpl-superclaude/blob/main/CONTRIBUTING.md)
|
||||
|
||||
[](https://github.com/your-repo/tpl-superclaude)
|
||||
이 템플릿은 SuperClaude v3를 기반으로 한 프로젝트 구조를 제공합니다. Claude Code를 확장하여 개발을 효율화합니다.
|
||||
|
||||
[](https://github.com/your-repo/tpl-superclaude/issues)
|
||||
|
||||
[](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개 전문 명령어 (e.g., `/sc:implement`, `/sc:analyze`).
|
||||
- 🎭 **스마트 페르소나**: 자동 전문가 선택 (architect, frontend 등).
|
||||
- 🔧 **MCP 통합**: 외부 도구 연동 (Context7, Sequential 등).
|
||||
- ⚡ **토큰 최적화**: 긴 대화 효율적 처리.
|
||||
|
||||
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 지원.
|
||||
프로젝트 구조: `src/`, `data/`, `tests/` 등 확장.
|
||||
|
||||
## 설정 ⚙️
|
||||
|
||||
`~/.claude/settings.json` 편집으로 커스터마이징. 대부분 기본 설정으로 충분합니다.
|
||||
`~/.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: 이 템플릿으로 어떤 프로젝트를 할 수 있나요?**
|
||||
**Q: 어떤 프로젝트에 사용하나요?**
|
||||
|
||||
A: 데이터 분석, 앱 개발 등 다양하게. SuperClaude 명령어로 자동화하세요.
|
||||
A: 데이터 분석, 앱 개발 등. SuperClaude 명령어로 자동화.
|
||||
|
||||
## 라이선스
|
||||
|
||||
MIT - [LICENSE 파일 참조](https://opensource.org/licenses/MIT)
|
||||
MIT - [LICENSE](https://opensource.org/licenses/MIT)
|
||||
|
||||
*SuperClaude를 활용한 효율적인 개발을 시작하세요! 🙂*
|
||||
*SuperClaude로 효율적 개발 시작! 🙂*
|
||||
|
||||
## Claude Code Commands
|
||||
|
||||
아래 테이블은 Claude Code의 모든 명령어를 요약한 것입니다. 명령어는 콜론(:)으로 구분된 형식으로 표시되며, 각 분류 내에서 알파벳 순으로 정렬되었습니다.
|
||||
|
||||
| 명령어 | 설명 | 분류 |
|
||||
| ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ---------------------------- |
|
||||
| /canvas:create_from_dir | Analyzes markdown files in a specified directory, groups related content, and generates a JSON Canvas with nodes and edges. | Canvas |
|
||||
| /debug | Debug command instructions for troubleshooting. | Debug |
|
||||
| /design:1-system-architecture:1-create-architecture-framework | Creates the initial architecture framework document with system overview and component inventory. | Design - System Architecture |
|
||||
| /design:1-system-architecture:2-design-components | Designs detailed component architecture with implementation patterns and integration points. | Design - System Architecture |
|
||||
| /design:1-system-architecture:3-integration-architecture | Designs system integration architecture with data flow and API specifications. | Design - System Architecture |
|
||||
| /design:1-system-architecture:4-generate-architecture-summary | Generates comprehensive architecture summary document with visual diagrams and recommendations. | Design - System Architecture |
|
||||
| /planning:1-mrd:1-start-session | Starts a new or updated MRD (Market Requirements Document) research session. | Planning - MRD |
|
||||
| /planning:1-mrd:2-analyze-research-data | Analyzes user-submitted research data, provides insights, and suggests the next research step. | Planning - MRD |
|
||||
| /planning:1-mrd:3-generate-mrd-document | Generates the final MRD document by consolidating all research and analysis from a session. | Planning - MRD |
|
||||
| /planning:1-mrd:4-compare-mrd-versions | Compares two different MRD versions (sessions) and generates a strategic change report. | Planning - MRD |
|
||||
| /planning:2-brainstorm:1-start-brainstorm | Starts a new brainstorming session for creative idea generation and systematic organization. | Planning - Brainstorm |
|
||||
| /planning:2-brainstorm:2-analyze-ideas | Analyzes generated ideas from brainstorming session, categorizes them, and suggests next steps for refinement. | Planning - Brainstorm |
|
||||
| /planning:2-brainstorm:3-generate-brainstorm-summary | Generates the final brainstorm summary document by consolidating all ideation and analysis from a session. | Planning - Brainstorm |
|
||||
| /planning:3-roadmap:1-create-from-mrd | Creates a PRD direction roadmap from an existing MRD, suggesting phased PRD development for key features with improvement directions. | Planning - Roadmap |
|
||||
| /planning:3-roadmap:2-create-from-brainstorm | Creates a PRD direction roadmap from a brainstorming session, suggesting phased PRD development for key features with improvement directions. | Planning - Roadmap |
|
||||
| /planning:create-app-design | Generate comprehensive app design document with project stage assessment. | Planning |
|
||||
| /planning:create-doc | Feature Documentation Generator instructions. | Planning |
|
||||
| /planning:create-prd-interactive | Generate a PRD interactively with clarifying questions for complex features. | Planning |
|
||||
| /planning:create-prd | Creates a PRD document compatible with Task Master's parse-prd command, with quick and interactive modes. | Planning |
|
||||
| /planning:create-rule | Create a new Cursor rule file with proper structure and conventions. | Planning |
|
||||
| /planning:create-tech-stack | Generate comprehensive technical stack documentation from codebase analysis. | Planning |
|
||||
| /planning:parse-prd | Parse a Product Requirements Document (PRD) text file to automatically generate initial tasks. | Planning |
|
||||
| /planning:update-app-design | Update existing app design document based on codebase changes and project evolution. | Planning |
|
||||
| /planning:update-project-structure | Update project structure documentation by running tree script. | Planning |
|
||||
| /planning:update-rule | Update an existing Cursor rule file with proper structure and conventions. | Planning |
|
||||
| /planning:update-tech-stack | Update existing tech stack documentation from codebase analysis. | Planning |
|
||||
| /research:architecture | Perform in-depth research on architectural patterns and best practices. | Research |
|
||||
| /research:security | Conduct comprehensive security research and vulnerability assessment. | Research |
|
||||
| /research:task | Research specific task implementation with best practices and alternatives. | Research |
|
||||
| /research:tech | Research technical solutions, frameworks, and implementation strategies. | Research |
|
||||
| /snippets:create-snippet | Generates a snippet template based on provided example code. | Snippets |
|
||||
| /task:add-interactive | Add new task interactively with guided questions. | Task Management |
|
||||
| /task:add | Add new task to project task list. | Task Management |
|
||||
| /task:done | Mark task as completed and update dependencies. | Task Management |
|
||||
| /task:expand | Expand task into subtasks with detailed planning. | Task Management |
|
||||
| /task:generate | Generate individual task files from tasks.json. | Task Management |
|
||||
| /task:list | List all project tasks with status. | Task Management |
|
||||
| /task:move | Move task to new position in hierarchy. | Task Management |
|
||||
| /task:next | Show next available task based on dependencies. | Task Management |
|
||||
| /task:research | Perform research for specific task. | Task Management |
|
||||
| /task:show | Display detailed task information. | Task Management |
|
||||
| /task:spec | Generate detailed task specification following end-to-end feature implementation guide. | Task Management |
|
||||
| /task:update-task-interactive | Update task interactively with guided questions. | Task Management |
|
||||
| /task:update-task | Update existing task with new information. | Task Management |
|
||||
| /sc:analyze | Performs multi-dimensional code and system analysis. | SuperClaude |
|
||||
| /sc:build | Project builder with framework detection. | SuperClaude |
|
||||
| /sc:cleanup | Project cleanup and technical debt reduction. | SuperClaude |
|
||||
| /sc:design | Design orchestration with MCP integration. | SuperClaude |
|
||||
| /sc:document | Create focused documentation for specific components or features. | SuperClaude |
|
||||
| /sc:estimate | Provide evidence-based time and cost estimates. | SuperClaude |
|
||||
| /sc:explain | Provide clear explanations of code, concepts, or system behavior. | SuperClaude |
|
||||
| /sc:git | Git workflow assistant with automation. | SuperClaude |
|
||||
| /sc:implement | Feature and code implementation with intelligent persona activation. | SuperClaude |
|
||||
| /sc:improve | Evidence-based code enhancement and optimization. | SuperClaude |
|
||||
| /sc:index | Command catalog browsing and discovery. | SuperClaude |
|
||||
| /sc:load | Project context loading and analysis. | SuperClaude |
|
||||
| /sc:spawn | Task orchestration with multi-agent coordination. | SuperClaude |
|
||||
| /sc:task | Long-term project management and task handling. | SuperClaude |
|
||||
| /sc:test | Testing workflow orchestration. | SuperClaude |
|
||||
| /sc:troubleshoot | Systematic problem investigation and resolution. | SuperClaude |
|
||||
| /sc:workflow | Generate structured implementation workflows from PRDs and feature requirements with expert guidance. | SuperClaude |
|
||||
Reference in New Issue
Block a user