fd8c67f6f0
- Bump version from 4.1.8 to 4.1.9 in all relevant files - Add __init__.py to all directories in src/superclaude/ and plugins/superclaude/ - Update pyproject.toml to include plugins/superclaude package - Update MANIFEST.in to include plugin resources - Ensure proper Python package structure with 27 __init__.py files 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
18 KiB
📊 프레임워크 통계
| 명령어 | 에이전트 | 모드 | MCP 서버 |
|---|---|---|---|
| 30 | 16 | 7 | 8 |
| 슬래시 명령어 | 전문 AI | 동작 모드 | 통합 서비스 |
브레인스토밍부터 배포까지 완전한 개발 라이프사이클을 다루는 30개의 슬래시 명령어.
🎯 개요
SuperClaude는 메타프로그래밍 설정 프레임워크로, 동작 지시 주입과 컴포넌트 통제를 통해 Claude Code를 구조화된 개발 플랫폼으로 변환합니다. 강력한 도구와 지능형 에이전트를 갖춘 체계적인 워크플로우 자동화를 제공합니다.
면책 조항
이 프로젝트는 Anthropic과 관련이 없거나 승인받지 않았습니다. Claude Code는 Anthropic에 의해 구축 및 유지 관리되는 제품입니다.
📖 개발자 및 기여자를 위한 안내
SuperClaude 프레임워크 작업을 위한 필수 문서:
| 문서 | 목적 | 언제 읽을까 |
|---|---|---|
| PLANNING.md | 아키텍처, 설계 원칙, 절대 규칙 | 세션 시작, 구현 전 |
| TASK.md | 현재 작업, 우선순위, 백로그 | 매일, 작업 시작 전 |
| KNOWLEDGE.md | 축적된 통찰력, 모범 사례, 문제 해결 | 문제 발생 시, 패턴 학습 시 |
| CONTRIBUTING.md | 기여 가이드라인, 워크플로우 | PR 제출 전 |
💡 전문가 팁: Claude Code는 세션 시작 시 이러한 파일을 읽어 프로젝트 표준에 부합하는 일관되고 고품질의 개발을 보장합니다.
⚡ 빠른 설치
중요: 이전 문서에서 설명한 TypeScript 플러그인 시스템은 아직 사용할 수 없습니다(v5.0에서 계획). v4.x의 현재 설치 지침은 아래 단계를 따르세요.
현재 안정 버전 (v4.1.9)
SuperClaude는 현재 슬래시 명령어를 사용합니다.
옵션 1: pipx (권장)
# PyPI에서 설치
pipx install superclaude
# 명령어 설치 (/research, /index-repo, /agent, /recommend 설치)
superclaude install
# 설치 확인
superclaude install --list
superclaude doctor
설치 후, 명령어를 사용하려면 Claude Code를 재시작하세요:
/sc:research- 병렬 검색으로 심층 웹 연구/sc:index-repo- 컨텍스트 최적화를 위한 리포지토리 인덱싱/sc:agent- 전문 AI 에이전트/sc:recommend- 명령어 추천/sc- 사용 가능한 모든 SuperClaude 명령어 표시
옵션 2: Git에서 직접 설치
# 리포지토리 클론
git clone https://github.com/SuperClaude-Org/SuperClaude_Framework.git
cd SuperClaude_Framework
# 설치 스크립트 실행
./install.sh
v5.0에서 제공 예정 (개발 중)
새로운 TypeScript 플러그인 시스템을 적극적으로 개발 중입니다(자세한 내용은 #419 참조). 릴리스 후 설치는 다음과 같이 단순화됩니다:
# 이 기능은 아직 사용할 수 없습니다
/plugin marketplace add SuperClaude-Org/superclaude-plugin-marketplace
/plugin install superclaude
상태: 개발 중. ETA는 설정되지 않았습니다.
향상된 성능 (선택적 MCP)
2-3배 빠른 실행과 30-50% 적은 토큰을 위해 선택적으로 MCP 서버를 설치할 수 있습니다:
# 향상된 성능을 위한 선택적 MCP 서버 (airis-mcp-gateway 경유):
# - Serena: 코드 이해 (2-3배 빠름)
# - Sequential: 토큰 효율적 추론 (30-50% 적은 토큰)
# - Tavily: 심층 연구를 위한 웹 검색
# - Context7: 공식 문서 검색
# - Mindbase: 모든 대화에 걸친 의미론적 검색 (선택적 향상)
# 참고: 오류 학습은 내장 ReflexionMemory를 통해 사용 가능 (설치 불필요)
# Mindbase는 의미론적 검색 향상을 제공 ("recommended" 프로필 필요)
# MCP 서버 설치: https://github.com/agiletec-inc/airis-mcp-gateway
# 자세한 내용은 docs/mcp/mcp-integration-policy.md 참조
성능 비교:
- MCP 없음: 완전히 기능함, 표준 성능 ✅
- MCP 사용: 2-3배 빠름, 30-50% 적은 토큰 ⚡
💖 프로젝트 후원하기
솔직히 말씀드리면, SuperClaude를 유지하는 데는 시간과 리소스가 필요합니다.
테스트를 위한 Claude Max 구독료만 매월 100달러이고, 거기에 문서화, 버그 수정, 기능 개발에 쓰는 시간이 추가됩니다. 일상 업무에서 SuperClaude의 가치를 느끼신다면, 프로젝트 후원을 고려해주세요. 몇 달러라도 기본 비용을 충당하고 개발을 계속할 수 있게 해줍니다.
코드, 피드백, 또는 후원을 통해, 모든 기여자가 중요합니다. 이 커뮤니티의 일원이 되어주셔서 감사합니다! 🙏
☕ Ko-fi일회성 기여 |
🎯 Patreon월간 후원 |
💜 GitHub유연한 티어 |
여러분의 후원으로 가능한 것들:
| 항목 | 비용/영향 |
|---|---|
| 🔬 Claude Max 테스트 | 검증과 테스트를 위해 월 100달러 |
| ⚡ 기능 개발 | 새로운 기능과 개선 사항 |
| 📚 문서화 | 포괄적인 가이드와 예제 |
| 🤝 커뮤니티 지원 | 신속한 이슈 대응과 도움 |
| 🔧 MCP 통합 | 새로운 서버 연결 테스트 |
| 🌐 인프라 | 호스팅 및 배포 비용 |
참고: 하지만 부담은 없습니다. 프레임워크는 어쨌든 오픈소스로 유지됩니다. 사람들이 사용하고 가치를 느끼고 있다는 것만 알아도 동기부여가 됩니다. 코드, 문서, 또는 정보 확산을 통한 기여도 큰 도움이 됩니다! 🙏
🎉 V4.1의 새로운 기능
버전 4.1은 슬래시 명령어 아키텍처 안정화, 에이전트 기능 강화 및 문서 개선에 중점을 둡니다.
🤖 더 스마트한 에이전트 시스템도메인 전문성을 가진 16개의 전문 에이전트:
|
⚡ 최적화된 성능더 작은 프레임워크, 더 큰 프로젝트:
|
🔧 MCP 서버 통합8개의 강력한 서버 (airis-mcp-gateway 경유):
|
🎯 동작 모드다양한 컨텍스트를 위한 7가지 적응형 모드:
|
📚 문서 전면 개편개발자를 위한 완전한 재작성:
|
🧪 안정성 강화신뢰성에 중점:
|
🔬 심층 연구 기능
DR 에이전트 아키텍처에 맞춘 자율적 웹 연구
SuperClaude v4.2는 자율적이고 적응적이며 지능적인 웹 연구를 가능하게 하는 포괄적인 심층 연구 기능을 도입합니다.
🎯 적응형 계획세 가지 지능형 전략:
|
🔄 다중 홉 추론최대 5회 반복 검색:
|
📊 품질 점수신뢰도 기반 검증:
|
🧠 사례 기반 학습세션 간 지능:
|
연구 명령어 사용
# 자동 깊이로 기본 연구
/research "2024년 최신 AI 개발"
# 제어된 연구 깊이(TypeScript의 옵션 통해)
/research "양자 컴퓨팅 혁신" # depth: exhaustive
# 특정 전략 선택
/research "시장 분석" # strategy: planning-only
# 도메인 필터링 연구(Tavily MCP 통합)
/research "React 패턴" # domains: reactjs.org,github.com
연구 깊이 수준
| 깊이 | 소스 | 홉 | 시간 | 최적 용도 |
|---|---|---|---|---|
| 빠른 | 5-10 | 1 | ~2분 | 빠른 사실, 간단한 쿼리 |
| 표준 | 10-20 | 3 | ~5분 | 일반 연구(기본값) |
| 심층 | 20-40 | 4 | ~8분 | 종합 분석 |
| 철저한 | 40+ | 5 | ~10분 | 학술 수준 연구 |
통합 도구 오케스트레이션
심층 연구 시스템은 여러 도구를 지능적으로 조정합니다:
- Tavily MCP: 주요 웹 검색 및 발견
- Playwright MCP: 복잡한 콘텐츠 추출
- Sequential MCP: 다단계 추론 및 종합
- Serena MCP: 메모리 및 학습 지속성
- Context7 MCP: 기술 문서 검색
📚 문서
🇰🇷 SuperClaude 완전 한국어 가이드
| 🚀 시작하기 | 📖 사용자 가이드 | 🛠️ 개발자 리소스 | 📋 레퍼런스 |
|---|---|---|---|
🤝 기여하기
SuperClaude 커뮤니티에 참여하세요
모든 종류의 기여를 환영합니다! 도움을 줄 수 있는 방법:
| 우선순위 | 영역 | 설명 |
|---|---|---|
| 📝 높음 | 문서 | 가이드 개선, 예제 추가, 오타 수정 |
| 🔧 높음 | MCP 통합 | 서버 설정 추가, 통합 테스트 |
| 🎯 중간 | 워크플로우 | 명령어 패턴과 레시피 작성 |
| 🧪 중간 | 테스트 | 테스트 추가, 기능 검증 |
| 🌐 낮음 | 국제화 | 문서를 다른 언어로 번역 |
⭐ Star 히스토리
📋 전체 30개 명령어
전체 명령어 목록 펼치기
🧠 계획 및 설계 (4)
/brainstorm- 구조화된 브레인스토밍/design- 시스템 아키텍처/estimate- 시간/노력 추정/spec-panel- 사양 분석
💻 개발 (5)
/implement- 코드 구현/build- 빌드 워크플로우/improve- 코드 개선/cleanup- 리팩토링/explain- 코드 설명
🧪 테스트 및 품질 (4)
/test- 테스트 생성/analyze- 코드 분석/troubleshoot- 디버깅/reflect- 회고
📚 문서화 (2)
/document- 문서 생성/help- 명령어 도움말
🔧 버전 관리 (1)
/git- Git 작업
📊 프로젝트 관리 (3)
/pm- 프로젝트 관리/task- 작업 추적/workflow- 워크플로우 자동화
🔍 연구 및 분석 (2)
/research- 심층 웹 연구/business-panel- 비즈니스 분석
🎯 유틸리티 (9)
/agent- AI 에이전트/index-repo- 리포지토리 인덱싱/index- 인덱스 별칭/recommend- 명령어 추천/select-tool- 도구 선택/spawn- 병렬 작업/load- 세션 로드/save- 세션 저장/sc- 모든 명령어 표시