SuperClaude - 전문화된 AI 개발 프레임워크

프로젝트 개요

SuperClaude는 Claude Code의 기능을 향상시키기 위해 특별히 설계된 포괄적인 구성 프레임워크입니다. SuperClaude는 Claude Code를 일반적인 AI 비서에서 전문화된 AI 개발 파트너로 전환시키며, 19개의 전문화된 명령, 9개의 인지 역할 및 고급 개발 방법론을 제공합니다.

핵심 기능

🎯 인지 역할 시스템

SuperClaude는 각각 특정 전문 분야와 사고방식을 가진 9가지 전문화된 인지 역할을 제공합니다:

역할	전문 분야	사용 시나리오	예시 명령
architect	시스템 설계, 장기 유지보수성	대규모 시스템 계획	/persona:architect → /user:design --api --ddd
frontend	사용자 경험, 시각적 인터페이스	UI/UX 작업	/persona:frontend → /user:build --react
backend	성능, 신뢰성, API	서버 개발	/persona:backend → /user:build --api
analyzer	근본 원인 분석, 증거 기반 의사결정	복잡한 문제 디버깅	/persona:analyzer → /user:troubleshoot --investigate
security	위협 모델링, 보안 우선	보안 검토	/persona:security → /user:scan --security
mentor	교육, 유도적 발견	학습/설명	/persona:mentor → /user:explain --depth
refactorer	코드 품질, 단순화	코드 개선	/persona:refactorer → /user:improve --quality
performance	속도 최적화, 병목 현상 분석	성능 튜닝	/persona:performance → /user:improve --performance
qa	품질 보증, 테스트	테스트 워크플로우	/persona:qa → /user:test --coverage

🛠️ 전문화된 명령 시스템

SuperClaude는 전체 개발 수명 주기를 포괄하는 18가지 전문화된 슬래시 명령을 제공합니다:

개발 명령 (3개)

• /user:build - 범용 프로젝트 빌더
  • --init 새 프로젝트, --feature 기능 추가, --react React 애플리케이션, --api 백엔드, --tdd 테스트 주도
• /user:dev-setup - 개발 환경 설정
  • --install 도구, --ci CI/CD, --monitor 모니터링
• /user:test - 테스트 프레임워크
  • --coverage 커버리지, --watch 감시 모드, --e2e 엔드투엔드 테스트

분석 및 개선 명령 (4개)

• /user:analyze - 다차원 분석
  • --code 코드 검토, --architecture 설계, --profile 성능, --security 취약점
• /user:troubleshoot - 디버깅 및 수정
  • --investigate 탐색, --fix 수정, --five-whys 근본 원인, --prod 프로덕션 환경
• /user:improve - 코드/성능 향상
  • --quality 리팩토링, --performance 최적화, --iterate 지속적 개선, --threshold 목표 백분율
• /user:explain - 심층 설명
  • --depth 복잡도, --visual 다이어그램, --examples 코드 예시

운영 명령 (6개)

• /user:deploy - 애플리케이션 배포
• /user:migrate - 데이터베이스/코드 마이그레이션
• /user:scan - 보안 및 검증
• /user:estimate - 시간/복잡도 예측
• /user:cleanup - 프로젝트 유지보수
• /user:git - Git 워크플로우 관리

설계 및 아키텍처 명령 (1개)

• /user:design - 시스템 설계
  • --api REST, --ddd 도메인 주도 설계, --prd 요구사항, --openapi 사양, --graphql GraphQL

워크플로우 명령 (2개)

• /user:spawn - 전문화된 하위 에이전트 생성
• /user:document - 문서 생성

시스템 명령 (1개)

• /user:load - 프로젝트 컨텍스트 로드

🔧 MCP (모델 컨텍스트 프로토콜) 통합

SuperClaude는 네 가지 강력한 MCP 서버를 통합합니다:

1. Context7 (C7) - 자동 문서 조회

   • 라이브러리 문서 즉시 조회
   • GitHub 워크플로우와 원활하게 통합

2. Sequential - 복잡한 분석

   • 심층 문제에 대한 순차적 사고
   • 시스템 설계 및 근본 원인 분석에 적합

3. Magic - UI 생성

   • React 컴포넌트 자동 생성
   • 지능형 UI 구축

4. Puppeteer - 브라우저 테스트

   • UI 컴포넌트 검증
   • 성능 모니터링

🚀 핵심 장점

토큰 최적화

• UltraCompressed 모드: 70% 토큰 감소
• 전보 스타일 단순화 사용: 관사/접속사/전치사 제거
• 기호화: →(로), &(및), @(에서), w/(와 함께), +(추가), -(제거)
• 약어: cfg(구성), fn(함수), impl(구현)

연구 우선 접근 방식

• 공식 문서 자동 조회
• 증거 기반 의사결정
• 참조 기반 구현

적응형 사고

• 작업에 따라 분석 깊이 조정
• 지능형 도구 선택
• 컨텍스트 인식 응답

설치 및 구성

자동 설치

git clone https://github.com/NomenAK/SuperClaude.git
cd SuperClaude
./install.sh

수동 설치

# 1. 구조 생성
mkdir -p ~/.claude/commands/shared

# 2. 구성 파일 복사
cp CLAUDE.md RULES.md PERSONAS.md MCP.md ~/.claude/

# 3. 명령 복사
cp .claude/commands/*.md ~/.claude/commands/

# 4. 공유 리소스 복사
cp .claude/commands/shared/*.yml ~/.claude/commands/shared/

설치 확인

# 설치 확인
ls -la ~/.claude/ # 4개의 주요 파일이 표시되어야 함
ls -la ~/.claude/commands/ # 17개의 파일(16개 명령 + 인덱스)이 표시되어야 함

# 사용 테스트
# Claude Code에서 아무 프로젝트나 열고 다음을 시도:
/user:analyze --code
/persona:architect

프로젝트 구조

~/.claude/
├── CLAUDE.md          # 주 구성 (다른 파일 로드)
├── RULES.md           # 거버넌스 및 관행
├── PERSONAS.md        # 9가지 인지 원형
├── MCP.md             # 모델 컨텍스트 프로토콜 패턴
└── commands/          # 17가지 전문화된 슬래시 명령 + 인덱스
    ├── analyze.md
    ├── build.md
    ├── cleanup.md
    ├── deploy.md
    ├── design.md
    ├── dev-setup.md
    ├── document.md
    ├── estimate.md
    ├── explain.md
    ├── git.md
    ├── improve.md
    ├── index.md
    ├── load.md
    ├── migrate.md
    ├── scan.md
    ├── spawn.md
    ├── test.md
    ├── troubleshoot.md
    └── shared/        # 19가지 구성 리소스
        ├── ambiguity-check.yml
        ├── audit.yml
        ├── checkpoint.yml
        ├── cleanup-patterns.yml
        ├── command-memory.yml
        ├── documentation-dirs.yml
        ├── evidence.yml
        ├── git-operations.yml
        ├── git-workflow.yml
        ├── impl.yml
        ├── loading-cfg.yml
        ├── mcp-flags.yml
        ├── patterns.yml
        ├── performance-monitoring.yml
        ├── planning-mode.yml
        ├── research-first.yml
        ├── thinking-modes.yml
        ├── ultracompressed.yml
        └── validation.yml

사용 예시

일반 플래그

모든 명령이 지원하는 일반 플래그:

계획 및 사고

• --plan - 실행 전 실행 계획 표시
• --think - 표준 분석 모드 (다중 파일 컨텍스트)
• --think-hard - 심층 분석 모드 (아키텍처 수준)
• --ultrathink - 중요 분석 모드 (시스템 수준)

문서 제어

• --ultracompressed / --uc - ~70% 토큰 감소 모드

MCP 서버 제어

• --c7 / --no-c7 - Context7 문서 활성화/비활성화
• --seq / --no-seq - Sequential 사고 활성화/비활성화
• --magic / --no-magic - Magic UI 빌더 활성화/비활성화
• --pup / --no-pup - Puppeteer 브라우저 활성화/비활성화
• --all-mcp - 모든 MCP 서버 활성화
• --no-mcp - 모든 MCP 서버 비활성화 (네이티브 도구만)

워크플로우 예시

전체 개발 프로세스

/persona:architect → /user:load --depth deep → /user:analyze --architecture
/user:design --api --ddd → /user:estimate --detailed
/persona:backend → /user:build --api
/persona:frontend → /user:build --react → /user:test --coverage
/persona:security → /user:scan --security → /user:improve --quality
/user:cleanup --all → /user:deploy --env staging

디버깅 워크플로우

/persona:analyzer → /user:troubleshoot --investigate --prod → /user:analyze --profile
"think hard about performance bottlenecks" → /user:troubleshoot --five-whys
/persona:performance → /user:improve --performance --iterate --threshold 90%

테스트 및 품질 보증

/persona:qa → /user:test --e2e → /user:scan --validate
/persona:mentor → /user:explain --depth beginner --visual --examples
/user:document --user → /user:build --tdd → /user:analyze --code

문서 구성

운영 문서 vs 프로젝트 문서

SuperClaude는 운영 보고서와 프로젝트 문서를 자동으로 분리합니다:

.claudedocs/           # Claude 운영 문서
├── audit/
├── reports/
├── summaries/
├── metrics/
└── incidents/

/docs                  # 프로젝트 문서
├── api/
├── guides/
├── architecture/
└── development/

자동 보고

• analyze → reports/
• scan → reports/
• test → metrics/
• troubleshoot → incidents/

수동 문서

• /user:document → API → /docs/api/
• 가이드 → /docs/guides/

고급 기능

모델 적응

• 간단한 작업 → sonnet (비용 효율성)
• 복잡한 작업 → sonnet-4 (균형)
• 중요한 작업 → opus-4 (최대 능력)

편의 명령

• /compact - 지능형 축소
• /clear - 새로 시작
• /model - 모델 전환

체크포인트 시스템

Git 통합 체크포인트 시스템을 통해 개발자는 워크플로우의 어느 지점으로든 되돌아갈 수 있습니다:

/user:git --checkpoint before-refactor
/user:git --rollback

문제 해결

일반적인 문제

1. 명령이 작동하지 않음: ls ~/.claude/commands/ 확인 (17개 파일이 표시되어야 함)
2. 계획 문제: --plan 플래그 추가 → /user:deploy --plan
3. 역할 문제: /persona:architect → /persona:security → /user:scan --security
4. MCP 문제: "React docs" → C7 | "slow app" → Sequential

유지보수 명령

• 업데이트: cd SuperClaude && git pull && ./install.sh
• 백업: cp -r ~/.claude/ ~/.claude.backup.$(date +%Y%m%d)
• 제거: rm -rf ~/.claude/

프로젝트 장점

개발자 장점

• ✅ 모든 프로젝트에 일관된 워크플로우
• ✅ 연구 우선 접근 방식 → 항상 공식 문서 조회
• ✅ 품질 표준 → 내장된 모범 사례
• ✅ 인지 전문화 → 각 작업에 적합한 사고방식

적용 시나리오

• 개발자 → 더 빠르고 스마트한 코딩 워크플로우
• 팀 → 일관된 AI 지원 패턴
• 프로젝트 → 품질 중심 개발
• 학습 → AI 주도 기술 개발

기술적 특징

기호 시스템

SuperClaude는 효율성을 높이기 위해 고유한 기호 시스템을 사용합니다:

기호	의미	약어	의미
→	결과	cfg	구성
&	그리고/와	fn	함수
w/	~와 함께	impl	구현
@	~에서/위치	env	환경
+	추가/포함	dev	개발
-	제거/제외	auth	인증
∀	모든/각각에 대해	API	애플리케이션 프로그래밍 인터페이스

버전 정보

• 현재 버전: v4.0.0
• 유형: 구성 프레임워크 (실행 가능한 코드 아님)
• 호환성: Claude Code
• 설치 위치: ~/.claude/ (전역 설치)

요약

SuperClaude는 Claude Code를 일반적인 AI 비서에서 전문화된 개발 파트너로 전환시키며 다음을 제공합니다:

• 전문화된 인지 역할 시스템
• 포괄적인 명령 도구 세트
• 지능형 MCP 통합
• 효율적인 토큰 최적화
• 연구 주도 방법론

이 프레임워크는 일관되고 고품질의 AI 지원 개발 경험이 필요한 개발자와 팀에 특히 적합합니다. 모듈식 설계와 전문화된 접근 방식을 통해 SuperClaude는 모든 개발 작업에 적절한 전문 지식과 도구 지원을 보장합니다.