명령 참조

버전: 4.1.9•총 명령 수: 29•업데이트: 2025년 12월

이 문서는 SuperClaude 프레임워크의 완전한 명령 참조 매뉴얼로, 모든 슬래시 명령에 대한 상세한 설명, 매개변수, 사용 예제 및 모범 사례를 포함합니다.

빠른 참조

분류	개 명령
개발	/sc:implement /sc:build /sc:improve /sc:cleanup /sc:git
문서화	/sc:document /sc:explain /sc:index
계획 및 요구사항	/sc:brainstorm /sc:design /sc:estimate /sc:workflow
프로젝트 관리	/sc:pm /sc:task /sc:spawn /sc:select-tool /sc:index-repo
연구 및 분석	/sc:research /sc:business-panel /sc:spec-panel
세션 관리	/sc:load /sc:save /sc:agent
테스팅 및 품질	/sc:test /sc:analyze /sc:troubleshoot /sc:reflect
유틸리티	/sc:help /sc:recommend

개발

5 개 명령

/sc:implement

고급

지능형 페르소나 활성화 및 MCP 통합을 통한 기능 및 코드 구현을 수행합니다

구문

/sc:implement [옵션] "[기능-설명]"

옵션

플래그	값	설명
--type	component, api, service, feature	아티팩트 유형을 지정합니다: 'component', 'api', 'service' 또는 'feature'입니다.
--framework	react, vue, express, etc.	코드 생성 패턴을 맞춤화하기 위해 대상 프레임워크(예: react, vue)를 지정합니다.
--safe	-	보수적 모드를 활성화합니다: 파괴적 변경을 피하고 호환성을 유지하는 업데이트에 집중합니다.
--with-tests	-	구현된 코드에 대한 단위 테스트 및 통합 테스트를 자동으로 생성합니다.

예제

React 컴포넌트 구현

/sc:implement --type component --framework react "사용자 프로필 컴포넌트"

API 서비스 구현 (안전 모드 + 테스트)

/sc:implement --type api --safe --with-tests "사용자 인증 API"

풀스택 기능

/sc:implement --type feature --with-tests "결제 처리 시스템"

Vue 프레임워크 컴포넌트

/sc:implement --type component --framework vue "대시보드 위젯"

Express 백엔드 서비스

/sc:implement --type service --framework express --safe "파일 업로드 서비스"

React 보안 컴포넌트 (테스트 포함)

/sc:implement --type component --framework react --safe --with-tests "관리자 패널"

Next.js 페이지 구현

/sc:implement --type feature --framework nextjs "사용자 설정 페이지"

순수 API 구현 (테스트 제외)

/sc:implement --type api "알림 엔드포인트"

/sc:build

고급

지능형 오류 처리 및 최적화를 통해 프로젝트를 빌드, 컴파일 및 패키징합니다

구문

/sc:build [옵션] [대상]

옵션

플래그	값	설명
--type	dev, prod, test	빌드 대상 환경: 'dev', 'prod' 또는 'test'입니다.
--clean	-	시작하기 전에 이전 빌드 아티팩트를 제거합니다.
--optimize	-	축소 및 트리 셰이킹과 같은 성능 최적화를 활성화합니다.
--verbose	-	내부 에이전트 결정 및 상태 변경에 대한 상세한 로깅을 활성화합니다.

예제

개발 빌드

/sc:build --type dev

프로덕션 빌드

/sc:build --type prod --clean --optimize

상세 빌드

/sc:build --verbose

/sc:improve

고급

코드 품질, 성능 및 유지보수성에 대한 체계적인 개선을 적용합니다

구문

/sc:improve [옵션] [대상]

옵션

플래그	값	설명
--type	quality, performance, maintainability, style	개선을 위한 초점 영역: 'quality', 'performance', 'maintainability' 또는 'style'입니다.
--safe	-	안전 모드 (보수적 개선)
--interactive	-	각 개선 제안을 적용하기 전에 사용자 승인을 요청합니다.
--preview	-	적용하지 않고 제안된 변경 사항에 대한 포괄적인 diff를 생성합니다.
--validate	-	변경 사항을 적용한 후 검증 단계(예: 린터, 테스트)를 실행합니다.

예제

품질 개선

/sc:improve --type quality src/auth

성능 최적화 (안전 모드)

/sc:improve --type performance --safe api/

대화형 스타일 개선

/sc:improve --type style --interactive components/

유지보수성 개선 (미리보기)

/sc:improve --type maintainability --preview src/utils

품질 개선 (검증 + 대화형)

/sc:improve --type quality --validate --interactive src/services

안전한 성능 최적화 (미리보기)

/sc:improve --type performance --safe --preview database/

포괄적인 품질 검토

/sc:improve --type quality --validate --safe src/

스타일 통합 (안전 + 미리보기)

/sc:improve --type style --safe --preview --validate components/

/sc:cleanup

고급

코드를 체계적으로 정리하고, 데드 코드를 제거하며, 프로젝트 구조를 최적화합니다

구문

/sc:cleanup [옵션] [대상]

옵션

플래그	값	설명
--type	code, imports, files, all	정리 대상: 'code' (포매팅), 'imports' (미사용), 'files' (임시), 또는 'all'입니다.
--safe	-	안전 모드 (보수적 정리)
--aggressive	-	코드 구조를 크게 변경할 수 있는 더 엄격한 정리 규칙을 적용합니다.
--interactive	-	대화형 정리
--preview	-	적용하지 않고 제안된 변경 사항에 대한 포괄적인 diff를 생성합니다.

예제

안전한 코드 정리

/sc:cleanup --type code --safe src/

import 정리

/sc:cleanup --type imports

포괄적인 대화형 정리

/sc:cleanup --type all --interactive

공격적인 파일 정리 (미리보기)

/sc:cleanup --type files --aggressive --preview

안전한 코드 정리 (미리보기)

/sc:cleanup --type code --safe --preview src/legacy

대화형 import 정리

/sc:cleanup --type imports --interactive

포괄적인 공격적 정리

/sc:cleanup --type all --aggressive

안전한 포괄적 정리 (미리보기 + 대화형)

/sc:cleanup --type all --safe --preview --interactive

/sc:git

기초

지능형 커밋 메시지 및 워크플로우 최적화를 통한 Git 작업을 수행합니다

구문

/sc:git [옵션] "[작업]"

옵션

플래그	값	설명
--smart-commit	-	AI를 사용하여 스테이징된 변경 사항을 분석하고 시맨틱 커밋 메시지를 생성합니다.
--interactive	-	단계별 프롬프트로 Git 워크플로우를 안내합니다.

예제

스마트 커밋

/sc:git --smart-commit

기능 브랜치 생성

/sc:git "feature/user-auth"

대화형 작업

/sc:git --interactive

문서화

3 개 명령

/sc:document

기초

컴포넌트, 함수, API 및 기능에 대한 집중적인 문서를 생성합니다

구문

/sc:document [옵션] [대상]

옵션

플래그	값	설명
--type	inline, external, api, guide	대상 형식: 'inline' (주석), 'external' (마크다운), 'api' (사양) 또는 'guide'입니다.
--style	brief, detailed	세부 수준: 'brief' (요약) 또는 'detailed' (전체 사양)입니다.

예제

인라인 문서화

/sc:document --type inline src/utils.ts

API 문서화

/sc:document --type api --style detailed api/

사용자 가이드

/sc:document --type guide --style brief

/sc:explain

기초

코드, 개념 및 시스템 동작에 대한 명확한 설명을 제공합니다

구문

/sc:explain [옵션] "[대상]"

옵션

플래그	값	설명
--level	basic, intermediate, advanced	대상 청중 전문성: 'basic', 'intermediate' 또는 'advanced'입니다.
--format	text, examples, interactive	설명 형식: 'text', 'examples' 또는 'interactive'입니다.
--context	[domain]	설명 컨텍스트를 특정 도메인(예: 'auth', 'database')으로 제한합니다.

예제

기본 설명

/sc:explain --level basic src/auth/middleware.ts

고급 상세 설명

/sc:explain --level advanced --format examples "JWT 인증 플로우"

대화형 설명

/sc:explain --format interactive "데이터베이스 최적화"

/sc:index

기초

포괄적인 프로젝트 문서 및 지식 베이스를 생성합니다

구문

/sc:index [옵션] [대상]

옵션

플래그	값	설명
--type	docs, api, structure, readme	생성할 인덱스 유형: 'docs', 'api', 'structure' 또는 'readme'입니다.
--format	md, json, yaml	결과 형식: 'text', 'json' 또는 'report'입니다.

예제

문서 인덱스

/sc:index --type docs

API 인덱스

/sc:index --type api --format json api/

프로젝트 구조 인덱스

/sc:index --type structure --format yaml

계획 및 요구사항

4 개 명령

/sc:brainstorm

고급

소크라테스식 대화와 체계적인 탐색을 통한 대화형 요구사항 발견을 수행합니다

구문

/sc:brainstorm [옵션] "[주제/아이디어]"

옵션

플래그	값	설명
--strategy	systematic, agile, enterprise	전략적 접근 방식을 선택합니다: 'systematic'은 철저함, 'agile'은 속도, 'enterprise'는 규모를 위한 것입니다.
--depth	shallow, normal, deep	분석 깊이를 제어합니다: 'shallow'는 빠른 스캔, 'deep'은 포괄적인 검토를 위한 것입니다.
--parallel	-	병렬 탐색 경로를 활성화합니다

예제

체계적인 제품 발견 (심층 분석)

/sc:brainstorm --strategy systematic --depth deep "AI 기반 프로젝트 관리 도구"

애자일 기능 탐색 (병렬 경로)

/sc:brainstorm --strategy agile --parallel "실시간 협업 기능"

엔터프라이즈 솔루션 검증

/sc:brainstorm --strategy enterprise "엔터프라이즈 데이터 분석 플랫폼"

빠른 얕은 탐색

/sc:brainstorm --depth shallow "모바일 앱 아이디어"

체계적인 병렬 심층 탐색

/sc:brainstorm --strategy systematic --depth deep --parallel "마이크로서비스 아키텍처"

애자일 반복 탐색

/sc:brainstorm --strategy agile --depth normal "사용자 인증 개선"

/sc:design

기초

시스템 아키텍처, API 및 컴포넌트 인터페이스를 포괄적인 사양과 함께 설계합니다

구문

/sc:design [옵션] [대상]

옵션

플래그	값	설명
--type	architecture, api, component, database	설계 유형
--format	diagram, spec, code	결과 형식: 'text', 'json' 또는 'report'입니다.

예제

시스템 아키텍처 설계

/sc:design --type architecture --format diagram user-management-system

API 사양 설계

/sc:design --type api --format spec payment-api

컴포넌트 인터페이스 설계

/sc:design --type component --format code notification-service

데이터베이스 스키마 설계

/sc:design --type database --format diagram e-commerce-db

/sc:estimate

기초

작업, 기능 또는 프로젝트에 대한 지능적인 개발 추정을 제공합니다

구문

/sc:estimate [옵션] "[대상]"

옵션

플래그	값	설명
--type	time, effort, complexity	추정 유형
--unit	hours, days, weeks	시간 단위
--breakdown	-	상세 분석을 활성화합니다

예제

시간 추정

/sc:estimate --type time --unit days "인증 시스템"

복잡도 분석

/sc:estimate --type complexity --breakdown "API 리팩토링"

/sc:workflow

고급

PRD 및 기능 요구사항으로부터 구조화된 구현 워크플로우를 생성합니다

구문

/sc:workflow [옵션] "[기능-설명]"

옵션

플래그	값	설명
--strategy	systematic, agile, enterprise	워크플로우 전략
--depth	shallow, normal, deep	워크플로우 깊이
--parallel	-	병렬 실행을 활성화합니다

예제

체계적인 워크플로우

/sc:workflow --strategy systematic "결제 통합"

애자일 반복 워크플로우

/sc:workflow --strategy agile --depth deep "사용자 온보딩"

프로젝트 관리

5 개 명령

/sc:pm

메타급

프로젝트 관리자 에이전트 - 모든 하위 에이전트를 조정하고 워크플로우를 원활하게 관리하는 기본 오케스트레이션 에이전트입니다

구문

/sc:pm [옵션] "[요청]"

옵션

플래그	값	설명
--strategy	brainstorm, direct, wave	실행 모드를 정의합니다: 'brainstorm'는 대화형 질문을 통한 탐색적 아이디어 도출 및 요구사항 발견(모호하거나 불명확한 요청에 이상적), 'direct'는 광범위한 계획 없이 즉각적인 구현(범위가 명확한 작업에 가장 적합), 또는 'wave'는 구조화된 구현 단계를 가진 단계별 배포(체계적인 진행이 필요한 복잡한 다단계 프로젝트에 최적). 요구사항 명확화가 필요할 때는 brainstorm, 직접적인 작업에는 direct, 대규모 변경에는 wave를 선택하세요.
--verbose	-	내부 에이전트 결정, 하위 에이전트 활성화, 워크플로우 상태 변경 및 위임 패턴에 대한 상세한 로깅을 활성화합니다. PM 에이전트의 추론 프로세스 이해, 워크플로우 문제 디버깅, 오케스트레이션 전략 학습 또는 특정 작업에 활성화된 전문가 에이전트 추적에 유용합니다. 전략 선택, 작업 분해 논리 및 실행 흐름에 대한 투명성을 제공합니다.

예제

기본 사용 (명령 불필요, 요구사항을 직접 설명하면 PM 에이전트가 자동으로 오케스트레이션을 처리합니다)

/sc:pm "앱에 결제 처리 기능 추가 필요"

명시적 전략 선택 (wave 전략 사용)

/sc:pm --strategy wave "애플리케이션 보안 개선"

브레인스토밍 모드 (PM 에이전트가 탐색 필요성 자동 감지)

/sc:pm "사용자 경험을 개선할 수 있을까요?"

명시적 브레인스토밍 전략 (요구사항 발견 강제)

/sc:pm --strategy brainstorm "대시보드에 새 기능 추가"

직접 전략 (명확한 요구사항의 즉각적인 구현)

/sc:pm --strategy direct "모바일에서 로그인 버튼 정렬 문제 수정"

상세 모드 (에이전트 오케스트레이션 결정 추적)

/sc:pm --verbose "API 레이어 리팩터링"

Wave 전략과 상세 로깅 (복잡한 프로젝트의 가시성)

/sc:pm --strategy wave --verbose "REST에서 GraphQL로 마이그레이션"

다단계 프로젝트 워크플로우 (인증 시스템)

/sc:pm --strategy wave "OAuth, 2FA 및 세션 관리를 포함한 완전한 사용자 인증 구현"

디버깅 워크플로우 (성능 조사)

/sc:pm --verbose "대시보드 로딩 성능 문제 조사 및 수정"

성능 최적화 프로젝트 (체계적인 개선)

/sc:pm --strategy wave "프론트엔드, 백엔드 및 데이터베이스 전반의 애플리케이션 성능 최적화"

/sc:task

고급

지능형 워크플로우 관리 및 위임을 통한 복잡한 작업 실행을 수행합니다

구문

/sc:task [옵션] "[작업-설명]"

옵션

플래그	값	설명
--strategy	systematic, agile, enterprise	작업 실행 접근 방식을 정의합니다: 'systematic'은 각 단계에서 포괄적인 계획과 검증을 수행하는 체계적인 단계별 진행(신중한 분석이 필요한 복잡하고 익숙하지 않은 작업에 가장 적합), 'agile'은 빈번한 검증 주기를 가진 반복적 빠른 개발(진화하는 요구사항이나 실험적 기능에 이상적), 또는 'enterprise'는 거버넌스, 문서화 및 팀 간 조정을 포함한 대규모 운영(여러 시스템에 영향을 미치는 미션 크리티컬 변경에 적합). 철저함을 위해 systematic, 속도와 유연성을 위해 agile, 조직 규모를 위해 enterprise를 선택하세요.
--parallel	-	작업을 종속성이 없는 하위 작업으로 분해할 수 있을 때 독립적인 작업의 병렬 실행을 활성화합니다. 전체 실행 시간을 줄이기 위해 동시 처리 기회를 자동으로 식별합니다. 다중 파일 편집, 일괄 작업 또는 명확한 구성 요소 경계를 가진 작업에 특히 효과적입니다. 속도를 최적화하고 작업에 순차적 종속성이 없을 때 사용하세요.
--delegate	-	작업 도메인과 복잡도에 따라 전문 하위 에이전트로의 지능형 위임을 활성화합니다. 작업 에이전트가 요구사항을 분석하고 하위 작업을 적절한 전문가에게 라우팅합니다(예: UI는 frontend-architect, 인증은 security-engineer, 최적화는 performance-engineer). 여러 도메인에 걸쳐 있거나 전문 지식이 필요한 복잡한 작업에 사용하세요. 전문가 수준의 실행을 통해 품질을 향상시킵니다.

예제

체계적인 작업 실행

/sc:task --strategy systematic "인증 구현"

병렬 작업 실행 및 위임

/sc:task --parallel --delegate "API 엔드포인트 리팩토링"

애자일 전략 (반복적 개발)

/sc:task --strategy agile "인터랙티브 데이터 시각화 대시보드 구축"

엔터프라이즈 전략 (대규모 마이그레이션)

/sc:task --strategy enterprise "50개 이상의 마이크로서비스를 Kubernetes로 마이그레이션"

병렬 실행 (독립적인 작업)

/sc:task --parallel "모든 컴포넌트 prop 타입을 TypeScript로 업데이트"

전문가에게 위임 (복잡한 도메인 작업)

/sc:task --delegate "메시징 기능을 위한 종단 간 암호화 구현"

체계적 + 병렬화 (철저함 + 빠름)

/sc:task --strategy systematic --parallel "레거시 코드베이스를 최신 패턴으로 리팩토링"

애자일 + 완전한 위임 및 병렬화 (빠른 다중 도메인 개발)

/sc:task --strategy agile --delegate --parallel "프론트엔드와 백엔드에 실시간 협업 기능 추가"

/sc:spawn

메타급

지능형 분해 및 위임을 통한 메타 시스템 작업 오케스트레이션을 수행합니다

구문

/sc:spawn [복잡한-작업] [옵션]

옵션

플래그	값	설명
--strategy	sequential, parallel, adaptive	작업 조정 방법을 정의합니다: 'sequential'(순차)은 각 단계가 다음 단계 시작 전에 완료되어야 하는 단계별 실행(엄격한 순서 요구사항이 있는 의존적 작업에 적합), 'parallel'(병렬)은 속도를 최대화하기 위한 독립적인 하위 작업의 동시 실행(명확한 경계와 의존성이 없는 작업에 가장 적합), 또는 'adaptive'(적응형)은 복잡도를 분석하고 자동으로 전략을 조정하는 지능형 동적 라우팅(혼합 의존성 패턴을 가진 복잡한 다중 도메인 프로젝트에 권장). 순서가 있는 워크플로우에는 sequential, 최대 처리량을 위해서는 parallel, 복잡도가 불확실한 경우에는 adaptive를 선택하세요.
--depth	normal, deep	작업 분해 세분화를 제어합니다: 'normal'(표준)은 주요 단계와 구성 요소에 대한 표준 분해를 제공(대부분의 구조가 명확한 프로젝트에 적합), 'deep'(심층)은 포괄적인 의존성 분석과 함께 세밀한 하위 작업으로 재귀적 분해를 수행(복잡한 레거시 시스템, 아키텍처 마이그레이션 또는 철저한 계획이 중요한 경우 필수). 일반적인 프로젝트에는 normal을, 최대한의 계획 세부 사항과 위험 완화를 위해서는 deep을 사용하세요.

예제

복잡한 기능 구현

/sc:spawn "사용자 인증 시스템 구현"

대규모 시스템 운영

/sc:spawn --strategy adaptive --depth deep "레거시 모놀리스를 마이크로서비스로 마이그레이션"

도메인 간 인프라

/sc:spawn "보안 스캔 포함 CI/CD 파이프라인 구축"

순차 전략 (순서가 있는 워크플로우)

/sc:spawn --strategy sequential "데이터베이스 스키마 재설계 및 프로덕션 데이터 마이그레이션"

병렬 전략 (독립적인 구성 요소)

/sc:spawn --strategy parallel "API 문서, 클라이언트 SDK 및 사용 분석을 동시에 구현"

표준 깊이 (표준 계획)

/sc:spawn --depth normal "애플리케이션에 다국어 지원 추가"

심층 분해 (포괄적 분석)

/sc:spawn --depth deep "모놀리스를 도메인 주도 마이크로서비스로 리팩터링"

병렬 + 표준 깊이 (빠른 표준 프로젝트)

/sc:spawn --strategy parallel --depth normal "iOS 및 Android 플랫폼용 모바일 앱 구축"

순차 + 심층 (복잡한 순서 마이그레이션)

/sc:spawn --strategy sequential --depth deep "레거시 COBOL 시스템을 클라우드 네이티브 아키텍처로 현대화"

작업 계층 구조 시각화

spawn 오케스트레이션은 다층 분해를 생성합니다:

레벨 1: 상위 단계 (PM Agent 조정)
  ├─ 레벨 2: 주요 구성 요소 (Task Agent 실행)
  │   ├─ 레벨 3: 구체적 구현 (전문가 에이전트)
  │   └─ 레벨 4: 세밀한 하위 작업 (depth=deep일 때만)

예시: "전자상거래 플랫폼 구축"
  ├─ 단계 1: 아키텍처 및 설계
  │   ├─ 데이터베이스 스키마 설계 (backend-architect)
  │   ├─ API 계약 정의 (backend-architect)
  │   └─ UI/UX 와이어프레임 (frontend-architect)
  ├─ 단계 2: 핵심 구현
  │   ├─ 제품 카탈로그 (backend + frontend)
  │   ├─ 장바구니 (backend + frontend)
  │   └─ 결제 통합 (security-engineer + backend)
  └─ 단계 3: 테스팅 및 배포
      ├─ E2E 테스트 (quality-engineer)
      └─ 프로덕션 배포 (devops-architect)

/sc:select-tool

기초

복잡도 점수 및 작업 분석을 기반으로 한 지능형 MCP 도구 선택을 수행합니다

구문

/sc:select-tool [옵션]

옵션

플래그	값	설명
--analyze	-	현재 프로젝트 컨텍스트, 작업 복잡도 및 사용 가능한 MCP 도구에 대한 심층 분석을 수행하여 최적의 도구 선택을 추천합니다. 평가 요소에는 코드베이스 크기, 작업 유형, 성능 요구사항 및 도구 기능이 포함됩니다. 복잡도 점수(0-1), 권장 도구 및 신뢰도를 출력합니다. 실행 전에 특정 시나리오에 가장 적합한 도구를 이해하는 데 사용하세요.
--explain	-	도구 선택 추천 뒤에 있는 상세한 추론 및 의사결정 논리를 제공합니다. 대안 대신 특정 도구가 선택된 이유를 트레이드오프 분석, 기능 매칭 및 효율성 고려사항을 포함하여 설명합니다. 사용자가 도구 선택 패턴을 학습하고 지능형 라우팅 시스템을 이해하는 데 도움이 되는 교육 모드입니다. 포괄적인 도구 선택 교육을 위해 --analyze와 결합하여 사용하세요.

예제

도구 선택 분석

/sc:select-tool --analyze

도구 선택 추론 설명

/sc:select-tool --explain

분석과 설명 결합 (학습 모드)

/sc:select-tool --analyze --explain

도구 선택을 사용한 성능 최적화 워크플로우

# 1단계: 성능 작업에 최적의 도구 분석
/sc:select-tool --analyze --explain

# 2단계: 권장 도구를 사용하여 실행
# (분석 기반: 분석에는 Sequential, 코드 탐색에는 Serena)

/sc:index-repo

기초

컨텍스트 최적화를 위한 리포지토리 인덱싱을 수행합니다 (94% 토큰 감소: 58K → 3K)

구문

/sc:index-repo [경로]

예제

현재 리포지토리 인덱싱

/sc:index-repo .

특정 디렉토리 인덱싱

/sc:index-repo src/

대규모 리포지토리 성능 지표

/sc:index-repo .

증분 재인덱싱 워크플로우

# 초기 인덱싱
/sc:index-repo .

# 주요 코드 변경 후 (예: 기능 브랜치 병합, 리팩토링)
/sc:index-repo .  # 프로젝트 이해도 업데이트를 위한 재인덱싱

# 특정 변경 영역에 대한 빠른 업데이트
/sc:index-repo src/features/authentication/

다중 모듈 프로젝트 인덱싱 전략

# 여러 패키지가 있는 모노레포
/sc:index-repo packages/backend/    # 백엔드 모듈 인덱싱
/sc:index-repo packages/frontend/   # 프론트엔드 모듈 인덱싱
/sc:index-repo packages/shared/     # 공유 유틸리티 인덱싱

# 또는 전체 모노레포를 한 번에 인덱싱
/sc:index-repo .                    # 종합 인덱싱

연구 및 분석

3 개 명령

/sc:research

고급

적응형 계획 및 지능형 검색을 통한 심층 웹 연구를 수행합니다

구문

/sc:research [옵션] "[쿼리]"

옵션

플래그	값	설명
--depth	quick, standard, deep, exhaustive	검색 깊이: 'quick' (요약), 'standard', 'deep' (포괄적) 또는 'exhaustive'입니다.
--strategy	planning, intent, unified	연구 접근 방식: 'planning', 'intent' 또는 'unified'입니다.

예제

기본 연구 (기본 깊이)

/sc:research "2024년 양자 컴퓨팅의 최신 개발 동향"

심층 경쟁 분석

/sc:research --depth deep "AI 코딩 어시스턴트의 경쟁 분석"

통합 전략 연구

/sc:research --strategy unified "분산 시스템 모범 사례"

빠른 사실 쿼리

/sc:research --depth quick "현재 React 버전"

학술 수준의 심층 연구

/sc:research --depth exhaustive "머신러닝 최적화 기법"

의도 계획 연구

/sc:research --strategy intent "클라우드 아키텍처 패턴"

심층 + 계획 조합

/sc:research --depth deep --strategy planning "마이크로서비스 보안 모범 사례"

표준 연구 (명시적)

/sc:research --depth standard "데이터베이스 확장 전략"

/sc:business-panel

고급

9명의 저명한 비즈니스 사상가와 함께하는 다중 전문가 비즈니스 전략 분석을 수행합니다

구문

/sc:business-panel [옵션] "[주제]"

옵션

플래그	값	설명
--mode	discussion, debate, socratic	분석 모드
--experts	[name1,name2,...]	전문가 선택

예제

시장 진입 전략 분석

/sc:business-panel --mode discussion "시장 진입 전략"

토론 모드

/sc:business-panel --mode debate --experts porter,godin "가격 책정 전략"

소크라테스식 탐색

/sc:business-panel --mode socratic "디지털 혁신"

/sc:spec-panel

고급

저명한 소프트웨어 엔지니어링 전문가와 함께하는 다중 전문가 사양 검토 및 개선을 수행합니다

구문

/sc:spec-panel [옵션] "[사양]"

옵션

플래그	값	설명
--mode	discussion, critique, socratic	검토 모드
--experts	[name1,name2,...]	전문가 선택
--focus	requirements, architecture, testing, compliance	검토 초점
--iterations	[N]	반복 횟수
--format	standard, structured, detailed	결과 형식: 'text', 'json' 또는 'report'입니다.

예제

요구사항 사양 검토

/sc:spec-panel --focus requirements "API 사양"

아키텍처 비평 모드

/sc:spec-panel --mode critique --focus architecture "마이크로서비스 설계"

상세 반복 검토

/sc:spec-panel --iterations 3 --format detailed "보안 정책"

소크라테스식 테스팅 검토

/sc:spec-panel --mode socratic --focus testing "테스트 커버리지 전략"

규정 준수 토론 검토

/sc:spec-panel --mode discussion --focus compliance "GDPR 요구사항"

전문가별 아키텍처 검토

/sc:spec-panel --experts fowler,beck --focus architecture "도메인 주도 설계"

다중 라운드 구조화된 요구사항 검토

/sc:spec-panel --iterations 5 --format structured --focus requirements "사용자 스토리"

비평 모드 테스팅 검토 (상세)

/sc:spec-panel --mode critique --focus testing --format detailed "통합 테스트"

포괄적인 사양 검토

/sc:spec-panel --mode discussion --focus requirements --iterations 3 --format detailed "시스템 사양"

세션 관리

3 개 명령

/sc:load

기초

프로젝트 컨텍스트 로딩을 위한 Serena MCP 통합을 통한 세션 생명주기 관리를 수행합니다

구문

/sc:load [대상] [옵션]

옵션

플래그	값	설명
--type	project, config, deps, checkpoint	로드 유형
--refresh	-	캐시를 새로 고침합니다
--analyze	-	분석을 활성화합니다

예제

프로젝트 컨텍스트 로드

/sc:load --type project src/

체크포인트 로드

/sc:load --type checkpoint "auth-feature"

새로 고침 및 분석

/sc:load --refresh --analyze

/sc:save

기초

세션 컨텍스트 지속성을 위한 Serena MCP 통합을 통한 세션 생명주기 관리를 수행합니다

구문

/sc:save [이름] [옵션]

옵션

플래그	값	설명
--type	session, learnings, context, all	저장 유형
--summarize	-	요약을 생성합니다
--checkpoint	-	체크포인트를 생성합니다

예제

세션 저장

/sc:save --type session "auth-complete"

학습 내용 저장

/sc:save --type learnings --summarize

체크포인트 생성

/sc:save --checkpoint "midpoint"

/sc:agent

고급

SC 에이전트 - 조사, 구현 및 검토의 전체 워크플로우를 오케스트레이션하는 세션 컨트롤러입니다

구문

예제

에이전트는 세션 시작 시 자동으로 시작되며, 사용자가 작업을 설명한 후 전체 워크플로우를 인계받습니다

/sc:agent # 수동 호출 불필요, 자동 활성화됨

테스팅 및 품질

4 개 명령

/sc:test

고급

커버리지 분석 및 자동화된 품질 보고서를 통해 테스트를 실행합니다

구문

/sc:test [옵션] [대상]

옵션

플래그	값	설명
--type	unit, integration, e2e, all	테스트 범위: 'unit', 'integration', 'e2e' 또는 'all'입니다.
--coverage	-	테스트되지 않은 라인을 식별하는 코드 커버리지 보고서를 생성합니다.
--watch	-	파일 변경이 감지되면 테스트를 자동으로 다시 실행합니다.
--fix	-	포매팅 또는 스냅샷 불일치와 같은 사소한 테스트 실패를 자동으로 해결하려고 시도합니다.

예제

기본 테스트 실행

/sc:test

단위 테스트 커버리지 분석

/sc:test --type unit --coverage src/components

엔드투엔드 브라우저 테스팅

/sc:test --type e2e

개발 감시 모드 (자동 수정)

/sc:test --watch --fix

통합 테스팅

/sc:test --type integration

포괄적인 테스팅 (커버리지 포함)

/sc:test --type all --coverage

단위 테스트 감시 모드

/sc:test --type unit --watch

E2E 테스팅 (자동 수정)

/sc:test --type e2e --fix

커버리지 감시 모드

/sc:test --coverage --watch

/sc:analyze

기초

품질, 보안, 성능 및 아키텍처 도메인 전반에 걸친 포괄적인 코드 분석을 수행합니다

구문

/sc:analyze [옵션] [대상]

옵션

플래그	값	설명
--focus	quality, security, performance, architecture	분석할 도메인: 'quality', 'security', 'performance' 또는 'architecture'입니다.
--depth	quick, deep	분석 깊이를 제어합니다: 'shallow'는 빠른 스캔, 'deep'은 포괄적인 검토를 위한 것입니다.
--format	text, json, report	결과 형식: 'text', 'json' 또는 'report'입니다.

예제

포괄적인 프로젝트 분석

/sc:analyze

집중 보안 평가 (심층)

/sc:analyze --focus security --depth deep src/auth

성능 최적화 분석 (보고서 형식)

/sc:analyze --focus performance --format report

빠른 품질 검사

/sc:analyze --focus quality --depth quick src/components

아키텍처 심층 분석 (JSON 출력)

/sc:analyze --focus architecture --depth deep --format json

보안 빠른 스캔

/sc:analyze --focus security --depth quick

성능 심층 분석

/sc:analyze --focus performance --depth deep api/

품질 보고서 (심층)

/sc:analyze --focus quality --depth deep --format report src/

/sc:troubleshoot

기초

코드, 빌드, 배포 및 시스템 동작의 문제를 진단하고 해결합니다

구문

/sc:troubleshoot [옵션] "[문제-설명]"

옵션

플래그	값	설명
--type	bug, build, performance, deployment	문제 범주: 'bug', 'build', 'performance' 또는 'deployment'입니다.
--trace	-	실패 원인을 정확히 찾기 위해 상세한 실행 추적을 출력합니다.
--fix	-	식별된 문제에 대한 패치를 자동으로 적용하려고 시도합니다.

예제

버그 진단

/sc:troubleshoot --type bug "로그인 폼이 제출되지 않음"

빌드 문제

/sc:troubleshoot --type build --trace "CI에서 빌드 실패"

성능 문제

/sc:troubleshoot --type performance --fix "API 응답 느림"

/sc:reflect

기초

Serena MCP 분석 기능을 사용한 작업 반영 및 검증을 수행합니다

구문

/sc:reflect [옵션] [대상]

옵션

플래그	값	설명
--type	task, session, completion	반영 범위: 'task' (현재 항목), 'session' (기록) 또는 'completion' (목표 확인)입니다.
--analyze	-	숨겨진 패턴이나 위험을 발견하기 위해 철저한 추론을 수행합니다.
--validate	-	변경 사항을 적용한 후 검증 단계(예: 린터, 테스트)를 실행합니다.

예제

작업 반영

/sc:reflect --type task --analyze

세션 검토

/sc:reflect --type session

완료 검증

/sc:reflect --type completion --validate

유틸리티

2 개 명령

/sc:help

기초

사용 가능한 모든 /sc 명령과 기능을 나열합니다

구문

/sc:help [명령이름]

예제

모든 명령 도움말 표시

/sc:help

특정 명령 도움말

/sc:help implement

시스템 가이드

MCP 서버 통합

사용 가능한 서버

서버	목적	API 키	자동 활성화 트리거
context7	공식 라이브러리 문서	불필요	import 문, 프레임워크 키워드
sequential	다단계 추론	불필요	`--think`, 디버깅, 복잡한 분석
magic	UI 컴포넌트 생성	필요	`component`, `UI`, 프론트엔드 요청
playwright	브라우저 자동화	불필요	`test`, `e2e`, `browser`
morphllm	코드 변환	필요	다중 파일 편집, 리팩토링
serena	의미론적 코드 이해	불필요	대규모 프로젝트, 세션 관리
tavily	웹 검색	필요 (무료 티어)	`/sc:research`, `latest`
chrome-devtools	성능 분석	불필요	`performance`, `debug`

서버 조합

yaml

무료 (API 키 불필요):
  - context7 + sequential + playwright + serena

학습:
  - context7 + sequential

웹 개발:
  - magic + context7 + playwright

심층 연구:
  - tavily + sequential + serena

엔터프라이즈 리팩토링:
  - serena + morphllm + sequential

구성

MCP 서버는 ~/.claude.json에서 구성됩니다:

json

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    },
    "tavily": {
      "command": "npx",
      "args": ["-y", "tavily-mcp@latest"],
      "env": {"TAVILY_API_KEY": "${TAVILY_API_KEY}"}
    }
  }
}

모범 사례

1. 명령 선택 가이드

시나리오	권장 명령	이유
새 프로젝트 시작	`/sc:brainstorm`	구조화된 요구사항 발견
기능 구현	`/sc:implement`	지능형 페르소나 조정
코드 리뷰	`/sc:analyze`	다차원 분석
테스트 실행	`/sc:test`	커버리지 및 품질 보고
심층 연구	`/sc:research`	적응형 다중 소스 검색
일상 작업	`/sc:pm`	자동 오케스트레이션 (기본값)

2. 플래그 조합 패턴

bash

# 심층 보안 분석
/sc:analyze --focus security --depth deep

# 포괄적인 테스팅
/sc:test --type all --coverage

# 안전한 구현
/sc:implement "기능" --safe --with-tests

# 상세 연구
/sc:research "주제" --depth exhaustive --strategy unified

3. 워크플로우 패턴

새 기능 개발:

bash

/sc:brainstorm "기능 아이디어" --strategy systematic
/sc:design "기능" --type architecture
/sc:workflow "구현 계획"
/sc:implement "기능" --with-tests
/sc:test --coverage
/sc:document --type api

버그 수정:

bash

/sc:troubleshoot "버그 설명" --trace
/sc:analyze --focus quality --depth deep
/sc:implement "수정" --safe
/sc:test --type regression

코드 최적화:

bash

/sc:analyze --focus performance
/sc:improve --type performance --safe
/sc:cleanup --type all --interactive
/sc:test --coverage

4. 토큰 효율성

작업 복잡도	토큰 예산	권장 접근 방식
단순 (오타)	200	직접 수정
중간 (버그 수정)	1,000	신뢰도 확인
복잡 (새 기능)	2,500	전체 워크플로우

신뢰도 확인 ROI: 100-200 토큰 사용으로 5,000-50,000 토큰을 절약할 수 있습니다

빠른 참조 카드

핵심 명령

bash

# 발견 및 계획
/sc:brainstorm "아이디어"       # 구조화된 브레인스토밍
/sc:design "시스템"            # 아키텍처 설계
/sc:workflow "작업"            # 워크플로우 계획

# 개발
/sc:implement "기능"           # 코드 구현
/sc:improve path/              # 코드 개선
/sc:test --coverage            # 테스트 실행

# 연구
/sc:research "주제"            # 웹 연구
/sc:analyze path/              # 코드 분석

# 세션 관리
/sc:save "체크포인트"          # 세션 저장
/sc:load "세션"                # 세션 로드
/sc                            # 모든 명령 나열

일반 플래그

bash

--think         # 순차적 추론 활성화
--think-hard    # 심층 분석 활성화
--c7            # Context7 강제 활성화
--no-mcp        # MCP 서버 비활성화
--all-mcp       # 모든 MCP 서버 활성화
--coverage      # 테스트 커버리지 포함
--depth quick   # 연구 깊이 제어
--safe          # 안전 모드
--with-tests    # 테스트 포함
--interactive   # 대화형 모드

설치 및 업그레이드

설치

SuperClaude Framework CLI를 설치하려면:

bash

npm install -g @superclaude/cli

또는 npx를 통해 실행하려면:

bash

npx @superclaude/cli init

업그레이드

최신 버전으로 업그레이드하려면:

bash

npm update -g @superclaude/cli

버전 확인:

bash

/sc:version

명령 참조

버전: 4.1.9•총 명령 수: 29•업데이트: 2025년 12월

이 문서는 SuperClaude 프레임워크의 완전한 명령 참조 매뉴얼로, 모든 슬래시 명령에 대한 상세한 설명, 매개변수, 사용 예제 및 모범 사례를 포함합니다.

빠른 참조

분류	개 명령
개발	/sc:implement /sc:build /sc:improve /sc:cleanup /sc:git
문서화	/sc:document /sc:explain /sc:index
계획 및 요구사항	/sc:brainstorm /sc:design /sc:estimate /sc:workflow
프로젝트 관리	/sc:pm /sc:task /sc:spawn /sc:select-tool /sc:index-repo
연구 및 분석	/sc:research /sc:business-panel /sc:spec-panel
세션 관리	/sc:load /sc:save /sc:agent
테스팅 및 품질	/sc:test /sc:analyze /sc:troubleshoot /sc:reflect
유틸리티	/sc:help /sc:recommend

개발

5 개 명령

/sc:implement

고급

지능형 페르소나 활성화 및 MCP 통합을 통한 기능 및 코드 구현을 수행합니다

구문

/sc:implement [옵션] "[기능-설명]"

옵션

플래그	값	설명
--type	component, api, service, feature	아티팩트 유형을 지정합니다: 'component', 'api', 'service' 또는 'feature'입니다.
--framework	react, vue, express, etc.	코드 생성 패턴을 맞춤화하기 위해 대상 프레임워크(예: react, vue)를 지정합니다.
--safe	-	보수적 모드를 활성화합니다: 파괴적 변경을 피하고 호환성을 유지하는 업데이트에 집중합니다.
--with-tests	-	구현된 코드에 대한 단위 테스트 및 통합 테스트를 자동으로 생성합니다.

예제

React 컴포넌트 구현

/sc:implement --type component --framework react "사용자 프로필 컴포넌트"

API 서비스 구현 (안전 모드 + 테스트)

/sc:implement --type api --safe --with-tests "사용자 인증 API"

풀스택 기능

/sc:implement --type feature --with-tests "결제 처리 시스템"

Vue 프레임워크 컴포넌트

/sc:implement --type component --framework vue "대시보드 위젯"

Express 백엔드 서비스

/sc:implement --type service --framework express --safe "파일 업로드 서비스"

React 보안 컴포넌트 (테스트 포함)

/sc:implement --type component --framework react --safe --with-tests "관리자 패널"

Next.js 페이지 구현

/sc:implement --type feature --framework nextjs "사용자 설정 페이지"

순수 API 구현 (테스트 제외)

/sc:implement --type api "알림 엔드포인트"

/sc:build

고급

지능형 오류 처리 및 최적화를 통해 프로젝트를 빌드, 컴파일 및 패키징합니다

구문

/sc:build [옵션] [대상]

옵션

플래그	값	설명
--type	dev, prod, test	빌드 대상 환경: 'dev', 'prod' 또는 'test'입니다.
--clean	-	시작하기 전에 이전 빌드 아티팩트를 제거합니다.
--optimize	-	축소 및 트리 셰이킹과 같은 성능 최적화를 활성화합니다.
--verbose	-	내부 에이전트 결정 및 상태 변경에 대한 상세한 로깅을 활성화합니다.

예제

개발 빌드

/sc:build --type dev

프로덕션 빌드

/sc:build --type prod --clean --optimize

상세 빌드

/sc:build --verbose

/sc:improve

고급

코드 품질, 성능 및 유지보수성에 대한 체계적인 개선을 적용합니다

구문

/sc:improve [옵션] [대상]

옵션

플래그	값	설명
--type	quality, performance, maintainability, style	개선을 위한 초점 영역: 'quality', 'performance', 'maintainability' 또는 'style'입니다.
--safe	-	안전 모드 (보수적 개선)
--interactive	-	각 개선 제안을 적용하기 전에 사용자 승인을 요청합니다.
--preview	-	적용하지 않고 제안된 변경 사항에 대한 포괄적인 diff를 생성합니다.
--validate	-	변경 사항을 적용한 후 검증 단계(예: 린터, 테스트)를 실행합니다.

예제

품질 개선

/sc:improve --type quality src/auth

성능 최적화 (안전 모드)

/sc:improve --type performance --safe api/

대화형 스타일 개선

/sc:improve --type style --interactive components/

유지보수성 개선 (미리보기)

/sc:improve --type maintainability --preview src/utils

품질 개선 (검증 + 대화형)

/sc:improve --type quality --validate --interactive src/services

안전한 성능 최적화 (미리보기)

/sc:improve --type performance --safe --preview database/

포괄적인 품질 검토

/sc:improve --type quality --validate --safe src/

스타일 통합 (안전 + 미리보기)

/sc:improve --type style --safe --preview --validate components/

/sc:cleanup

고급

코드를 체계적으로 정리하고, 데드 코드를 제거하며, 프로젝트 구조를 최적화합니다

구문

/sc:cleanup [옵션] [대상]

옵션

플래그	값	설명
--type	code, imports, files, all	정리 대상: 'code' (포매팅), 'imports' (미사용), 'files' (임시), 또는 'all'입니다.
--safe	-	안전 모드 (보수적 정리)
--aggressive	-	코드 구조를 크게 변경할 수 있는 더 엄격한 정리 규칙을 적용합니다.
--interactive	-	대화형 정리
--preview	-	적용하지 않고 제안된 변경 사항에 대한 포괄적인 diff를 생성합니다.

예제

안전한 코드 정리

/sc:cleanup --type code --safe src/

import 정리

/sc:cleanup --type imports

포괄적인 대화형 정리

/sc:cleanup --type all --interactive

공격적인 파일 정리 (미리보기)

/sc:cleanup --type files --aggressive --preview

안전한 코드 정리 (미리보기)

/sc:cleanup --type code --safe --preview src/legacy

대화형 import 정리

/sc:cleanup --type imports --interactive

포괄적인 공격적 정리

/sc:cleanup --type all --aggressive

안전한 포괄적 정리 (미리보기 + 대화형)

/sc:cleanup --type all --safe --preview --interactive

/sc:git

기초

지능형 커밋 메시지 및 워크플로우 최적화를 통한 Git 작업을 수행합니다

구문

/sc:git [옵션] "[작업]"

옵션

플래그	값	설명
--smart-commit	-	AI를 사용하여 스테이징된 변경 사항을 분석하고 시맨틱 커밋 메시지를 생성합니다.
--interactive	-	단계별 프롬프트로 Git 워크플로우를 안내합니다.

예제

스마트 커밋

/sc:git --smart-commit

기능 브랜치 생성

/sc:git "feature/user-auth"

대화형 작업

/sc:git --interactive

문서화

3 개 명령

/sc:document

기초

컴포넌트, 함수, API 및 기능에 대한 집중적인 문서를 생성합니다

구문

/sc:document [옵션] [대상]

옵션

플래그	값	설명
--type	inline, external, api, guide	대상 형식: 'inline' (주석), 'external' (마크다운), 'api' (사양) 또는 'guide'입니다.
--style	brief, detailed	세부 수준: 'brief' (요약) 또는 'detailed' (전체 사양)입니다.

예제

인라인 문서화

/sc:document --type inline src/utils.ts

API 문서화

/sc:document --type api --style detailed api/

사용자 가이드

/sc:document --type guide --style brief

/sc:explain

기초

코드, 개념 및 시스템 동작에 대한 명확한 설명을 제공합니다

구문

/sc:explain [옵션] "[대상]"

옵션

플래그	값	설명
--level	basic, intermediate, advanced	대상 청중 전문성: 'basic', 'intermediate' 또는 'advanced'입니다.
--format	text, examples, interactive	설명 형식: 'text', 'examples' 또는 'interactive'입니다.
--context	[domain]	설명 컨텍스트를 특정 도메인(예: 'auth', 'database')으로 제한합니다.

예제

기본 설명

/sc:explain --level basic src/auth/middleware.ts

고급 상세 설명

/sc:explain --level advanced --format examples "JWT 인증 플로우"

대화형 설명

/sc:explain --format interactive "데이터베이스 최적화"

/sc:index

기초

포괄적인 프로젝트 문서 및 지식 베이스를 생성합니다

구문

/sc:index [옵션] [대상]

옵션

플래그	값	설명
--type	docs, api, structure, readme	생성할 인덱스 유형: 'docs', 'api', 'structure' 또는 'readme'입니다.
--format	md, json, yaml	결과 형식: 'text', 'json' 또는 'report'입니다.

예제

문서 인덱스

/sc:index --type docs

API 인덱스

/sc:index --type api --format json api/

프로젝트 구조 인덱스

/sc:index --type structure --format yaml

계획 및 요구사항

4 개 명령

/sc:brainstorm

고급

소크라테스식 대화와 체계적인 탐색을 통한 대화형 요구사항 발견을 수행합니다

구문

/sc:brainstorm [옵션] "[주제/아이디어]"

옵션

플래그	값	설명
--strategy	systematic, agile, enterprise	전략적 접근 방식을 선택합니다: 'systematic'은 철저함, 'agile'은 속도, 'enterprise'는 규모를 위한 것입니다.
--depth	shallow, normal, deep	분석 깊이를 제어합니다: 'shallow'는 빠른 스캔, 'deep'은 포괄적인 검토를 위한 것입니다.
--parallel	-	병렬 탐색 경로를 활성화합니다

예제

체계적인 제품 발견 (심층 분석)

/sc:brainstorm --strategy systematic --depth deep "AI 기반 프로젝트 관리 도구"

애자일 기능 탐색 (병렬 경로)

/sc:brainstorm --strategy agile --parallel "실시간 협업 기능"

엔터프라이즈 솔루션 검증

/sc:brainstorm --strategy enterprise "엔터프라이즈 데이터 분석 플랫폼"

빠른 얕은 탐색

/sc:brainstorm --depth shallow "모바일 앱 아이디어"

체계적인 병렬 심층 탐색

/sc:brainstorm --strategy systematic --depth deep --parallel "마이크로서비스 아키텍처"

애자일 반복 탐색

/sc:brainstorm --strategy agile --depth normal "사용자 인증 개선"

/sc:design

기초

시스템 아키텍처, API 및 컴포넌트 인터페이스를 포괄적인 사양과 함께 설계합니다

구문

/sc:design [옵션] [대상]

옵션

플래그	값	설명
--type	architecture, api, component, database	설계 유형
--format	diagram, spec, code	결과 형식: 'text', 'json' 또는 'report'입니다.

예제

시스템 아키텍처 설계

/sc:design --type architecture --format diagram user-management-system

API 사양 설계

/sc:design --type api --format spec payment-api

컴포넌트 인터페이스 설계

/sc:design --type component --format code notification-service

데이터베이스 스키마 설계

/sc:design --type database --format diagram e-commerce-db

/sc:estimate

기초

작업, 기능 또는 프로젝트에 대한 지능적인 개발 추정을 제공합니다

구문

/sc:estimate [옵션] "[대상]"

옵션

플래그	값	설명
--type	time, effort, complexity	추정 유형
--unit	hours, days, weeks	시간 단위
--breakdown	-	상세 분석을 활성화합니다

예제

시간 추정

/sc:estimate --type time --unit days "인증 시스템"

복잡도 분석

/sc:estimate --type complexity --breakdown "API 리팩토링"

/sc:workflow

고급

PRD 및 기능 요구사항으로부터 구조화된 구현 워크플로우를 생성합니다

구문

/sc:workflow [옵션] "[기능-설명]"

옵션

플래그	값	설명
--strategy	systematic, agile, enterprise	워크플로우 전략
--depth	shallow, normal, deep	워크플로우 깊이
--parallel	-	병렬 실행을 활성화합니다

예제

체계적인 워크플로우

/sc:workflow --strategy systematic "결제 통합"

애자일 반복 워크플로우

/sc:workflow --strategy agile --depth deep "사용자 온보딩"

프로젝트 관리

5 개 명령

/sc:pm

메타급

프로젝트 관리자 에이전트 - 모든 하위 에이전트를 조정하고 워크플로우를 원활하게 관리하는 기본 오케스트레이션 에이전트입니다

구문

/sc:pm [옵션] "[요청]"

옵션

플래그	값	설명
--strategy	brainstorm, direct, wave	실행 모드를 정의합니다: 'brainstorm'는 대화형 질문을 통한 탐색적 아이디어 도출 및 요구사항 발견(모호하거나 불명확한 요청에 이상적), 'direct'는 광범위한 계획 없이 즉각적인 구현(범위가 명확한 작업에 가장 적합), 또는 'wave'는 구조화된 구현 단계를 가진 단계별 배포(체계적인 진행이 필요한 복잡한 다단계 프로젝트에 최적). 요구사항 명확화가 필요할 때는 brainstorm, 직접적인 작업에는 direct, 대규모 변경에는 wave를 선택하세요.
--verbose	-	내부 에이전트 결정, 하위 에이전트 활성화, 워크플로우 상태 변경 및 위임 패턴에 대한 상세한 로깅을 활성화합니다. PM 에이전트의 추론 프로세스 이해, 워크플로우 문제 디버깅, 오케스트레이션 전략 학습 또는 특정 작업에 활성화된 전문가 에이전트 추적에 유용합니다. 전략 선택, 작업 분해 논리 및 실행 흐름에 대한 투명성을 제공합니다.

예제

기본 사용 (명령 불필요, 요구사항을 직접 설명하면 PM 에이전트가 자동으로 오케스트레이션을 처리합니다)

/sc:pm "앱에 결제 처리 기능 추가 필요"

명시적 전략 선택 (wave 전략 사용)

/sc:pm --strategy wave "애플리케이션 보안 개선"

브레인스토밍 모드 (PM 에이전트가 탐색 필요성 자동 감지)

/sc:pm "사용자 경험을 개선할 수 있을까요?"

명시적 브레인스토밍 전략 (요구사항 발견 강제)

/sc:pm --strategy brainstorm "대시보드에 새 기능 추가"

직접 전략 (명확한 요구사항의 즉각적인 구현)

/sc:pm --strategy direct "모바일에서 로그인 버튼 정렬 문제 수정"

상세 모드 (에이전트 오케스트레이션 결정 추적)

/sc:pm --verbose "API 레이어 리팩터링"

Wave 전략과 상세 로깅 (복잡한 프로젝트의 가시성)

/sc:pm --strategy wave --verbose "REST에서 GraphQL로 마이그레이션"

다단계 프로젝트 워크플로우 (인증 시스템)

/sc:pm --strategy wave "OAuth, 2FA 및 세션 관리를 포함한 완전한 사용자 인증 구현"

디버깅 워크플로우 (성능 조사)

/sc:pm --verbose "대시보드 로딩 성능 문제 조사 및 수정"

성능 최적화 프로젝트 (체계적인 개선)

/sc:pm --strategy wave "프론트엔드, 백엔드 및 데이터베이스 전반의 애플리케이션 성능 최적화"

/sc:task

고급

지능형 워크플로우 관리 및 위임을 통한 복잡한 작업 실행을 수행합니다

구문

/sc:task [옵션] "[작업-설명]"

옵션

플래그	값	설명
--strategy	systematic, agile, enterprise	작업 실행 접근 방식을 정의합니다: 'systematic'은 각 단계에서 포괄적인 계획과 검증을 수행하는 체계적인 단계별 진행(신중한 분석이 필요한 복잡하고 익숙하지 않은 작업에 가장 적합), 'agile'은 빈번한 검증 주기를 가진 반복적 빠른 개발(진화하는 요구사항이나 실험적 기능에 이상적), 또는 'enterprise'는 거버넌스, 문서화 및 팀 간 조정을 포함한 대규모 운영(여러 시스템에 영향을 미치는 미션 크리티컬 변경에 적합). 철저함을 위해 systematic, 속도와 유연성을 위해 agile, 조직 규모를 위해 enterprise를 선택하세요.
--parallel	-	작업을 종속성이 없는 하위 작업으로 분해할 수 있을 때 독립적인 작업의 병렬 실행을 활성화합니다. 전체 실행 시간을 줄이기 위해 동시 처리 기회를 자동으로 식별합니다. 다중 파일 편집, 일괄 작업 또는 명확한 구성 요소 경계를 가진 작업에 특히 효과적입니다. 속도를 최적화하고 작업에 순차적 종속성이 없을 때 사용하세요.
--delegate	-	작업 도메인과 복잡도에 따라 전문 하위 에이전트로의 지능형 위임을 활성화합니다. 작업 에이전트가 요구사항을 분석하고 하위 작업을 적절한 전문가에게 라우팅합니다(예: UI는 frontend-architect, 인증은 security-engineer, 최적화는 performance-engineer). 여러 도메인에 걸쳐 있거나 전문 지식이 필요한 복잡한 작업에 사용하세요. 전문가 수준의 실행을 통해 품질을 향상시킵니다.

예제

체계적인 작업 실행

/sc:task --strategy systematic "인증 구현"

병렬 작업 실행 및 위임

/sc:task --parallel --delegate "API 엔드포인트 리팩토링"

애자일 전략 (반복적 개발)

/sc:task --strategy agile "인터랙티브 데이터 시각화 대시보드 구축"

엔터프라이즈 전략 (대규모 마이그레이션)

/sc:task --strategy enterprise "50개 이상의 마이크로서비스를 Kubernetes로 마이그레이션"

병렬 실행 (독립적인 작업)

/sc:task --parallel "모든 컴포넌트 prop 타입을 TypeScript로 업데이트"

전문가에게 위임 (복잡한 도메인 작업)

/sc:task --delegate "메시징 기능을 위한 종단 간 암호화 구현"

체계적 + 병렬화 (철저함 + 빠름)

/sc:task --strategy systematic --parallel "레거시 코드베이스를 최신 패턴으로 리팩토링"

애자일 + 완전한 위임 및 병렬화 (빠른 다중 도메인 개발)

/sc:task --strategy agile --delegate --parallel "프론트엔드와 백엔드에 실시간 협업 기능 추가"

/sc:spawn

메타급

지능형 분해 및 위임을 통한 메타 시스템 작업 오케스트레이션을 수행합니다

구문

/sc:spawn [복잡한-작업] [옵션]

옵션

플래그	값	설명
--strategy	sequential, parallel, adaptive	작업 조정 방법을 정의합니다: 'sequential'(순차)은 각 단계가 다음 단계 시작 전에 완료되어야 하는 단계별 실행(엄격한 순서 요구사항이 있는 의존적 작업에 적합), 'parallel'(병렬)은 속도를 최대화하기 위한 독립적인 하위 작업의 동시 실행(명확한 경계와 의존성이 없는 작업에 가장 적합), 또는 'adaptive'(적응형)은 복잡도를 분석하고 자동으로 전략을 조정하는 지능형 동적 라우팅(혼합 의존성 패턴을 가진 복잡한 다중 도메인 프로젝트에 권장). 순서가 있는 워크플로우에는 sequential, 최대 처리량을 위해서는 parallel, 복잡도가 불확실한 경우에는 adaptive를 선택하세요.
--depth	normal, deep	작업 분해 세분화를 제어합니다: 'normal'(표준)은 주요 단계와 구성 요소에 대한 표준 분해를 제공(대부분의 구조가 명확한 프로젝트에 적합), 'deep'(심층)은 포괄적인 의존성 분석과 함께 세밀한 하위 작업으로 재귀적 분해를 수행(복잡한 레거시 시스템, 아키텍처 마이그레이션 또는 철저한 계획이 중요한 경우 필수). 일반적인 프로젝트에는 normal을, 최대한의 계획 세부 사항과 위험 완화를 위해서는 deep을 사용하세요.

예제

복잡한 기능 구현

/sc:spawn "사용자 인증 시스템 구현"

대규모 시스템 운영

/sc:spawn --strategy adaptive --depth deep "레거시 모놀리스를 마이크로서비스로 마이그레이션"

도메인 간 인프라

/sc:spawn "보안 스캔 포함 CI/CD 파이프라인 구축"

순차 전략 (순서가 있는 워크플로우)

/sc:spawn --strategy sequential "데이터베이스 스키마 재설계 및 프로덕션 데이터 마이그레이션"

병렬 전략 (독립적인 구성 요소)

/sc:spawn --strategy parallel "API 문서, 클라이언트 SDK 및 사용 분석을 동시에 구현"

표준 깊이 (표준 계획)

/sc:spawn --depth normal "애플리케이션에 다국어 지원 추가"

심층 분해 (포괄적 분석)

/sc:spawn --depth deep "모놀리스를 도메인 주도 마이크로서비스로 리팩터링"

병렬 + 표준 깊이 (빠른 표준 프로젝트)

/sc:spawn --strategy parallel --depth normal "iOS 및 Android 플랫폼용 모바일 앱 구축"

순차 + 심층 (복잡한 순서 마이그레이션)

/sc:spawn --strategy sequential --depth deep "레거시 COBOL 시스템을 클라우드 네이티브 아키텍처로 현대화"

작업 계층 구조 시각화

spawn 오케스트레이션은 다층 분해를 생성합니다:

레벨 1: 상위 단계 (PM Agent 조정)
  ├─ 레벨 2: 주요 구성 요소 (Task Agent 실행)
  │   ├─ 레벨 3: 구체적 구현 (전문가 에이전트)
  │   └─ 레벨 4: 세밀한 하위 작업 (depth=deep일 때만)

예시: "전자상거래 플랫폼 구축"
  ├─ 단계 1: 아키텍처 및 설계
  │   ├─ 데이터베이스 스키마 설계 (backend-architect)
  │   ├─ API 계약 정의 (backend-architect)
  │   └─ UI/UX 와이어프레임 (frontend-architect)
  ├─ 단계 2: 핵심 구현
  │   ├─ 제품 카탈로그 (backend + frontend)
  │   ├─ 장바구니 (backend + frontend)
  │   └─ 결제 통합 (security-engineer + backend)
  └─ 단계 3: 테스팅 및 배포
      ├─ E2E 테스트 (quality-engineer)
      └─ 프로덕션 배포 (devops-architect)

/sc:select-tool

기초

복잡도 점수 및 작업 분석을 기반으로 한 지능형 MCP 도구 선택을 수행합니다

구문

/sc:select-tool [옵션]

옵션

플래그	값	설명
--analyze	-	현재 프로젝트 컨텍스트, 작업 복잡도 및 사용 가능한 MCP 도구에 대한 심층 분석을 수행하여 최적의 도구 선택을 추천합니다. 평가 요소에는 코드베이스 크기, 작업 유형, 성능 요구사항 및 도구 기능이 포함됩니다. 복잡도 점수(0-1), 권장 도구 및 신뢰도를 출력합니다. 실행 전에 특정 시나리오에 가장 적합한 도구를 이해하는 데 사용하세요.
--explain	-	도구 선택 추천 뒤에 있는 상세한 추론 및 의사결정 논리를 제공합니다. 대안 대신 특정 도구가 선택된 이유를 트레이드오프 분석, 기능 매칭 및 효율성 고려사항을 포함하여 설명합니다. 사용자가 도구 선택 패턴을 학습하고 지능형 라우팅 시스템을 이해하는 데 도움이 되는 교육 모드입니다. 포괄적인 도구 선택 교육을 위해 --analyze와 결합하여 사용하세요.

예제

도구 선택 분석

/sc:select-tool --analyze

도구 선택 추론 설명

/sc:select-tool --explain

분석과 설명 결합 (학습 모드)

/sc:select-tool --analyze --explain

도구 선택을 사용한 성능 최적화 워크플로우

# 1단계: 성능 작업에 최적의 도구 분석
/sc:select-tool --analyze --explain

# 2단계: 권장 도구를 사용하여 실행
# (분석 기반: 분석에는 Sequential, 코드 탐색에는 Serena)

/sc:index-repo

기초

컨텍스트 최적화를 위한 리포지토리 인덱싱을 수행합니다 (94% 토큰 감소: 58K → 3K)

구문

/sc:index-repo [경로]

예제

현재 리포지토리 인덱싱

/sc:index-repo .

특정 디렉토리 인덱싱

/sc:index-repo src/

대규모 리포지토리 성능 지표

/sc:index-repo .

증분 재인덱싱 워크플로우

# 초기 인덱싱
/sc:index-repo .

# 주요 코드 변경 후 (예: 기능 브랜치 병합, 리팩토링)
/sc:index-repo .  # 프로젝트 이해도 업데이트를 위한 재인덱싱

# 특정 변경 영역에 대한 빠른 업데이트
/sc:index-repo src/features/authentication/

다중 모듈 프로젝트 인덱싱 전략

# 여러 패키지가 있는 모노레포
/sc:index-repo packages/backend/    # 백엔드 모듈 인덱싱
/sc:index-repo packages/frontend/   # 프론트엔드 모듈 인덱싱
/sc:index-repo packages/shared/     # 공유 유틸리티 인덱싱

# 또는 전체 모노레포를 한 번에 인덱싱
/sc:index-repo .                    # 종합 인덱싱

연구 및 분석

3 개 명령

/sc:research

고급

적응형 계획 및 지능형 검색을 통한 심층 웹 연구를 수행합니다

구문

/sc:research [옵션] "[쿼리]"

옵션

플래그	값	설명
--depth	quick, standard, deep, exhaustive	검색 깊이: 'quick' (요약), 'standard', 'deep' (포괄적) 또는 'exhaustive'입니다.
--strategy	planning, intent, unified	연구 접근 방식: 'planning', 'intent' 또는 'unified'입니다.

예제

기본 연구 (기본 깊이)

/sc:research "2024년 양자 컴퓨팅의 최신 개발 동향"

심층 경쟁 분석

/sc:research --depth deep "AI 코딩 어시스턴트의 경쟁 분석"

통합 전략 연구

/sc:research --strategy unified "분산 시스템 모범 사례"

빠른 사실 쿼리

/sc:research --depth quick "현재 React 버전"

학술 수준의 심층 연구

/sc:research --depth exhaustive "머신러닝 최적화 기법"

의도 계획 연구

/sc:research --strategy intent "클라우드 아키텍처 패턴"

심층 + 계획 조합

/sc:research --depth deep --strategy planning "마이크로서비스 보안 모범 사례"

표준 연구 (명시적)

/sc:research --depth standard "데이터베이스 확장 전략"

/sc:business-panel

고급

9명의 저명한 비즈니스 사상가와 함께하는 다중 전문가 비즈니스 전략 분석을 수행합니다

구문

/sc:business-panel [옵션] "[주제]"

옵션

플래그	값	설명
--mode	discussion, debate, socratic	분석 모드
--experts	[name1,name2,...]	전문가 선택

예제

시장 진입 전략 분석

/sc:business-panel --mode discussion "시장 진입 전략"

토론 모드

/sc:business-panel --mode debate --experts porter,godin "가격 책정 전략"

소크라테스식 탐색

/sc:business-panel --mode socratic "디지털 혁신"

/sc:spec-panel

고급

저명한 소프트웨어 엔지니어링 전문가와 함께하는 다중 전문가 사양 검토 및 개선을 수행합니다

구문

/sc:spec-panel [옵션] "[사양]"

옵션

플래그	값	설명
--mode	discussion, critique, socratic	검토 모드
--experts	[name1,name2,...]	전문가 선택
--focus	requirements, architecture, testing, compliance	검토 초점
--iterations	[N]	반복 횟수
--format	standard, structured, detailed	결과 형식: 'text', 'json' 또는 'report'입니다.

예제

요구사항 사양 검토

/sc:spec-panel --focus requirements "API 사양"

아키텍처 비평 모드

/sc:spec-panel --mode critique --focus architecture "마이크로서비스 설계"

상세 반복 검토

/sc:spec-panel --iterations 3 --format detailed "보안 정책"

소크라테스식 테스팅 검토

/sc:spec-panel --mode socratic --focus testing "테스트 커버리지 전략"

규정 준수 토론 검토

/sc:spec-panel --mode discussion --focus compliance "GDPR 요구사항"

전문가별 아키텍처 검토

/sc:spec-panel --experts fowler,beck --focus architecture "도메인 주도 설계"

다중 라운드 구조화된 요구사항 검토

/sc:spec-panel --iterations 5 --format structured --focus requirements "사용자 스토리"

비평 모드 테스팅 검토 (상세)

/sc:spec-panel --mode critique --focus testing --format detailed "통합 테스트"

포괄적인 사양 검토

/sc:spec-panel --mode discussion --focus requirements --iterations 3 --format detailed "시스템 사양"

세션 관리

3 개 명령

/sc:load

기초

프로젝트 컨텍스트 로딩을 위한 Serena MCP 통합을 통한 세션 생명주기 관리를 수행합니다

구문

/sc:load [대상] [옵션]

옵션

플래그	값	설명
--type	project, config, deps, checkpoint	로드 유형
--refresh	-	캐시를 새로 고침합니다
--analyze	-	분석을 활성화합니다

예제

프로젝트 컨텍스트 로드

/sc:load --type project src/

체크포인트 로드

/sc:load --type checkpoint "auth-feature"

새로 고침 및 분석

/sc:load --refresh --analyze

/sc:save

기초

세션 컨텍스트 지속성을 위한 Serena MCP 통합을 통한 세션 생명주기 관리를 수행합니다

구문

/sc:save [이름] [옵션]

옵션

플래그	값	설명
--type	session, learnings, context, all	저장 유형
--summarize	-	요약을 생성합니다
--checkpoint	-	체크포인트를 생성합니다

예제

세션 저장

/sc:save --type session "auth-complete"

학습 내용 저장

/sc:save --type learnings --summarize

체크포인트 생성

/sc:save --checkpoint "midpoint"

/sc:agent

고급

SC 에이전트 - 조사, 구현 및 검토의 전체 워크플로우를 오케스트레이션하는 세션 컨트롤러입니다

구문

예제

에이전트는 세션 시작 시 자동으로 시작되며, 사용자가 작업을 설명한 후 전체 워크플로우를 인계받습니다

/sc:agent # 수동 호출 불필요, 자동 활성화됨

테스팅 및 품질

4 개 명령

/sc:test

고급

커버리지 분석 및 자동화된 품질 보고서를 통해 테스트를 실행합니다

구문

/sc:test [옵션] [대상]

옵션

플래그	값	설명
--type	unit, integration, e2e, all	테스트 범위: 'unit', 'integration', 'e2e' 또는 'all'입니다.
--coverage	-	테스트되지 않은 라인을 식별하는 코드 커버리지 보고서를 생성합니다.
--watch	-	파일 변경이 감지되면 테스트를 자동으로 다시 실행합니다.
--fix	-	포매팅 또는 스냅샷 불일치와 같은 사소한 테스트 실패를 자동으로 해결하려고 시도합니다.

예제

기본 테스트 실행

/sc:test

단위 테스트 커버리지 분석

/sc:test --type unit --coverage src/components

엔드투엔드 브라우저 테스팅

/sc:test --type e2e

개발 감시 모드 (자동 수정)

/sc:test --watch --fix

통합 테스팅

/sc:test --type integration

포괄적인 테스팅 (커버리지 포함)

/sc:test --type all --coverage

단위 테스트 감시 모드

/sc:test --type unit --watch

E2E 테스팅 (자동 수정)

/sc:test --type e2e --fix

커버리지 감시 모드

/sc:test --coverage --watch

/sc:analyze

기초

품질, 보안, 성능 및 아키텍처 도메인 전반에 걸친 포괄적인 코드 분석을 수행합니다

구문

/sc:analyze [옵션] [대상]

옵션

플래그	값	설명
--focus	quality, security, performance, architecture	분석할 도메인: 'quality', 'security', 'performance' 또는 'architecture'입니다.
--depth	quick, deep	분석 깊이를 제어합니다: 'shallow'는 빠른 스캔, 'deep'은 포괄적인 검토를 위한 것입니다.
--format	text, json, report	결과 형식: 'text', 'json' 또는 'report'입니다.

예제

포괄적인 프로젝트 분석

/sc:analyze

집중 보안 평가 (심층)

/sc:analyze --focus security --depth deep src/auth

성능 최적화 분석 (보고서 형식)

/sc:analyze --focus performance --format report

빠른 품질 검사

/sc:analyze --focus quality --depth quick src/components

아키텍처 심층 분석 (JSON 출력)

/sc:analyze --focus architecture --depth deep --format json

보안 빠른 스캔

/sc:analyze --focus security --depth quick

성능 심층 분석

/sc:analyze --focus performance --depth deep api/

품질 보고서 (심층)

/sc:analyze --focus quality --depth deep --format report src/

/sc:troubleshoot

기초

코드, 빌드, 배포 및 시스템 동작의 문제를 진단하고 해결합니다

구문

/sc:troubleshoot [옵션] "[문제-설명]"

옵션

플래그	값	설명
--type	bug, build, performance, deployment	문제 범주: 'bug', 'build', 'performance' 또는 'deployment'입니다.
--trace	-	실패 원인을 정확히 찾기 위해 상세한 실행 추적을 출력합니다.
--fix	-	식별된 문제에 대한 패치를 자동으로 적용하려고 시도합니다.

예제

버그 진단

/sc:troubleshoot --type bug "로그인 폼이 제출되지 않음"

빌드 문제

/sc:troubleshoot --type build --trace "CI에서 빌드 실패"

성능 문제

/sc:troubleshoot --type performance --fix "API 응답 느림"

/sc:reflect

기초

Serena MCP 분석 기능을 사용한 작업 반영 및 검증을 수행합니다

구문

/sc:reflect [옵션] [대상]

옵션

플래그	값	설명
--type	task, session, completion	반영 범위: 'task' (현재 항목), 'session' (기록) 또는 'completion' (목표 확인)입니다.
--analyze	-	숨겨진 패턴이나 위험을 발견하기 위해 철저한 추론을 수행합니다.
--validate	-	변경 사항을 적용한 후 검증 단계(예: 린터, 테스트)를 실행합니다.

예제

작업 반영

/sc:reflect --type task --analyze

세션 검토

/sc:reflect --type session

완료 검증

/sc:reflect --type completion --validate

유틸리티

2 개 명령

/sc:help

기초

사용 가능한 모든 /sc 명령과 기능을 나열합니다

구문

/sc:help [명령이름]

예제

모든 명령 도움말 표시

/sc:help

특정 명령 도움말

/sc:help implement

시스템 가이드

MCP 서버 통합

사용 가능한 서버

서버	목적	API 키	자동 활성화 트리거
context7	공식 라이브러리 문서	불필요	import 문, 프레임워크 키워드
sequential	다단계 추론	불필요	`--think`, 디버깅, 복잡한 분석
magic	UI 컴포넌트 생성	필요	`component`, `UI`, 프론트엔드 요청
playwright	브라우저 자동화	불필요	`test`, `e2e`, `browser`
morphllm	코드 변환	필요	다중 파일 편집, 리팩토링
serena	의미론적 코드 이해	불필요	대규모 프로젝트, 세션 관리
tavily	웹 검색	필요 (무료 티어)	`/sc:research`, `latest`
chrome-devtools	성능 분석	불필요	`performance`, `debug`

서버 조합

yaml

무료 (API 키 불필요):
  - context7 + sequential + playwright + serena

학습:
  - context7 + sequential

웹 개발:
  - magic + context7 + playwright

심층 연구:
  - tavily + sequential + serena

엔터프라이즈 리팩토링:
  - serena + morphllm + sequential

구성

MCP 서버는 ~/.claude.json에서 구성됩니다:

json

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    },
    "tavily": {
      "command": "npx",
      "args": ["-y", "tavily-mcp@latest"],
      "env": {"TAVILY_API_KEY": "${TAVILY_API_KEY}"}
    }
  }
}

모범 사례

1. 명령 선택 가이드

시나리오	권장 명령	이유
새 프로젝트 시작	`/sc:brainstorm`	구조화된 요구사항 발견
기능 구현	`/sc:implement`	지능형 페르소나 조정
코드 리뷰	`/sc:analyze`	다차원 분석
테스트 실행	`/sc:test`	커버리지 및 품질 보고
심층 연구	`/sc:research`	적응형 다중 소스 검색
일상 작업	`/sc:pm`	자동 오케스트레이션 (기본값)

2. 플래그 조합 패턴

bash

# 심층 보안 분석
/sc:analyze --focus security --depth deep

# 포괄적인 테스팅
/sc:test --type all --coverage

# 안전한 구현
/sc:implement "기능" --safe --with-tests

# 상세 연구
/sc:research "주제" --depth exhaustive --strategy unified

3. 워크플로우 패턴

새 기능 개발:

bash

/sc:brainstorm "기능 아이디어" --strategy systematic
/sc:design "기능" --type architecture
/sc:workflow "구현 계획"
/sc:implement "기능" --with-tests
/sc:test --coverage
/sc:document --type api

버그 수정:

bash

/sc:troubleshoot "버그 설명" --trace
/sc:analyze --focus quality --depth deep
/sc:implement "수정" --safe
/sc:test --type regression

코드 최적화:

bash

/sc:analyze --focus performance
/sc:improve --type performance --safe
/sc:cleanup --type all --interactive
/sc:test --coverage

4. 토큰 효율성

작업 복잡도	토큰 예산	권장 접근 방식
단순 (오타)	200	직접 수정
중간 (버그 수정)	1,000	신뢰도 확인
복잡 (새 기능)	2,500	전체 워크플로우

신뢰도 확인 ROI: 100-200 토큰 사용으로 5,000-50,000 토큰을 절약할 수 있습니다

빠른 참조 카드

핵심 명령

bash

# 발견 및 계획
/sc:brainstorm "아이디어"       # 구조화된 브레인스토밍
/sc:design "시스템"            # 아키텍처 설계
/sc:workflow "작업"            # 워크플로우 계획

# 개발
/sc:implement "기능"           # 코드 구현
/sc:improve path/              # 코드 개선
/sc:test --coverage            # 테스트 실행

# 연구
/sc:research "주제"            # 웹 연구
/sc:analyze path/              # 코드 분석

# 세션 관리
/sc:save "체크포인트"          # 세션 저장
/sc:load "세션"                # 세션 로드
/sc                            # 모든 명령 나열

일반 플래그

bash

--think         # 순차적 추론 활성화
--think-hard    # 심층 분석 활성화
--c7            # Context7 강제 활성화
--no-mcp        # MCP 서버 비활성화
--all-mcp       # 모든 MCP 서버 활성화
--coverage      # 테스트 커버리지 포함
--depth quick   # 연구 깊이 제어
--safe          # 안전 모드
--with-tests    # 테스트 포함
--interactive   # 대화형 모드

설치 및 업그레이드

설치

SuperClaude Framework CLI를 설치하려면:

bash

npm install -g @superclaude/cli

또는 npx를 통해 실행하려면:

bash

npx @superclaude/cli init

업그레이드

최신 버전으로 업그레이드하려면:

bash

npm update -g @superclaude/cli

버전 확인:

bash

/sc:version