diff --git a/.claude/commands/index.canvas b/.claude/commands/index.canvas deleted file mode 100644 index 7bdec65..0000000 --- a/.claude/commands/index.canvas +++ /dev/null @@ -1,654 +0,0 @@ -{ - "nodes": [ - { - "type": "group", - "id": "planning-group", - "x": 0, - "y": 0, - "width": 2200, - "height": 1200, - "label": "Planning Commands" - }, - { - "type": "group", - "id": "planning-mrd", - "x": 50, - "y": 50, - "width": 900, - "height": 500, - "label": "1. MRD Process" - }, - { - "type": "file", - "id": "mrd-1", - "x": 100, - "y": 100, - "width": 400, - "height": 200, - "file": ".claude/commands/planning/1-mrd/1-start-session.md" - }, - { - "type": "file", - "id": "mrd-2", - "x": 520, - "y": 100, - "width": 400, - "height": 200, - "file": ".claude/commands/planning/1-mrd/2-analyze-research-data.md" - }, - { - "type": "file", - "id": "mrd-3", - "x": 100, - "y": 320, - "width": 400, - "height": 200, - "file": ".claude/commands/planning/1-mrd/3-generate-mrd-document.md" - }, - { - "type": "file", - "id": "mrd-4", - "x": 520, - "y": 320, - "width": 400, - "height": 200, - "file": ".claude/commands/planning/1-mrd/4-compare-mrd-versions.md" - }, - { - "type": "group", - "id": "planning-brainstorm", - "x": 1000, - "y": 50, - "width": 500, - "height": 500, - "label": "2. Brainstorm Process" - }, - { - "type": "file", - "id": "brainstorm-1", - "x": 1050, - "y": 100, - "width": 400, - "height": 100, - "file": ".claude/commands/planning/2-brainstorm/1-start-brainstorm.md" - }, - { - "type": "file", - "id": "brainstorm-2", - "x": 1050, - "y": 220, - "width": 400, - "height": 100, - "file": ".claude/commands/planning/2-brainstorm/2-analyze-ideas.md" - }, - { - "type": "file", - "id": "brainstorm-3", - "x": 1050, - "y": 340, - "width": 400, - "height": 100, - "file": ".claude/commands/planning/2-brainstorm/3-generate-brainstorm-summary.md" - }, - { - "type": "group", - "id": "planning-roadmap", - "x": 1550, - "y": 50, - "width": 500, - "height": 500, - "label": "3. Roadmap Process" - }, - { - "type": "file", - "id": "roadmap-1", - "x": 1600, - "y": 100, - "width": 400, - "height": 200, - "file": ".claude/commands/planning/3-roadmap/1-create-from-mrd.md" - }, - { - "type": "file", - "id": "roadmap-2", - "x": 1600, - "y": 320, - "width": 400, - "height": 200, - "file": ".claude/commands/planning/3-roadmap/2-create-from-brainstorm.md" - }, - { - "type": "file", - "id": "planning-create-prd", - "x": 50, - "y": 600, - "width": 300, - "height": 100, - "file": ".claude/commands/planning/create-prd.md" - }, - { - "type": "file", - "id": "planning-create-prd-interactive", - "x": 370, - "y": 600, - "width": 300, - "height": 100, - "file": ".claude/commands/planning/create-prd-interactive.md" - }, - { - "type": "file", - "id": "planning-parse-prd", - "x": 690, - "y": 600, - "width": 300, - "height": 100, - "file": ".claude/commands/planning/parse-prd.md" - }, - { - "type": "file", - "id": "planning-create-app-design", - "x": 50, - "y": 720, - "width": 300, - "height": 100, - "file": ".claude/commands/planning/create-app-design.md" - }, - { - "type": "file", - "id": "planning-update-app-design", - "x": 370, - "y": 720, - "width": 300, - "height": 100, - "file": ".claude/commands/planning/update-app-design.md" - }, - { - "type": "file", - "id": "planning-create-tech-stack", - "x": 690, - "y": 720, - "width": 300, - "height": 100, - "file": ".claude/commands/planning/create-tech-stack.md" - }, - { - "type": "file", - "id": "planning-update-tech-stack", - "x": 1010, - "y": 720, - "width": 300, - "height": 100, - "file": ".claude/commands/planning/update-tech-stack.md" - }, - { - "type": "file", - "id": "planning-create-rule", - "x": 50, - "y": 840, - "width": 300, - "height": 100, - "file": ".claude/commands/planning/create-rule.md" - }, - { - "type": "file", - "id": "planning-update-rule", - "x": 370, - "y": 840, - "width": 300, - "height": 100, - "file": ".claude/commands/planning/update-rule.md" - }, - { - "type": "file", - "id": "planning-create-doc", - "x": 690, - "y": 840, - "width": 300, - "height": 100, - "file": ".claude/commands/planning/create-doc.md" - }, - { - "type": "file", - "id": "planning-update-project-structure", - "x": 1010, - "y": 840, - "width": 300, - "height": 100, - "file": ".claude/commands/planning/update-project-structure.md" - }, - { - "type": "group", - "id": "task-group", - "x": 2300, - "y": 0, - "width": 1200, - "height": 800, - "label": "Task Management" - }, - { - "type": "file", - "id": "task-spec", - "x": 2350, - "y": 50, - "width": 300, - "height": 100, - "file": ".claude/commands/task/spec.md", - "color": "4" - }, - { - "type": "file", - "id": "task-list", - "x": 2350, - "y": 170, - "width": 300, - "height": 100, - "file": ".claude/commands/task/list.md" - }, - { - "type": "file", - "id": "task-show", - "x": 2670, - "y": 170, - "width": 300, - "height": 100, - "file": ".claude/commands/task/show.md" - }, - { - "type": "file", - "id": "task-next", - "x": 2990, - "y": 170, - "width": 300, - "height": 100, - "file": ".claude/commands/task/next.md" - }, - { - "type": "file", - "id": "task-add", - "x": 2350, - "y": 290, - "width": 300, - "height": 100, - "file": ".claude/commands/task/add.md" - }, - { - "type": "file", - "id": "task-add-interactive", - "x": 2670, - "y": 290, - "width": 300, - "height": 100, - "file": ".claude/commands/task/add-interactive.md" - }, - { - "type": "file", - "id": "task-update", - "x": 2350, - "y": 410, - "width": 300, - "height": 100, - "file": ".claude/commands/task/update-task.md" - }, - { - "type": "file", - "id": "task-update-interactive", - "x": 2670, - "y": 410, - "width": 300, - "height": 100, - "file": ".claude/commands/task/update-task-interactive.md" - }, - { - "type": "file", - "id": "task-expand", - "x": 2350, - "y": 530, - "width": 300, - "height": 100, - "file": ".claude/commands/task/expand.md" - }, - { - "type": "file", - "id": "task-done", - "x": 2670, - "y": 530, - "width": 300, - "height": 100, - "file": ".claude/commands/task/done.md" - }, - { - "type": "file", - "id": "task-move", - "x": 2990, - "y": 530, - "width": 300, - "height": 100, - "file": ".claude/commands/task/move.md" - }, - { - "type": "file", - "id": "task-research", - "x": 2350, - "y": 650, - "width": 300, - "height": 100, - "file": ".claude/commands/task/research.md", - "color": "5" - }, - { - "type": "group", - "id": "research-group", - "x": 3600, - "y": 0, - "width": 600, - "height": 400, - "label": "Research Commands" - }, - { - "type": "file", - "id": "research-task", - "x": 3650, - "y": 50, - "width": 500, - "height": 80, - "file": ".claude/commands/research/task.md" - }, - { - "type": "file", - "id": "research-architecture", - "x": 3650, - "y": 150, - "width": 500, - "height": 80, - "file": ".claude/commands/research/architecture.md" - }, - { - "type": "file", - "id": "research-tech", - "x": 3650, - "y": 250, - "width": 500, - "height": 80, - "file": ".claude/commands/research/tech.md" - }, - { - "type": "file", - "id": "research-security", - "x": 3650, - "y": 350, - "width": 500, - "height": 80, - "file": ".claude/commands/research/security.md" - }, - { - "type": "group", - "id": "design-group", - "x": 0, - "y": 1300, - "width": 1800, - "height": 600, - "label": "Design Commands" - }, - { - "type": "group", - "id": "design-architecture", - "x": 50, - "y": 1350, - "width": 1700, - "height": 500, - "label": "System Architecture" - }, - { - "type": "file", - "id": "arch-1", - "x": 100, - "y": 1400, - "width": 380, - "height": 150, - "file": ".claude/commands/design/1-system-architecture/1-create-architecture-framework.md" - }, - { - "type": "file", - "id": "arch-2", - "x": 500, - "y": 1400, - "width": 380, - "height": 150, - "file": ".claude/commands/design/1-system-architecture/2-design-components.md" - }, - { - "type": "file", - "id": "arch-3", - "x": 900, - "y": 1400, - "width": 380, - "height": 150, - "file": ".claude/commands/design/1-system-architecture/3-integration-architecture.md" - }, - { - "type": "file", - "id": "arch-4", - "x": 1300, - "y": 1400, - "width": 380, - "height": 150, - "file": ".claude/commands/design/1-system-architecture/4-generate-architecture-summary.md" - }, - { - "type": "group", - "id": "misc-group", - "x": 1900, - "y": 1300, - "width": 700, - "height": 400, - "label": "Misc Commands" - }, - { - "type": "file", - "id": "snippet-create", - "x": 1950, - "y": 1350, - "width": 300, - "height": 100, - "file": ".claude/commands/snippets/create-snippet.md" - }, - { - "type": "file", - "id": "canvas-create", - "x": 2270, - "y": 1350, - "width": 300, - "height": 100, - "file": ".claude/commands/canvas/create_from_dir.md" - }, - { - "type": "file", - "id": "debug", - "x": 1950, - "y": 1470, - "width": 300, - "height": 100, - "file": ".claude/commands/debug.md", - "color": "1" - } - ], - "edges": [ - { - "id": "mrd-flow-1", - "fromNode": "mrd-1", - "fromSide": "right", - "toNode": "mrd-2", - "toSide": "left", - "toEnd": "arrow", - "label": "next" - }, - { - "id": "mrd-flow-2", - "fromNode": "mrd-2", - "fromSide": "bottom", - "toNode": "mrd-3", - "toSide": "top", - "toEnd": "arrow" - }, - { - "id": "mrd-flow-3", - "fromNode": "mrd-3", - "fromSide": "right", - "toNode": "mrd-4", - "toSide": "left", - "toEnd": "arrow" - }, - { - "id": "brainstorm-flow-1", - "fromNode": "brainstorm-1", - "fromSide": "bottom", - "toNode": "brainstorm-2", - "toSide": "top", - "toEnd": "arrow" - }, - { - "id": "brainstorm-flow-2", - "fromNode": "brainstorm-2", - "fromSide": "bottom", - "toNode": "brainstorm-3", - "toSide": "top", - "toEnd": "arrow" - }, - { - "id": "roadmap-flow-1", - "fromNode": "roadmap-1", - "fromSide": "bottom", - "toNode": "roadmap-2", - "toSide": "top", - "toEnd": "arrow" - }, - { - "id": "mrd-to-roadmap", - "fromNode": "planning-mrd", - "fromSide": "right", - "toNode": "roadmap-1", - "toSide": "left", - "toEnd": "arrow", - "label": "MRD → Roadmap" - }, - { - "id": "brainstorm-to-roadmap", - "fromNode": "planning-brainstorm", - "fromSide": "right", - "toNode": "roadmap-2", - "toSide": "left", - "toEnd": "arrow", - "label": "Brainstorm → Roadmap" - }, - { - "id": "prd-to-parse", - "fromNode": "planning-create-prd", - "fromSide": "right", - "toNode": "planning-parse-prd", - "toSide": "left", - "toEnd": "arrow", - "label": "create → parse" - }, - { - "id": "prd-interactive-to-parse", - "fromNode": "planning-create-prd-interactive", - "fromSide": "right", - "toNode": "planning-parse-prd", - "toSide": "left", - "toEnd": "arrow" - }, - { - "id": "planning-to-task", - "fromNode": "planning-group", - "fromSide": "right", - "toNode": "task-group", - "toSide": "left", - "toEnd": "arrow", - "label": "Planning → Tasks", - "color": "3" - }, - { - "id": "task-to-research", - "fromNode": "task-research", - "fromSide": "right", - "toNode": "research-group", - "toSide": "left", - "toEnd": "arrow", - "label": "Task Research" - }, - { - "id": "arch-flow-1", - "fromNode": "arch-1", - "fromSide": "right", - "toNode": "arch-2", - "toSide": "left", - "toEnd": "arrow" - }, - { - "id": "arch-flow-2", - "fromNode": "arch-2", - "fromSide": "right", - "toNode": "arch-3", - "toSide": "left", - "toEnd": "arrow" - }, - { - "id": "arch-flow-3", - "fromNode": "arch-3", - "fromSide": "right", - "toNode": "arch-4", - "toSide": "left", - "toEnd": "arrow" - }, - { - "id": "planning-to-design", - "fromNode": "planning-group", - "fromSide": "bottom", - "toNode": "design-group", - "toSide": "top", - "toEnd": "arrow", - "label": "Planning → Design", - "color": "2" - }, - { - "id": "task-add-link", - "fromNode": "task-add", - "fromSide": "right", - "toNode": "task-add-interactive", - "toSide": "left", - "label": "interactive" - }, - { - "id": "task-update-link", - "fromNode": "task-update", - "fromSide": "right", - "toNode": "task-update-interactive", - "toSide": "left", - "label": "interactive" - }, - { - "id": "app-design-link", - "fromNode": "planning-create-app-design", - "fromSide": "right", - "toNode": "planning-update-app-design", - "toSide": "left", - "label": "update" - }, - { - "id": "tech-stack-link", - "fromNode": "planning-create-tech-stack", - "fromSide": "right", - "toNode": "planning-update-tech-stack", - "toSide": "left", - "label": "update" - }, - { - "id": "rule-link", - "fromNode": "planning-create-rule", - "fromSide": "right", - "toNode": "planning-update-rule", - "toSide": "left", - "label": "update" - } - ] -} \ No newline at end of file diff --git a/.claude/settings.json b/.claude/settings.json index 59669f9..be2425c 100644 --- a/.claude/settings.json +++ b/.claude/settings.json @@ -1,17 +1,30 @@ { "permissions": { - "allow":[ - "Bash(ls:*)", - "Bash(mkdir:*)", - "Bash(grep:*)", - "Bash(rg:*)", - "Bash(npx tsc:*)", - "Edit", - "Bash(task-master *)", - "Bash(git commit:*)", - "Bash(git add:*)", - "Bash(npm run *)", - "mcp__task_master_ai__*" + "allow": [ + "Bash(ls:*)", + "Bash(mkdir:*)", + "Bash(grep:*)", + "Bash(rg:*)", + "Bash(npx tsc:*)", + "Edit", + "Bash(task-master *)", + "Bash(git commit:*)", + "Bash(git add:*)", + "Bash(npm run *)", + "mcp__task_master_ai__*", + "mcp__context7__*", + "mcp__magic__*", + "mcp__playwright__*", + "mcp__sequential_thinking__*", + "mcp__taskmaster-ai__*" ] - } -} + }, + "enableAllProjectMcpServers": true, + "enabledMcpjsonServers": [ + "context7", + "taskmaster-ai", + "sequential-thinking", + "playwright", + "magic" + ] +} \ No newline at end of file diff --git a/COMMAND.md b/COMMAND.md deleted file mode 100644 index b955554..0000000 --- a/COMMAND.md +++ /dev/null @@ -1,48 +0,0 @@ -# Claude Code Command List - -| Command | Description | Category | -| ----------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------- | -| /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 process guidelines for identifying and fixing issues. | Debug | -| /design/system-architecture/1-create-architecture-framework | Creates a comprehensive system architecture framework including domain separation, layered architecture, and component responsibility definitions. | Design - System Architecture | -| /design/system-architecture/2-design-components | Designs detailed system components with specifications, interfaces, and implementation guidelines based on architecture framework. | Design - System Architecture | -| /design/system-architecture/3-integration-architecture | Designs system integration architecture including communication protocols, data flow, and service integration patterns. | Design - System Architecture | -| /design/system-architecture/4-generate-architecture-summary | Generates a comprehensive architecture summary that consolidates all system architecture components into a unified documentation package. | Design - System Architecture | -| /planning/mrd/1-start-session | Starts a new or updated MRD (Market Requirements Document) research session. | Planning - MRD | -| /planning/mrd/2-analyze-research-data | Analyzes user-submitted research data, provides insights, and suggests the next research step. | Planning - MRD | -| /planning/mrd/3-generate-mrd-document | Generates the final MRD document by consolidating all research and analysis from a session. | Planning - MRD | -| /planning/mrd/4-compare-mrd-versions | Compares two MRD documents and generates a detailed comparison report. | Planning - MRD | -| /planning/brainstorm/1-start-brainstorm | Starts a new brainstorming session or continues an existing one. | Planning - Brainstorm | -| /planning/brainstorm/2-analyze-ideas | Analyzes ideas from the brainstorming session and generates insights. | Planning - Brainstorm | -| /planning/brainstorm/3-generate-brainstorm-summary | Generates a comprehensive brainstorm summary from all analyzed ideas. | Planning - Brainstorm | -| /planning/roadmap/1-create-from-mrd | Creates a product roadmap based on an MRD document. | Planning - Roadmap | -| /planning/roadmap/2-create-from-brainstorm | Creates a product roadmap based on a brainstorm summary. | Planning - Roadmap | -| /planning/create-app-design | Creates a comprehensive app design document based on user requirements. | Planning | -| /planning/create-doc | Creates a new documentation file based on user request. | Planning | -| /planning/create-prd-interactive | Interactively creates a Product Requirements Document (PRD) through guided questions. | Planning | -| /planning/create-prd | Creates a Product Requirements Document (PRD) based on user input. | Planning | -| /planning/create-rule | Creates a new coding rule file based on user description. | Planning | -| /planning/create-tech-stack | Creates a comprehensive tech stack recommendation based on project requirements. | Planning | -| /planning/parse-prd | Parses a PRD file and generates tasks. | Planning | -| /planning/update-app-design | Updates an existing app design document based on new requirements. | Planning | -| /planning/update-project-structure | Updates the project structure based on changes. | Planning | -| /planning/update-rule | Updates an existing coding rule file based on user input. | Planning | -| /planning/update-tech-stack | Updates an existing tech stack recommendation based on new requirements. | Planning | -| /research/architecture | Performs research on architecture topics. | Research | -| /research/security | Performs research on security topics. | Research | -| /research/task | Performs research on specific tasks. | Research | -| /research/tech | Performs research on technology topics. | Research | -| /snippets/create-snippet | Creates a code snippet based on user request. | Snippets | -| /task/add | Add one or more tasks to the current tag. | Task | -| /task/add-interactive | Interactively adds a task through guided questions. | Task | -| /task/done | Marks a task as done. | Task | -| /task/expand | Expands a task into subtasks. | Task | -| /task/generate | Generates task files. | Task | -| /task/list | Lists tasks in the current tag. | Task | -| /task/move | Moves tasks between tags or positions. | Task | -| /task/next | Shows the next task to work on. | Task | -| /task/research | Performs research related to a task. | Task | -| /task/show | Shows details of a specific task. | Task | -| /task/spec | Displays task specifications. | Task | -| /task/update-task-interactive | Interactively updates a task. | Task | -| /task/update-task | Updates a specific task. | Task | diff --git a/README.md b/README.md index 29e1ffa..ddb9271 100644 --- a/README.md +++ b/README.md @@ -1,176 +1,105 @@ # SuperClaude 기반 프로젝트 템플릿 🚀 -[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) +[![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) -[![Version](https://img.shields.io/badge/version-1.0.0-blue.svg)](https://github.com/your-repo/tpl-superclaude) +이 템플릿은 SuperClaude v3를 기반으로 한 프로젝트 구조를 제공합니다. Claude Code를 확장하여 개발을 효율화합니다. -[![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개 전문 명령어 (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를 활용한 효율적인 개발을 시작하세요! 🙂* \ No newline at end of file +*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 | \ No newline at end of file