SuperClaude 사용자 가이드 🚀

https://github.com/SuperClaude-Org/SuperClaude_Framework

🎯 간단한 진실

복잡해 보이는 외관 뒤에, SuperClaude는 실제로 사용하기 간단합니다.

모든 명령어, 플래그, 페르소나를 배울 필요가 없습니다. 그냥 사용해보세요! 🎈

SuperClaude는 당신이 필요한 것을 파악하려고 시도하는 지능형 라우팅 시스템을 가지고 있습니다:

• /analyze some-code/ 입력 → 적절한 분석 도구를 선택합니다

• 보안에 대해 질문 → 보안 전문가가 자동으로 활성화됩니다

• 프론트엔드 작업 → UI 전문가가 담당합니다

• 무언가를 디버그 → 조사 모드가 시작됩니다

사용하면서 학습이 이루어집니다 - 먼저 매뉴얼을 공부하지 않고도 자연스럽게 무엇이 효과적인지 발견하게 됩니다.

아래의 자세한 가이드들? 방금 일어난 일을 이해하고 싶거나 더 깊이 파고들고 싶을 때 여기 있습니다. 하지만 솔직히? 대부분의 경우 그냥 즉흥적으로 해도 됩니다. 😊

요약: 설치하고, 코드에 /analyze 또는 /build를 시도해보고, 마법이 일어나는 것을 지켜보세요.

🚀 여기서 바로 시작하세요

읽기를 건너뛰고 바로 시작하고 싶으신가요? 2분 시작 가이드입니다:

# Claude Code에서 이 명령어들을 시도해보세요:
/sc:help                    # 사용 가능한 기능 보기
/sc:analyze README.md       # SuperClaude가 프로젝트를 분석합니다
/sc:workflow feature-prd.md # PRD에서 구현 워크플로우 생성 (새로운 기능!)
/sc:implement user-auth     # 기능과 컴포넌트 생성 (v3의 새로운 기능!)
/sc:build                   # 자동 최적화가 포함된 스마트 빌드
/sc:improve messy-file.js   # 코드를 자동으로 정리합니다

방금 무슨 일이 일어났나요? SuperClaude가 자동으로:

• 각 작업에 적합한 도구를 선택했습니다 🛠️

• 적절한 전문가들(보안, 성능 등)을 활성화했습니다 🎭

• 지능적인 플래그와 최적화를 적용했습니다 ⚡

• 증거 기반 제안을 제공했습니다 📊

얼마나 쉬웠는지 보셨나요? 공부할 필요 없이 - SuperClaude가 복잡성을 파악해서 당신이 할 필요가 없게 만듭니다.

어떻게 작동하는지 이해하고 싶으신가요? 계속 읽어보세요. 그냥 계속 실험하고 싶으신가요? 해보세요! 🎯

환영 및 개요 👋

SuperClaude는 실제로 무엇인가요? 🤔

SuperClaude는 개발 작업을 위해 Claude Code를 더 스마트하게 만듭니다. 일반적인 응답 대신, 자신의 분야를 아는 다양한 전문가들(보안, 성능, 프론트엔드 등)로부터 전문적인 도움을 받습니다.

솔직한 진실: 우리는 방금 v3.0을 출시했고 베타에서 갓 나왔습니다. 하는 일에 대해서는 꽤 잘 작동하지만, 계속 개선해나가면서 거친 부분들이 있을 것으로 예상해야 합니다. 우리가 이것을 만든 이유는 Claude Code가 실제 소프트웨어 개발 워크플로우에 더 도움이 되기를 원했기 때문입니다.

멋진 부분? 이 복잡성을 관리할 필요가 없습니다. 그냥 /analyze나 /build 같은 일반적인 명령어를 사용하면 SuperClaude가 보통 어떤 전문가를 참여시키고 어떤 도구를 사용할지 알아냅니다. 🪄

SuperClaude가 추가하는 것들 ✨

🛠️ 17개의 전문 명령어

• 계획 도구: /workflow (새로운 기능!), /estimate, /task

• 개발 도구: /implement, /build, /design

• 분석 도구: /analyze, /troubleshoot, /explain

• 품질 도구: /improve, /cleanup, /test

• 문서화, git, 배포 등을 위한 유틸리티들

• 그냥 사용하면 됩니다 - SuperClaude가 복잡성을 자동으로 처리합니다

• 새로운 기능: PRD-to-구현 계획을 위한 /workflow 명령어

• 새로운 기능: 기능 생성을 위한 /implement 명령어 (v2 기능 복원)

🎭 11개의 스마트 페르소나 (언제 도움을 줄지 아는)

• 다양한 도메인에 대해 행동을 적응시키는 AI 전문가들

• 요청에 따라 자동 활성화 (보안 작업에는 보안 전문가 등)

• 수동 제어 가능하지만, 보통 필요하지 않음

• 언제 도움을 줄지 아는 전체 개발팀을 갖는 것으로 생각하세요

🔧 MCP 서버 통합 (스마트 외부 도구)

• Context7: 공식 라이브러리 문서 검색

• Sequential: 복잡한 다단계 분석

• Magic: 현대적인 UI 컴포넌트 생성

• Playwright: 브라우저 자동화 및 테스팅

• 필요할 때 자동 연결 - 이런 것들을 관리할 필요 없음

📋 향상된 작업 관리 (뒤에서 일어남)

• TodoRead/TodoWrite로 진행 상황 추적

• /task로 다중 세션 프로젝트 관리

• /spawn으로 복잡한 오케스트레이션

• /loop로 반복적 개선

• 대부분 자동 - SuperClaude가 당신이 하는 일을 추적합니다

⚡ 토큰 최적화 (스마트 효율성)

• 컨텍스트가 가득 찰 때 스마트 압축

• 효율적인 소통을 위한 기호 시스템

• 대규모 작업을 위한 성능 최적화

• 보통 필요할 때 활성화 대규모 프로젝트에서

현재 상태 (v3.0) 📊

✅ 잘 작동하는 것들:

• 설치 시스템 (완전히 다시 작성됨, 훨씬 더 안정적)

• 16개 명령어와 11개 페르소나를 가진 핵심 프레임워크

• MCP 서버 통합 (대부분 작동)

• 기본 작업 관리 및 워크플로우 자동화

• 문서화 및 사용자 가이드

⚠️ 아직 거친 부분들:

• 이것은 초기 릴리스입니다 - 버그가 예상됩니다

• 일부 MCP 통합이 더 부드러울 수 있습니다

• 모든 작업에 대해 성능이 아직 최적화되지 않았습니다

• 일부 고급 기능들은 실험적입니다

❌ 제거한 것들:

• 훅 시스템 (너무 복잡해져서, v4에서 다시 돌아올 예정)

우리는 v3를 기반으로 꽤 만족하지만, 확실히 개선의 여지가 있습니다.

어떻게 작동하나요 🔄

간단한 버전: /analyze auth.js 같은 것을 입력하면 SuperClaude가 나머지를 알아냅니다.

조금 더 자세한 버전:

1.스마트 라우팅 - 당신이 요청하는 것을 분석합니다

2.자동 전문가 선택 - 적절한 전문가를 선택합니다 (보안, 성능 등)

3.도구 조정 - 도움이 될 때 외부 시스템에 연결합니다

4.품질 보증 - 제안이 견고한지 확인합니다

이 복잡성을 볼 필요가 없습니다 - 그냥 Claude가 개발 관련 일에 훨씬 더 스마트해진 것처럼 느껴집니다.

좋은 점은 이 대부분이 보통 자동으로 일어난다는 것입니다. 요청을 하면, SuperClaude가 좋은 접근법을 알아내려고 시도하고, 적절한 도구와 전문성으로 실행합니다. 보통 구성이나 설정이 필요 없이 - 그냥 더 나은 결과를 바랄 뿐입니다. ✨

빠른 기능 개요 🎯

기억하세요: 이 가이드들을 읽지 않고도 SuperClaude를 효과적으로 사용할 수 있습니다. 어떻게 작동하는지 궁금할 때 여기 있습니다! 🎪

핵심 구성요소 🧩

SuperClaude는 함께 작동하는 여러 상호 연결된 시스템으로 구축되었습니다. 각 구성요소가 더 큰 그림에 어떻게 맞는지 설명합니다.

Commands: 당신의 도구상자 🛠️

Commands는 특정 유형의 개발 작업을 처리하는 전문 도구입니다. 일반적인 "이것 좀 도와주세요" 대신, 다양한 시나리오를 위해 특별히 제작된 도구를 얻습니다.

목적별로 구성된 15개 Commands:

Development 🔨

• /build - 프로젝트 빌드, 컴파일, 번들링

• /design - 시스템 아키텍처 및 컴포넌트 설계

Analysis 🔍

• /analyze - 포괄적인 코드 및 시스템 분석

• /troubleshoot - 문제 조사 및 디버깅

• /explain - 교육적 설명 및 학습

Quality ✨

• /improve - 코드 향상 및 최적화

• /cleanup - 기술 부채 감소

• /test - 테스팅 및 커버리지 분석

Utilities 🔧

• /document - 문서 생성

• /git - 향상된 git 워크플로우

• /load - 프로젝트 컨텍스트 로딩

• /estimate - 프로젝트 추정

• /task - 장기 프로젝트 관리

• /spawn - 복잡한 작업 오케스트레이션

• /index - 명령어 탐색 및 도움말

Flags: 행동 수정자 🏁

Flags는 SuperClaude가 요청을 처리하는 방식을 변경합니다. 행동을 수정하거나, 기능을 추가하거나, 출력 스타일을 변경하는 명령줄 옵션과 같습니다.

주요 Flag 카테고리:

Planning & Analysis 🧠

• --think / --think-hard/ --ultrathink - 사고 깊이 제어

• --plan - 실행 전 실행 계획 표시

Efficiency & Control ⚡

• --uc - 대규모 작업을 위한 초압축 출력

• --safe-mode - 검증이 포함된 보수적 실행

• --validate - 작업 전 위험 평가

MCP Server Control 🔧

• --c7 - 문서화를 위한 Context7 활성화

• --seq - 복잡한 분석을 위한 Sequential 활성화

• --magic - UI 컴포넌트를 위한 Magic 활성화

• --play - 테스팅을 위한 Playwright 활성화

Advanced Orchestration 🎭

• --delegate - 병렬 처리를 위한 서브 에이전트 위임 활성화

• --wave-mode - 복합 지능을 가진 다단계 실행

• --loop - 반복적 개선 모드

Focus & Scope 🎯

• --focus security - 특정 도메인에 집중

• --scope project - 분석 범위 설정

• --persona-[name] - 특정 페르소나 활성화

Flags는 종종 컨텍스트에 따라 자동 활성화됩니다. 예를 들어, 보안 관련 요청은 보통 --persona-security와 --focus security를 받습니다. 포괄적인 세부사항과 패턴은 Flags Guide를 참조하세요.

Personas: AI 전문가들 🎭

Personas는 필요에 따라 사용할 수 있는 전문가 팀을 갖는 것과 같습니다. 각각은 다른 전문성, 우선순위, 문제 접근법을 가져옵니다.

도메인별로 구성된 11개 Personas:

Technical Specialists 🔧

• 🏗️ architect - 시스템 설계, 장기 아키텍처

• 🎨 frontend - UI/UX, 접근성, 프론트엔드 성능

• ⚙️ backend - API, 데이터베이스, 신뢰성

• 🛡️ security - 위협 모델링, 취약점

• ⚡ performance - 최적화, 병목 현상 제거

Process & Quality ✨

• 🔍 analyzer - 근본 원인 분석, 조사

• 🧪 qa - 테스팅, 품질 보증

• 🔄 refactorer - 코드 품질, 기술 부채

• 🚀 devops - 인프라, 배포

Knowledge & Communication 📚

• 👨‍🏫 mentor - 교육, 지식 전수

• ✍️ scribe - 문서화, 기술 작성

Personas는 보통 요청 패턴에 따라 자동 활성화되지만 --persona-[name] 플래그로 재정의할 수 있습니다. 각각은 다른 우선순위를 가집니다 (예: 보안 페르소나는 속도보다 보안을 우선시). 자세한 설명과 예제는 Personas Guide를 참조하세요.

MCP Servers: 외부 기능 🔧

MCP (Model Context Protocol) 서버는 Claude의 기본 능력을 넘어서는 전문 기능을 제공합니다.

4개의 통합 서버:

Context7 📚

• 목적: 공식 라이브러리 문서 및 모범 사례

• 언제 활성화되는가: 프레임워크 질문, 외부 라이브러리 사용

• 제공하는 것: 최신 문서, 코드 예제, 패턴

• 예제: /build react-app --c7는 React 모범 사례를 가져옵니다

Sequential 🧠

• 목적: 복잡한 다단계 분석 및 체계적 사고

• 언제 활성화되는가: 디버깅, 시스템 설계, --think 플래그

• 제공하는 것: 구조화된 문제 해결, 가설 테스팅

• 예제: /troubleshoot "auth randomly fails" --seq

Magic ✨

• 목적: 현대적인 UI 컴포넌트 생성 및 디자인 시스템

• 언제 활성화되는가: UI 컴포넌트 요청, 프론트엔드 작업

• 제공하는 것: React/Vue/Angular 컴포넌트, 디자인 패턴

• 예제: /build dashboard --magic는 현대적인 UI 컴포넌트를 생성합니다

Playwright 🎭

• 목적: 브라우저 자동화, E2E 테스팅, 성능 모니터링

• 언제 활성화되는가: 테스팅 워크플로우, 성능 분석

• 제공하는 것: 크로스 브라우저 테스팅, 시각적 검증, 메트릭

• 예제: /test e2e --play는 포괄적인 브라우저 테스트를 실행합니다

MCP 서버는 보통 자동으로 조정되지만 --all-mcp, --no-mcp 또는 --c7 같은 특정 플래그로 제어할 수 있습니다.

구성요소들이 함께 작동하는 방법 🤝

구성요소들이 조정될 때가 멋진 부분입니다:

예제: 보안 분석 요청

/sc:analyze auth-system/ --focus security

보통 일어나는 일:

1.Command: /analyze가 코드 분석을 처리합니다

2.Flag: --focus security가 주의를 집중시킵니다

3.Persona: 🛡️ 보안 전문가가 자동 활성화됩니다

4.MCP: Sequential이 체계적 분석을 제공합니다

5.Orchestrator: 최적 실행을 위해 모든 것을 라우팅합니다

결과: 위협 모델링 관점, 체계적 방법론, 포괄적 커버리지를 가진 보안 중심 분석.

이 조정은 대부분의 요청에서 보통 일어납니다 - SuperClaude가 당신의 특정 요구에 맞는 도구와 전문성의 좋은 조합을 알아내려고 시도합니다.

세 가지 운영 모드 🎭

SuperClaude는 개발 워크플로우의 다양한 측면을 최적화하는 세 가지 구별되는 모드로 작동합니다. 이 모드들을 이해하면 프레임워크를 최대한 활용하는 데 도움이 됩니다.

작업 관리 모드 📋

무엇인가: 진행 상황 추적 및 검증이 포함된 구조화된 워크플로우 실행.

언제 사용되는가: 추적과 조정이 필요한 모든 다단계 작업.

어떻게 작동하는가: SuperClaude가 작업을 관리 가능한 작업으로 나누고, 진행 상황을 추적하며, 검증 게이트를 통해 품질을 보장합니다.

작업 관리의 네 가지 계층

계층 1: 세션 작업 (TodoRead/TodoWrite)

• 범위: 현재 Claude Code 세션

• 용량: 세션당 3-20개 작업

• 상태: pending 📋, in_progress 🔄, completed ✅, blocked 🚧

• 사용법: 즉시 작업을 위한 실시간 진행 상황 추적

# SuperClaude가 보통 세션 작업을 생성하고 관리합니다
/sc:build large-project/
# → 생성: "프로젝트 구조 분석", "빌드 프로세스 실행", "출력 검증"

계층 2: 프로젝트 작업 (/task 명령어)

• 범위: 다중 세션 기능 (며칠에서 몇 주)

• 구조: 계층적 (Epic → Story → Task)

• 지속성: 세션 간 상태 관리

• 사용법: 장기 기능 개발

/sc:task create "implement user dashboard" --priority high
/sc:task breakdown "payment integration"
/sc:task status  # 현재 프로젝트 작업 확인

계층 3: 복잡한 오케스트레이션 (/spawn 명령어)

• 범위: 복잡한 다중 도메인 작업

• 기능: 병렬/순차 조정, 도구 관리

• 사용법: 여러 도구/시스템이 관련된 작업

/sc:spawn deploy-pipeline --parallel
/sc:spawn setup-dev-environment --monitor

계층 4: 반복적 향상 (/loop 명령어)

• 범위: 점진적 개선 워크플로우

• 기능: 검증이 포함된 반복 사이클

• 사용법: 품질 개선 및 정제

/sc:improve messy-code.js --loop --iterations 3
# → 사이클 간 검증과 함께 반복적으로 코드를 개선합니다

작업 상태 관리

핵심 원칙:

• 증거 기반 진행: 단순한 활동이 아닌 측정 가능한 결과

• 단일 집중 프로토콜: 한 번에 하나의 작업만 in_progress 상태

• 실시간 업데이트: 작업이 진행됨에 따라 즉시 상태 변경

• 품질 게이트: 작업을 완료로 표시하기 전 검증

작업 감지:

• 다단계 작업 (3+ 단계) → 작업 분해 생성

• 키워드: build, implement, create, fix, optimize → 작업 추적 활성화

• 범위 지시자: system, feature, comprehensive → 진행 모니터링 추가

내성 모드 🧠

무엇인가: SuperClaude가 자신의 추론과 의사결정 과정을 검토할 수 있게 하는 메타 인지 분석.

언제 사용되는가: 복잡한 문제 해결, 프레임워크 문제 해결, 학습 순간, 또는 --introspect로 명시적으로 요청할 때.

어떻게 작동하는가: SuperClaude가 일반적인 작업에서 벗어나 사고 패턴, 결정 논리, 행동 순서를 분석합니다.

핵심 기능

추론 분석 🧠

• 논리적 흐름과 결정 근거를 검토합니다

• 사고 연쇄의 일관성을 평가합니다

• 가정과 잠재적 편향을 식별합니다

• 증거에 대한 추론을 검증합니다

행동 순서 검토 🔄

• 도구 선택 효과성을 분석합니다

• 워크플로우 패턴과 효율성을 검토합니다

• 대안적 접근법을 고려합니다

• 최적화 기회를 식별합니다

프레임워크 준수 확인 🔍

• SuperClaude 규칙과 원칙에 대한 행동을 검증합니다

• 표준 패턴에서의 편차를 식별합니다

• 필요할 때 교정 지침을 제공합니다

• 품질 표준이 충족되는지 확인합니다

학습 인식 💡

• 결과에서 통찰을 추출합니다

• 재사용을 위한 성공적인 패턴을 식별합니다

• 개선을 위한 지식 격차를 인식합니다

• 미래 최적화 전략을 제안합니다

분석 마커

내성 모드가 활성화되면 이러한 마커들을 볼 수 있습니다:

• 🧠 Reasoning Analysis - 논리적 흐름과 결정 검토

• 🔄 Action Sequence Review - 워크플로우 효과성 분석

• 🎯 Self-Assessment - 메타 인지 평가

• 📊 Pattern Recognition - 행동 패턴 식별

• 🔍 Framework Compliance - 규칙 준수 확인

• 💡 Retrospective Insight - 결과에서 학습

내성이 활성화되는 때

보통 다음에 활성화됩니다:

• 메타 인지 감독이 필요한 복잡한 다단계 문제

• 결과가 기대와 일치하지 않을 때 오류 복구

• 프레임워크 토론이나 SuperClaude 문제 해결

• 반복적 행동에 대한 패턴 인식 필요

수동 활성화:

/sc:analyze complex-system/ --introspect
/sc:troubleshoot "framework confusion" --introspection

토큰 효율성 모드 ⚡

무엇인가: 품질을 유지하면서 정보 밀도를 최대화하는 지능형 최적화 시스템.

언제 사용되는가: 대규모 작업, 컨텍스트가 한계에 접근할 때, 또는 더 빠른 실행이 필요할 때.

어떻게 작동하는가: 컨텍스트와 페르소나 인식을 기반으로 기호, 약어, 구조적 최적화를 사용한 적응형 압축.

압축 전략

5단계 적응형 압축:

1.최소 (0-40% 사용): 페르소나 최적화된 명확성을 가진 전체 세부사항

2.효율적 (40-70% 사용): 도메인 인식을 가진 균형 잡힌 압축

3.압축됨 (70-85% 사용): 품질 게이트를 가진 공격적 최적화

4.중요 (85-95% 사용): 필수 컨텍스트를 보존하는 최대 압축

5.비상 (95%+ 사용): 정보 검증을 가진 초압축

기호 시스템

핵심 논리 및 흐름:

• → ~로 이어진다, 의미한다 (auth.js:45 → security risk)

• ⇒ ~로 변환된다 (input ⇒ validated_output)

• & 그리고, 결합 (security & performance)

• » 순서, 그 다음 (build » test » deploy)

• ∴ 따라서 (tests fail ∴ code broken)

상태 및 진행:

• ✅ 완료됨, 통과

• ❌ 실패, 오류

• ⚠️ 경고

• 🔄 진행 중

• 🎯 목표, 골

기술 도메인:

• ⚡ 성능

• 🔍 분석

• 🛡️ 보안

• 📦 배포

• 🎨 디자인

활성화 전략

보통 다음에 활성화됩니다:

• 컨텍스트 사용량 >75% → 압축 활성화

• 대규모 작업 → 토큰 오버플로우 방지

• 복잡한 오케스트레이션 → 소통 최적화

수동 활성화:

/sc:analyze huge-codebase/ --uc  # 초압축 모드
/sc:improve legacy-system/ --uc --delegate auto  # 효율적인 대규모 작업

성능 목표 (아직 개선 중!):

• 목표: ~30-50% 토큰 감소

• 품질: ~95%의 정보 보존 시도

• 속도: 보통 <100ms 압축 결정

• 통합: 프레임워크 구성요소와 작동

모드 통합

세 가지 모드는 종종 함께 작동합니다:

/sc:improve large-legacy-system/ --wave-mode auto --uc --introspect

일어나는 일:

•작업 관리: 진행 상황 추적이 포함된 구조화된 개선 계획 생성

•토큰 효율성: 대규모 작업을 위한 출력 압축

•내성: 개선 전략을 분석하고 접근법을 검증

오케스트레이터 시스템 🎯

오케스트레이터는 당신의 요청을 분석하고 도구, 페르소나, 통합의 좋은 조합을 조정하려고 시도하는 SuperClaude의 지능형 라우팅 시스템입니다. 이것이 SuperClaude를 단순한 별도 도구들의 모음이 아닌 스마트하고 반응적으로 느끼게 만드는 것입니다.

오케스트레이터 작동 방식 🔄

스마트 디스패처로 생각하세요:

1.분석 의도와 복잡성을 이해하기 위해 요청을 분석합니다

2.라우팅 명령어, 플래그, 페르소나, MCP 서버의 최적 조합으로 라우팅합니다

3.조정 최적 결과를 위한 실행을 조정합니다

4.검증 품질 게이트를 통해 좋은 결과를 보장합니다

5.최적화 성능과 리소스 사용을 최적화합니다

감지 엔진 🧠

감지 엔진은 여러 렌즈를 통해 모든 요청을 분석합니다:

패턴 인식

복잡성 감지:

• 간단: 단일 파일 작업, 기본 작업 (<3 단계) → 직접 실행

• 보통: 다중 파일 작업, 분석 작업 (3-10 단계) → 표준 라우팅

• 복잡: 시스템 전체 변경, 아키텍처 결정 (>10 단계) → 고급 오케스트레이션

도메인 식별:

• Frontend: "UI", "component", "responsive" 같은 키워드 → 🎨 frontend 페르소나 + Magic MCP

• Backend: "API", "database", "service" 같은 키워드 → ⚙️ backend 페르소나 + Context7 MCP

• Security: "vulnerability", "auth", "compliance" 같은 키워드 → 🛡️ security 페르소나 + Sequential MCP

• Performance: "slow", "optimize", "bottleneck" 같은 키워드 → ⚡ performance 페르소나 + Playwright MCP

작업 유형 분류:

• Analysis: "analyze", "review", "understand" → Sequential MCP + analyzer 페르소나

• Creation: "create", "build", "implement" → Magic MCP (UI인 경우) 또는 Context7 (패턴)

• Modification: "improve", "refactor", "optimize" → 적절한 전문가 페르소나

• Debugging: "troubleshoot", "fix", "debug" → Sequential MCP + analyzer 페르소나

자동 활성화 논리

높은 신뢰도 트리거 (90%+ 활성화):

/sc:analyze auth-system/ --focus security
# → 🛡️ security 페르소나 + Sequential MCP + --validate 플래그

컨텍스트 기반 활성화:

/sc:build react-components/
# → 🎨 frontend 페르소나 + Magic MCP + --c7 플래그 (React 문서)

성능 기반 활성화:

# 컨텍스트 사용량 >75%일 때
/sc:analyze large-project/
# → 압축을 위한 --uc 플래그 자동 추가

라우팅 인텔리전스 🚦

라우팅 시스템은 감지된 패턴을 최적 도구 조합에 매핑하기 위해 동적 결정 트리를 사용합니다.

마스터 라우팅 테이블

지능적 조정

다중 서버 작업:

/sc:design user-dashboard --type api

오케스트레이터가 보통 조정하는 것:

• 🏗️ architect 페르소나 (시스템 설계)

• 🎨 frontend 페르소나 (UI 설계)

• Context7 MCP (프레임워크 패턴)

• Sequential MCP (설계 방법론)

대체 전략:

• Context7 사용 불가 → 문서화를 위한 웹 검색 → 수동 구현

• Sequential 타임아웃 → 네이티브 Claude 분석 → 제한사항 주의

• Magic 실패 → 기본 컴포넌트 생성 → 수동 향상 제안

품질 게이트 및 검증 프레임워크 ✅

SuperClaude는 작업을 위한 8단계 검증 사이클을 구현하려고 시도합니다:

8단계 품질 프로세스

1.구문 검증 - 언어 파서 + Context7 표준

2.타입 검사 - Sequential 분석 + 호환성 검증

3.린팅 - Context7 규칙 + 품질 분석

4.보안 검토 - Sequential 분석 + OWASP 준수

5.테스팅 - Playwright E2E + 커버리지 분석 (좋은 커버리지 목표)

6.성능 - Sequential 분석 + 벤치마킹

7.문서화 - Context7 패턴 + 완성도 검증

8.통합 - Playwright 테스팅 + 배포 검증

검증 자동화

지속적 통합:

• CI/CD 파이프라인 통합

• 조기 실패 감지를 가진 점진적 검증

• 포괄적 메트릭을 가진 증거 생성

지능적 모니터링:

• ML 예측을 가진 성공률 추적

• 역사적 패턴을 기반으로 한 적응형 검증

• 검증 전략의 자동 최적화

성능 최적화 ⚡

오케스트레이터는 여러 전략을 통해 좋은 성능을 위해 최적화하려고 시도합니다:

리소스 관리

토큰 할당:

• 감지 엔진: 패턴 분석을 위한 1-2K 토큰

• 결정 트리: 라우팅 논리를 위한 500-1K 토큰

• MCP 조정: 활성화된 서버에 따라 가변

• 예비: 예상치 못한 복잡성을 위한 10% 버퍼

작업 배치:

• 의존성이 없을 때 병렬 실행

• 관련 작업 간 컨텍스트 공유

• 성공적인 라우팅 패턴을 위한 캐시 전략

• 리소스 고갈을 방지하는 스마트 큐잉

고급 오케스트레이션

서브 에이전트 위임:

# >7개 디렉토리 또는 >50개 파일이 감지될 때 자동 활성화
/sc:analyze monorepo/
# → --delegate auto 플래그 + 병렬 처리

웨이브 오케스트레이션:

# 복잡성 >0.7 + 파일 >20 + 작업 유형 >2일 때 자동 활성화
/sc:improve legacy-system/
# → --wave-mode auto + 다단계 실행

실제 오케스트레이션 예제 💡

예제 1: 보안 분석 요청

/sc:analyze user-auth/ --focus security

오케스트레이터 분석:

• 도메인: 보안 (높은 신뢰도)

• 복잡성: 보통 (인증 시스템)

• 작업: 분석 + 스캐닝

보통 조정하는 것:

• 🛡️ security 페르소나 (위협 모델링 관점)

• Sequential MCP (체계적 분석)

• --validate 플래그 (작업 전 안전 확인)

• --think 플래그 (복잡한 보안 패턴)

품질 게이트: 보안 검증에 중점을 둔 모든 8단계

예제 2: 프론트엔드 성능 최적화

/sc:improve slow-dashboard/ --focus performance

오케스트레이터 분석:

• 도메인: 프론트엔드 + 성능 (이중 전문성 필요)

• 복잡성: 높음 (성능 최적화)

• 작업: 개선 + 검증

보통 조정하는 것:

• ⚡ performance 페르소나 (주요)

• 🎨 frontend 페르소나 (UI가 감지되면 보조)

• Playwright MCP (성능 테스팅)

• --think-hard 플래그 (복잡한 최적화)

품질 게이트: 벤치마킹이 포함된 성능 중심 검증

예제 3: 대규모 코드베이스 분석

/sc:analyze enterprise-monorepo/

오케스트레이터 분석:

• 범위: 대규모 (>50개 파일 감지)

• 복잡성: 높음 (엔터프라이즈 규모)

• 리소스: 높은 토큰 사용 예상

보통 조정하는 것:

• --delegate auto 플래그 (병렬 처리)

• --uc 플래그 (토큰 최적화)

• 🏗️ architect 페르소나 (시스템 수준 분석)

•Sequential MCP (구조화된 분석)

품질 게이트: 서브 에이전트 간 분산 검증

오케스트레이터 구성 ⚙️

성능 설정:

orchestrator_config:
  enable_caching: true
  parallel_operations: true
  max_parallel: 3
  token_reserve: 10%
  emergency_threshold: 90%

인텔리전스 설정:

  learning_enabled: true
  confidence_threshold: 0.7
  pattern_detection: aggressive
  wave_score_threshold: 0.7

오케스트레이터는 성공적인 패턴에서 학습하고 결과를 기반으로 미래 라우팅 결정을 개선하려고 시도합니다.