SuperClaude-Org/SuperClaude_Framework

<div align="center">

🚀 SuperClaude Framework

Claude Code를 구조화된 개발 플랫폼으로 변환하세요

<p align="center"> <a href="#-quick-installation">빠른 시작</a> • <a href="#-support-the-project">후원</a> • <a href="#-whats-new-in-v4">기능</a> • <a href="#-documentation">문서</a> • <a href="#-contributing">기여</a> </p>

</div>

<div align="center">

📊 프레임워크 통계

브레인스토밍부터 배포까지 전체 개발 수명 주기를 포괄하는 30개의 슬래시 명령어.

</div>

<div align="center">

🎯 개요

SuperClaude는 메타프로그래밍 구성 프레임워크로, 행동 명령어 주입과 컴포넌트 오케스트레이션을 통해 Claude Code를 구조화된 개발 플랫폼으로 변환합니다. 강력한 도구와 지능형 에이전트를 통해 체계적인 워크플로우 자동화를 제공합니다.

면책 조항

이 프로젝트는 Anthropic과 제휴하거나 보증하지 않습니다. Claude Code는 Anthropic이 구축하고 유지 관리하는 제품입니다.

📖 개발자 및 기여자를 위한 문서

SuperClaude Framework 작업에 필요한 필수 문서:

💡 프로 팁: Claude Code는 세션 시작 시 이러한 파일을 읽어 프로젝트 표준에 부합하는 일관되고 고품질의 개발을 보장합니다.

>

📚 SuperClaude가 처음이신가요? Commands Reference부터 시작하세요. 시각적 결정 트리, 상세한 명령어 비교, 워크플로우 예제가 포함되어 있어 어떤 명령어를 언제 사용해야 하는지 이해하는 데 도움이 됩니다.

⚡ 빠른 설치

중요: 이전 문서에 설명된 TypeScript 플러그인 시스템은 아직 사용할 수 없습니다(v5.0 예정). 현재 설치 지침은 아래 v4.x 단계를 따르세요.

현재 안정 버전 (v4.3.0)

SuperClaude는 현재 슬래시 명령어를 사용합니다.

옵션 1: pipx (권장)

# PyPI에서 설치
pipx install superclaude

# 명령어 설치 (30개 슬래시 명령어 모두 설치)
superclaude install

# MCP 서버 설치 (선택 사항, 향상된 기능용)
superclaude mcp --list         # 사용 가능한 MCP 서버 목록
superclaude mcp                # 대화형 설치
superclaude mcp --servers tavily --servers context7  # 특정 서버 설치

# 설치 확인
superclaude install --list
superclaude doctor

• /sc:research - 심층 웹 검색 (Tavily MCP로 향상)
• /sc:brainstorm - 구조화된 브레인스토밍
• /sc:implement - 코드 구현
• /sc:test - 테스트 워크플로우
• /sc:pm - 프로젝트 관리
• /sc - 사용 가능한 30개 명령어 모두 표시

설치 후 Claude Code를 다시 시작하면 다음을 포함한 30개의 명령어를 사용할 수 있습니다:

옵션 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% 적은 토큰 ⚡

성능 비교:

</div>

<div align="center">

💖 프로젝트 후원

솔직히 말해서, SuperClaude를 유지 관리하는 데는 시간과 자원이 필요합니다.

>

Claude Max 구독만 해도 테스트에 매월 100달러가 들며, 문서화, 버그 수정, 기능 개발에 소요되는 시간은 말할 것도 없습니다.

일상 업무에서 SuperClaude의 가치를 느끼신다면 프로젝트 후원을 고려해 주세요.

소액이라도 기본 비용을 충당하고 개발을 활성화하는 데 도움이 됩니다.

>

코드, 피드백, 후원 등 모든 기여자가 중요합니다. 커뮤니티의 일원이 되어 주셔서 감사합니다! 🙏

<table> <tr> <td align="center" width="33%">

☕ Ko-fi

일회성 기부

</td> <td align="center" width="33%">

🎯 Patreon

월간 후원

</td> <td align="center" width="33%">

💜 GitHub

유연한 등급

</td> </tr> </table>

후원이 지원하는 항목:

참고: 압박은 없습니다. 프레임워크는 계속 오픈 소스로 유지됩니다. 사람들이 사용하고 감사한다는 사실만으로도 동기부여가 됩니다. 코드, 문서, 또는 입소문을 통한 기여도 도움이 됩니다! 🙏

</div>

<div align="center">

🎉 v4.1의 새로운 기능

버전 4.1은 슬래시 명령어 아키텍처 안정화, 에이전트 기능 향상, 문서 개선에 중점을 둡니다.

<table> <tr> <td width="50%">

🤖 더 스마트한 에이전트 시스템

• PM 에이전트는 체계적인 문서화를 통해 지속적인 학습 보장
• 심층 연구 에이전트는 자율적인 웹 검색 수행
• 보안 엔지니어는 실제 취약점 발견
• 프론트엔드 아키텍트는 UI 패턴 이해
• 컨텍스트 기반 자동 조정
• 필요 시 도메인별 전문성 제공

20개의 특화 에이전트와 도메인 전문성:

</td> <td width="50%">

⚡ 최적화된 성능

• 프레임워크 설치 공간 축소
• 코드에 더 많은 컨텍스트 제공
• 더 긴 대화 가능
• 복잡한 작업 지원

더 작은 프레임워크, 더 큰 프로젝트:

</td> </tr> <tr> <td width="50%">

🔧 MCP 서버 통합

8개의 강력한 서버와 쉬운 CLI 설치:

# 사용 가능한 MCP 서버 목록
superclaude mcp --list

# 특정 서버 설치
superclaude mcp --servers tavily context7

# 대화형 설치
superclaude mcp

• Tavily → 기본 웹 검색 (심층 연구)
• Context7 → 공식 문서 조회
• Sequential-Thinking → 다단계 추론
• Serena → 세션 지속성 및 메모리
• Playwright → 교차 브라우저 자동화
• Magic → UI 컴포넌트 생성
• Morphllm-Fast-Apply → 컨텍스트 인식 코드 수정
• Chrome DevTools → 성능 분석

사용 가능한 서버:

</td> <td width="50%">

🎯 행동 모드

• 브레인스토밍 → 올바른 질문을 함
• 비즈니스 패널 → 다중 전문가 전략 분석
• 심층 연구 → 자율적인 웹 검색
• 오케스트레이션 → 효율적인 도구 조정
• 토큰 효율성 → 30-50% 컨텍스트 절약
• 작업 관리 → 체계적인 조직화
• 내성 → 메타인지 분석

7가지 적응형 모드 for 다양한 컨텍스트:

</td> </tr> <tr> <td width="50%">

📚 문서 개편

• 실제 예제 및 사용 사례
• 일반적인 함정 문서화
• 실용적인 워크플로우 포함
• 더 나은 탐색 구조

개발자를 위한 완전 재작성:

</td> <td width="50%">

🧪 향상된 안정성

• 핵심 명령어 버그 수정
• 테스트 커버리지 개선
• 더 강력한 오류 처리
• CI/CD 파이프라인 개선

신뢰성에 초점:

</td> </tr> </table>

</div>

<div align="center">

🔬 심층 연구 기능

DR 에이전트 아키텍처에 맞춘 자율 웹 검색

SuperClaude v4.2는 포괄적인 심층 연구 기능을 도입하여 자율적이고 적응적이며 지능적인 웹 검색을 가능하게 합니다.

<table> <tr> <td width="50%">

🎯 적응형 계획

• 계획 전용: 명확한 질문에 대한 직접 실행
• 의도 계획: 모호한 요청에 대한 명확화
• 통합: 협력적 계획 개선 (기본값)

세 가지 지능형 전략:

</td> <td width="50%">

🔄 다중 홉 추론

• 엔터티 확장 (논문 → 저자 → 저작물)
• 개념 심화 (주제 → 세부사항 → 예제)
• 시간적 진행 (현재 → 과거)
• 인과 관계 체인 (효과 → 원인)

최대 5회 반복 검색:

</td> </tr> </table>

</div>