Claude Code를 구조화된 개발 플랫폼으로 변환하는 메타 프로그래밍 프레임워크
터미널에서 아래 명령어를 실행하세요:
pipx install superclaude
superclaude install
superclaude doctor
python3 --version으로 확인하세요.
SuperClaude는 키워드 기반으로 전문 에이전트를 자동 활성화합니다:
| 에이전트 | 전문 분야 | 자동 활성화 키워드 |
|---|---|---|
| 🏢 system-architect | 대규모 분산 시스템, 마이크로서비스 | architecture, microservices, scalability |
| ⚙️ backend-architect | API 설계, 데이터베이스 최적화 | API, backend, REST, GraphQL |
| 🎨 frontend-architect | 웹 앱, 접근성, UX | UI, frontend, React, Vue, component |
| 🚀 devops-architect | CI/CD, 인프라 자동화 | deploy, Docker, Kubernetes, pipeline |
| 에이전트 | 전문 분야 | 자동 활성화 키워드 |
|---|---|---|
| 🔒 security-engineer | 보안 위협 모델링, 취약점 분석 | security, auth, OWASP, encryption |
| ⚡ performance-engineer | 성능 최적화, 병목 분석 | performance, slow, bottleneck, latency |
| 🔍 root-cause-analyst | 문제 진단, 디버깅 | bug, debugging, troubleshoot, error |
| ✅ quality-engineer | 테스트 전략, 자동화 | test, QA, validation, coverage |
| 🔧 refactoring-expert | 코드 품질, 기술 부채 | refactor, SOLID, maintainability |
| 에이전트 | 전문 분야 | 자동 활성화 키워드 |
|---|---|---|
| 🐍 python-expert | Python, Django, FastAPI | Python, Django, FastAPI, asyncio |
| 🔬 deep-research-agent | 웹 리서치, 정보 수집 | research, investigate, discover |
| 📝 requirements-analyst | 요구사항 분석, PRD | requirements, PRD, user story |
| 📚 technical-writer | 기술 문서 작성 | documentation, readme, API docs |
| 🎓 learning-guide | 교육, 튜토리얼 | explain, learn, tutorial, beginner |
@agent-[name]으로 직접 지정 가능. 예: @agent-security-engineer
| 모드 | 용도 | 자동 활성화 | 수동 플래그 |
|---|---|---|---|
| 🧠 Brainstorming | 아이디어 발굴, 요구사항 탐색 | 모호한 요청, "maybe", "could we" | --brainstorm |
| 🔍 Introspection | 추론 과정 노출, 디버깅 | 에러 복구, 복잡한 문제 | --introspect |
| 🔬 Deep Research | 체계적 정보 수집 | /sc:research, 리서치 키워드 | --research |
| 📋 Task Management | 복잡한 작업 조율 | 3단계 이상, 다중 파일 | --task-manage |
| 🎯 Orchestration | 도구 최적화, 병렬 실행 | 다중 도구 작업 | --orchestrate |
| ⚡ Token Efficiency | 토큰 30-50% 절감 | 컨텍스트 75% 이상 | --uc |
| ⚙️ Standard | 일반 개발 작업 | 기본값 | - |
# 전략 평가 /sc:business-panel "신규 SaaS 서비스 시장 진입 전략" --mode discussion # 경쟁 분석 /sc:business-panel "경쟁사 대비 차별화 전략" --mode debate # 혁신 평가 /sc:business-panel "AI 기반 신기능 도입" --mode socratic
9명의 경영 전문가(Porter, Drucker, Christensen 등)가 다각도로 분석합니다.
# 요구사항 검토 /sc:spec-panel @docs/prd.md --focus requirements # 아키텍처 검토 /sc:spec-panel "마이크로서비스 전환 계획" --focus architecture # 테스트 전략 검토 /sc:spec-panel @test-plan.md --focus testing
10명의 소프트웨어 전문가(Fowler, Newman, Wiegers 등)가 스펙을 리뷰합니다.
SuperClaude는 8개의 MCP 서버와 통합됩니다:
| 서버 | 용도 | Nexol 호스팅 |
|---|---|---|
| Tavily | 웹 검색 | - |
| Context7 | 문서 검색 | ✅ |
| Sequential-Thinking | 단계적 추론 | ✅ |
| Serena | 코드 분석 | ✅ |
| Playwright | 브라우저 자동화 | ✅ |
| Magic | UI 컴포넌트 | - |
| Morphllm | 코드 수정 | - |
| Chrome DevTools | 성능 분석 | - |
nexol-mcp 등록만 하면 됩니다.
# 기본 리서치 /sc:research "Next.js 14 App Router 베스트 프랙티스" # 깊이 옵션 지정 /sc:research "React 상태관리 비교" --depth deep # 전략 지정 (planning, intent, unified) /sc:research "Docker 보안" --depth exhaustive --strategy unified
6단계 워크플로우로 체계적 정보 수집. 결과는 docs/research/[topic]_[timestamp].md에 저장됩니다.
# 빠른 품질 분석 /sc:analyze --focus quality # 심층 보안 분석 /sc:analyze src/ --focus security --think-hard # 전체 아키텍처 분석 (최대 깊이) /sc:analyze . --focus architecture --ultrathink --safe-mode # Sequential Thinking과 함께 분석 /sc:analyze api/ --focus performance --seq
코드 품질, 보안, 성능, 아키텍처 관점에서 종합 분석합니다.
# 특정 파일 설명 /sc:explain src/utils/auth.ts # 복잡한 알고리즘 설명 /sc:explain "이 정렬 알고리즘이 어떻게 동작하는지" # 아키텍처 설명 /sc:explain "이 프로젝트의 전체 구조"
코드, 개념, 시스템 동작을 명확하게 설명합니다.
# 아키텍처 설계 /sc:design user-management --type architecture # API 설계 /sc:design payment-api --type api --format spec # 데이터베이스 설계 /sc:design e-commerce --type database --format diagram # 컴포넌트 설계 /sc:design notification-service --type component
아키텍처, API, DB 스키마, 컴포넌트 인터페이스를 설계합니다.
# 기능 아이디어 도출 /sc:brainstorm "사용자 참여를 높일 수 있는 기능" # 기술 솔루션 탐색 /sc:brainstorm "대용량 파일 업로드 처리 방법" # 문제 해결 아이디어 /sc:brainstorm "API 응답 속도 개선 방안"
소크라테스식 대화를 통해 요구사항을 발굴하고 아이디어를 체계화합니다.
# PRD에서 워크플로우 생성 /sc:workflow docs/prd.md # 기능 요구사항에서 작업 분해 /sc:workflow "사용자 인증 시스템 구현"
PRD나 요구사항에서 구조화된 구현 워크플로우를 생성합니다.
# 백엔드 기능 구현 /sc:implement "JWT 기반 인증 시스템" --type backend --focus security # 프론트엔드 + Magic UI /sc:implement "대시보드 컴포넌트" --type frontend --magic --c7 # 풀스택 + 문서 참조 /sc:implement "사용자 CRUD REST API" --type fullstack --c7
15개 전문 에이전트가 분야별로 협력하여 구현합니다.
# 안전한 리팩토링 (미리보기) /sc:improve src/services/ --type quality --safe --preview # 성능 최적화 (반복 개선) /sc:improve api/handlers/ --type performance --loop # 보안 강화 /sc:improve auth/ --type security --validate # 코드 정리 (인터랙티브) /sc:cleanup src/ --type all --safe --interactive
코드 품질, 성능, 유지보수성을 체계적으로 개선합니다.
# 프로젝트 빌드 /sc:build # 프로덕션 빌드 /sc:build --production # 빌드 오류 자동 수정 /sc:build --fix-errors
빌드 과정을 관리하고 오류를 자동으로 처리합니다.
# 전체 테스트 + 커버리지 /sc:test --coverage # 유닛 테스트만 /sc:test --type unit # E2E 테스트 (Playwright 연동) /sc:test --type e2e --play # 워치 모드 + 자동 수정 /sc:test --watch --fix
테스트 실행, 커버리지 분석, 품질 리포트를 자동화합니다.
# 빌드 오류 (트레이스 포함) /sc:troubleshoot "npm run build 실패" --type build --trace # 런타임 버그 (자동 수정) /sc:troubleshoot "TypeError: Cannot read property" --type bug --fix # 성능 문제 (Sequential Thinking) /sc:troubleshoot "API 응답이 느림" --type performance --seq # 배포 문제 /sc:troubleshoot "Docker 컨테이너 실패" --type deployment --trace
코드, 빌드, 배포, 시스템 문제를 진단하고 해결합니다.
# PM 모드 시작 /sc:pm # 작업 분배 /sc:pm "이번 스프린트 작업 분배해줘" # 진행 상황 체크 /sc:pm "현재 진행 상황 정리해줘"
PM 에이전트가 전체 워크플로우를 조율하고 서브 에이전트를 관리합니다.
# 복잡한 작업 실행 /sc:task "로그인 시스템 전체 구현" # 작업 위임 /sc:spawn "API 문서화" "테스트 작성" "코드 리뷰"
복잡한 작업을 분해하고 병렬로 처리합니다.
# 기능 개발 시간 예측 /sc:estimate "사용자 대시보드 구현" # 프로젝트 전체 예측 /sc:estimate --scope project
작업, 기능, 프로젝트의 개발 예상 시간을 분석합니다.
# 스마트 커밋 /sc:git commit # 변경사항 요약 커밋 /sc:git commit "로그인 기능 구현" # PR 생성 /sc:git pr # 브랜치 관리 /sc:git branch feature/auth
지능형 커밋 메시지 생성과 Git 워크플로우를 최적화합니다.
# API 문서 생성 /sc:document api/ # 컴포넌트 문서 /sc:document src/components/Button.tsx # README 생성 /sc:document --type readme
컴포넌트, 함수, API에 대한 문서를 자동 생성합니다.
# 프로젝트 구조 인덱싱 /sc:index-repo # 지식 베이스 생성 /sc:index
프로젝트를 분석하여 94% 토큰 절감된 인덱스를 생성합니다.
# 세션 저장 (체크포인트) /sc:save "feature-auth-complete" # 이전 세션 로드 /sc:load "feature-auth-complete" # 작업 완료 검증 /sc:reflect --type completion --validate # 작업 회고 /sc:reflect --type task --analyze
세션 컨텍스트를 저장/로드하고 작업 완료를 검증합니다.
# 최적 도구 선택 /sc:select-tool "대규모 코드베이스 분석" # 명령어 추천 /sc:recommend "로그인 기능 구현하고 싶어" # 전체 명령어 검색 /sc:index "security"
상황에 맞는 최적의 도구와 명령어를 추천받습니다.
# 1. 요구사항 브레인스토밍 /sc:brainstorm "쇼핑몰 MVP 기능 정의" # 2. 기술 리서치 /sc:research "Next.js 14 + Prisma + PostgreSQL 스택" # 3. 아키텍처 설계 /sc:design shopping-mall --type architecture # 4. 워크플로우 생성 /sc:workflow "쇼핑몰 MVP 구현" # 5. 구현 시작 /sc:implement "상품 목록 페이지"
# 1. 현재 상태 분석 /sc:analyze --type architecture # 2. 문제점 파악 /sc:analyze --type quality src/legacy/ # 3. 리팩토링 계획 /sc:design refactoring-plan --type architecture # 4. 단계별 개선 /sc:improve src/legacy/ --type refactor # 5. 테스트 확인 /sc:test --coverage
# 1. 문제 진단 /sc:troubleshoot "결제 처리 중 오류 발생" # 2. 관련 코드 분석 /sc:analyze src/payment/ --type security # 3. 수정 구현 /sc:implement "결제 오류 핸들링 개선" # 4. 테스트 작성 /sc:test src/payment/ # 5. 커밋 /sc:git commit "fix: 결제 오류 핸들링 개선"