docs/user-guide-kr/modes.md
/sc: 명령어를 사용하여 모드를 테스트하세요 - 작업 복잡성에 따라 자동으로 활성화됩니다. 전체 명령어 참조는 명령어 가이드를 참조하세요.
| 모드 | 목적 | 자동 트리거 | 주요 동작 | 최적 사용처 |
|---|---|---|---|---|
| 🧠 브레인스토밍 | 대화형 발견 | "brainstorm", "maybe", 모호한 요청 | 소크라테스식 질문, 요구사항 도출 | 새 프로젝트 계획, 불명확한 요구사항 |
| 🔍 내성 | 메타인지 분석 | 오류 복구, "추론 분석" | 투명한 사고 마커 (🤔, 🎯, 💡) | 디버깅, 학습, 최적화 |
| 🔬 심층 연구 | 체계적 조사 마인드셋 | /sc:research, 조사 키워드 | 6단계 워크플로우, 증거 기반 추론 | 기술 연구, 최신 이벤트, 시장 분석 |
| 📋 작업 관리 | 복잡한 조정 | >3단계, >2개 디렉토리 | 단계 분해, 메모리 지속성 | 다단계 작업, 프로젝트 관리 |
| 🎯 오케스트레이션 | 지능형 도구 선택 | 다중 도구 작업, 높은 리소스 사용 | 최적의 도구 라우팅, 병렬 실행 | 복잡한 분석, 성능 최적화 |
| ⚡ 토큰 효율성 | 압축 커뮤니케이션 | 높은 컨텍스트 사용, --uc 플래그 | 심볼 시스템, 예상 30-50% 토큰 감소 | 리소스 제약, 대규모 작업 |
모드는 행동 지침을 통해 활성화됩니다 - Claude Code가 컨텍스트 파일을 읽어 작업 패턴과 복잡성에 따라 채택할 모드 동작을 결정합니다.
빠른 예제:
# 자동 활성화 예제
/sc:brainstorm "모바일 앱" # → 소크라테스식 발견 질문
/sc:implement "인증 시스템" # → 다단계 조정
"--uc analyze large-codebase/" # → 압축된 심볼 출력
수동 플래그를 사용할 때:
--brainstorm, --introspect, --uc목적: 협업 발견을 통해 모호한 아이디어를 구조화된 요구사항으로 변환합니다.
자동 활성화 트리거:
--brainstorm, --bs행동 변화:
예제 경험:
표준 접근법: "JWT 토큰으로 사용자 인증 시스템을 구축하겠습니다..."
브레인스토밍 접근법:
"🤔 함께 탐색해봅시다:
- 인증이 앱에서 해결하는 특정 사용자 문제는 무엇인가요?
- 사용자는 누구이며 기술적 편안함 수준은 어떤가요?
- 통합할 기존 시스템이나 소셜 로그인이 있나요?
- 어떤 보안/규정 준수 요구사항이 있나요?
📝 결과: 구현 준비가 된 상세한 인증 요구사항 브리프"
검증: /sc:brainstorm "웹 앱"은 사용자, 기능, 기술에 대해 질문해야 함
테스트: 모호한 요청은 가정이 아닌 발견 질문을 트리거해야 함
확인: 동일한 대화에서 후속 질문 전반에 걸쳐 모드가 지속되어야 함
최적의 협업 대상:
--brainstorm 사용목적: 학습 최적화 및 투명한 의사결정을 위한 추론 과정 노출
자동 활성화 트리거:
--introspect행동 변화:
예제 경험:
표준 접근법: "이 코드 구조를 분석하고 개선 사항을 제안하겠습니다..."
내성적 접근법:
"🧠 메타 분석: 왜 기능 흐름보다 구조적 분석을 선택했을까?
🎯 결정 논리: 클래스 계층 구조 확인 → OOP 패턴 우세 가정
🔄 고려된 대안: 데이터 흐름 분석이 숨겨진 종속성 드러낼 수 있음
📊 증거 확인: 파일 임포트가 OOP가 아닌 함수형 구성 시사
💡 학습: 분석 전략 선택 전에 임포트 분석 필요
⚡ 수정: 함수형 흐름 분석 접근법으로 전환"
최적의 협업 대상:
--introspect 사용목적: 체계적 조사 및 증거 기반 추론을 위한 연구 마인드셋
자동 활성화 트리거:
/sc:research 명령어 호출--research행동 수정:
6단계 연구 워크플로우:
예제 경험:
표준 모드: "양자 컴퓨팅에 대한 검색 결과입니다..."
심층 연구 모드:
"📊 연구 계획: 양자 컴퓨팅 돌파구
✓ TodoWrite: 8개 연구 작업 생성
🔄 도메인 전반에 걸쳐 병렬 검색 실행
📈 신뢰도: 15개 검증된 소스에서 0.82
📝 보고서 저장됨: docs/research/quantum_[timestamp].md"
검증: /sc:research "테스트 주제"는 TodoWrite를 생성하고 체계적으로 실행해야 함
테스트: 모든 연구에 신뢰도 점수 및 인용이 포함되어야 함
확인: 보고서가 자동으로 docs/research/에 저장되어야 함
최적의 협업 대상:
--depth 및 --strategy 사용목적: 다단계 작업을 위한 세션 지속성을 갖춘 계층적 작업 조직
자동 활성화 트리거:
3개의 조정된 단계가 필요한 작업
--task-manage, --delegate행동 변화:
예제 경험:
표준 접근법: "사용자 인증을 구현하겠습니다..." → 직접 구현
작업 관리 접근법:
"📋 다단계 구현 계획:
🎯 1단계: 보안 요구사항 분석 (세션 1)
🎯 2단계: API 설계 및 문서화 (세션 2)
🎯 3단계: 구현 및 테스팅 (세션 3-4)
🎯 4단계: 통합 및 검증 (세션 5)
💾 세션 지속성: 자동으로 컨텍스트 재개
✓ 품질 게이트: 각 단계 전환 전 검증"
최적의 협업 대상:
목적: 지능형 도구 라우팅 및 병렬 조정을 통한 작업 실행 최적화
자동 활성화 트리거:
행동 변화:
예제 경험:
표준 접근법: 순차적 파일별 분석 및 편집
오케스트레이션 접근법:
"🎯 다중 도구 조정 전략:
🔍 1단계: Serena (의미론적 분석) + Sequential (아키텍처 검토)
⚡ 2단계: Morphllm (패턴 편집) + Magic (UI 컴포넌트)
🧪 3단계: Playwright (테스팅) + Context7 (문서 패턴)
🔄 병렬 실행: 3개 도구 동시 작업"
최적의 협업 대상:
목적: 정보 품질을 유지하면서 심볼 시스템을 통해 예상 30-50% 토큰 감소 달성
자동 활성화 트리거:
--uc, --ultracompressed행동 변화:
예제 경험:
표준 접근법: "인증 시스템 구현은 즉각적인 주의가 필요한 사용자 검증 함수의 보안 취약점을 보여줍니다..."
토큰 효율적 접근법:
"🛡️ 보안 경고:
auth.js:45 → user val() → 중요한 취약점
📊 영향: ❌ 토큰 우회 가능
⚡ 조치: 검증 수정 + 감사 ∵ 높은 심각도
🔧 예상: 2시간 구현 + 1시간 테스트"
최적의 협업 대상:
--uc 사용목적: 간단한 개발 작업을 위한 명확하고 전문적인 커뮤니케이션 제공
자동 활성화 트리거:
행동 변화:
예제 경험:
표준 접근법: 모든 작업에 대한 일관되고 전문적인 기준선
"적절한 오류 처리와 함께 로그인 함수를 구현하겠습니다:
1. 사용자 입력 검증 (이메일 형식, 비밀번호 요구사항)
2. 안전한 해싱으로 데이터베이스에 대해 인증
3. 적절한 만료를 갖춘 JWT 토큰 생성
4. 사용자 데이터와 함께 성공 응답 반환
구현은 보안 모범 사례를 따르고 포괄적인 오류 처리를 포함할 것입니다."
최적의 협업 대상:
다중 모드 워크플로우:
# 발견 → 계획 → 구현
/sc:brainstorm "마이크로서비스 아키텍처" --task-manage
# → 브레인스토밍: 요구사항 발견
# → 작업 관리: 다단계 조정
# 투명성 및 효율성을 갖춘 분석
/sc:analyze legacy-system/ --introspect --uc
# → 내성: 투명한 추론
# → 토큰 효율성: 압축된 출력
특정 동작 강제:
--brainstorm: 모든 작업에 대한 협업 발견 강제--introspect: 모든 모드에 추론 투명성 추가--task-manage: 계층적 조정 활성화--orchestrate: 도구 선택 및 병렬 실행 최적화--uc: 효율성을 위해 커뮤니케이션 압축재정의 예제:
# "명확한" 요구사항에 브레인스토밍 강제
/sc:implement "사용자 로그인" --brainstorm
# 디버깅에 추론 투명성 추가
# 투명한 추론으로 인증 문제 디버그
# 간단한 작업에 작업 관리 활성화
# 체계적인 작업 관리로 styles.css 업데이트
모드가 활성화되는 시점:
우선순위 규칙:
새 프로젝트 개발:
# 1단계: 발견 (브레인스토밍 모드 자동 활성화)
"생산성 앱을 만들고 싶어요"
→ 🤔 사용자, 기능, 플랫폼 선택에 대한 소크라테스식 질문
→ 📝 구조화된 요구사항 브리프
# 2단계: 계획 (작업 관리 모드 자동 활성화)
/sc:implement "핵심 생산성 기능"
→ 📋 종속성이 있는 다단계 분해
→ 🎯 품질 게이트를 갖춘 단계 조정
# 3단계: 구현 (오케스트레이션 모드가 도구 조정)
/sc:implement "프론트엔드 및 백엔드 시스템"
→ 🎯 Magic (UI) + Context7 (패턴) + Sequential (아키텍처)
→ ⚡ 병렬 실행 최적화
복잡한 문제 디버깅:
# 문제 분석 (내성 모드 자동 활성화)
"사용자가 간헐적인 인증 실패를 겪고 있어요"
→ 🤔 잠재적 원인에 대한 투명한 추론
→ 🎯 가설 형성 및 증거 수집
→ 💡 유사한 문제 전반의 패턴 인식
# 체계적 해결 (작업 관리가 조정)
# 인증 시스템 포괄적으로 수정
→ 📋 1단계: 근본 원인 분석
→ 📋 2단계: 솔루션 구현
→ 📋 3단계: 테스팅 및 검증
높은 복잡성 시나리오:
# 여러 제약이 있는 대규모 리팩토링
/sc:improve legacy-system/ --introspect --uc --orchestrate
→ 🔍 투명한 추론 (내성)
→ ⚡ 압축 커뮤니케이션 (토큰 효율성)
→ 🎯 최적의 도구 조정 (오케스트레이션)
→ 📋 체계적 단계 (작업 관리 자동 활성화)
| 트리거 유형 | 예제 입력 | 활성화된 모드 | 주요 동작 |
|---|---|---|---|
| 모호한 요청 | "앱을 만들고 싶어요" | 🧠 브레인스토밍 | 소크라테스식 발견 질문 |
| 복잡한 범위 | >3개 파일 또는 >2개 디렉토리 | 📋 작업 관리 | 단계 조정 |
| 다중 도구 필요 | 분석 + 구현 | 🎯 오케스트레이션 | 도구 최적화 |
| 오류 복구 | "예상대로 작동하지 않아요" | 🔍 내성 | 투명한 추론 |
| 리소스 압박 | 높은 컨텍스트 사용 | ⚡ 토큰 효율성 | 심볼 압축 |
| 간단한 작업 | "이 함수 수정" | 🎨 표준 | 명확하고 직접적인 접근 |
# 특정 모드 동작 강제
/sc:command --brainstorm # 협업 발견
/sc:command --introspect # 추론 투명성
/sc:command --task-manage # 계층적 조정
/sc:command --orchestrate # 도구 최적화
/sc:command --uc # 토큰 압축
# 여러 모드 결합
/sc:command --introspect --uc # 투명 + 효율적
/sc:command --task-manage --orchestrate # 조정 + 최적화
문제 해결 도움말은 다음을 참조하세요:
--brainstorm, --introspect, --uc--brainstorm 또는 --task-manage와 같은 명시적 플래그 사용브레인스토밍 모드 문제:
# 문제: 모드가 질문 대신 솔루션 제공
# 빠른 수정: 요청 명확성 확인 및 명시적 플래그 사용
/sc:brainstorm "웹 앱" --brainstorm # 발견 모드 강제
"...에 대한 모호한 아이디어가 있어요" # 불확실성 언어 사용
"...를 구축할 수 있을까요" # 탐색 트리거
작업 관리 모드 문제:
# 문제: 간단한 작업이 복잡한 조정을 받음
# 빠른 수정: 범위 줄이기 또는 더 간단한 명령어 사용
/sc:implement "함수" --no-task-manage # 조정 비활성화
/sc:troubleshoot bug.js # 기본 명령어 사용
# 작업이 정말 복잡한지 확인 (>3개 파일, >2개 디렉토리)
토큰 효율성 모드 문제:
# 문제: 출력이 너무 압축되거나 불명확함
# 빠른 수정: 명확성을 위해 압축 비활성화
/sc:command --no-uc # 압축 비활성화
/sc:command --verbose # 상세 출력 강제
# 명확성이 효율성보다 중요할 때 사용
내성 모드 문제:
# 문제: 너무 많은 메타 주석, 충분한 행동 없음
# 빠른 수정: 직접 작업을 위해 내성 비활성화
/sc:command --no-introspect # 직접 실행
# 학습 및 디버깅에만 내성 사용
오케스트레이션 모드 문제:
# 문제: 도구 조정이 혼란 야기
# 빠른 수정: 도구 사용 단순화
/sc:command --no-mcp # 네이티브 도구만
/sc:command --simple # 기본 실행
# 작업 복잡성이 오케스트레이션을 정당화하는지 확인
| 모드 오류 | 의미 | 빠른 수정 |
|---|---|---|
| B001 | 브레인스토밍 활성화 실패 | 명시적 --brainstorm 플래그 사용 |
| T001 | 작업 관리 오버헤드 | 간단한 작업에 --no-task-manage 사용 |
| U001 | 토큰 효율성이 너무 공격적 | --verbose 또는 --no-uc 사용 |
| I001 | 내성 모드 정체 | 직접 행동을 위해 --no-introspect 사용 |
| O001 | 오케스트레이션 조정 실패 | --no-mcp 또는 --simple 사용 |
| M001 | 모드 충돌 감지 | 플래그 우선순위 규칙 확인 |
| M002 | 모드 전환 루프 | 상태를 재설정하려면 세션 재시작 |
| M003 | 모드를 인식할 수 없음 | SuperClaude 업데이트 또는 철자 확인 |
수준 1: 빠른 수정 (< 2분)
수준 2: 상세 도움말 (5-15분)
# 모드별 진단
/sc:help modes # 사용 가능한 모든 모드 나열
/sc:reflect --type mode-status # 현재 모드 상태 확인
# 요청 복잡성 및 트리거 검토
수준 3: 전문가 지원 (30분 이상)
# 심층 모드 분석
SuperClaude install --diagnose
# 모드 활성화 패턴 확인
# 행동 트리거 및 임계값 검토
수준 4: 커뮤니티 지원
모드 수정 적용 후 다음으로 테스트:
--brainstorm, --introspect, --ucQ: 어떤 모드가 활성화되어 있는지 어떻게 알 수 있나요? A: 커뮤니케이션 패턴에서 이러한 지표를 찾으세요:
Q: 특정 모드를 강제할 수 있나요? A: 예, 자동 감지를 재정의하려면 수동 플래그 사용:
/sc:command --brainstorm # 발견 강제
/sc:command --introspect # 투명성 추가
/sc:command --task-manage # 조정 활성화
/sc:command --uc # 출력 압축
Q: 모드가 실행에 영향을 미치나요? A: 모드는 조정을 통해 도구 사용 최적화:
Q: 모드가 함께 작동할 수 있나요? A: 예, 모드는 서로를 보완하도록 설계됨:
SuperClaude의 5가지 행동 모드는 필요에 따라 자동으로 일치하는 지능형 적응 시스템을 만듭니다:
핵심 인사이트: 모드에 대해 생각할 필요가 없습니다 - 개발 경험을 향상시키기 위해 투명하게 작동합니다. 달성하고자 하는 것을 설명하면 SuperClaude가 자동으로 필요에 맞게 접근 방식을 조정합니다.
학습 진행:
🌱 필수 (1주차)
🌿 중급 (2-3주차)
🌲 고급 (2개월 이상)
🔧 전문가
모드별 가이드: