SuperClaude++ v2.0

Claude Code를 위한 시스템 강제 개발 프레임워크 - 120개 스킬, 23개 에이전트, 16개 훅 타입으로 생산성과 코드 품질을 자동화합니다.

About

SuperClaude++는 SuperClaude Framework를 기반으로 개인 사용에 맞게 확장한 프로젝트입니다. 원본 SuperClaude의 강력한 구조 위에 다양한 커뮤니티 베스트 프랙티스, 자동화 워크플로우, 전문가 에이전트 시스템을 통합하여 Claude Code의 잠재력을 최대한 끌어냅니다.

v2.0 패러다임 전환

v0.x: "Claude야, 이 규칙 읽고 따라줘"  (prompt-dependent)
v2.0: "시스템이 규칙을 강제한다"         (system-enforced)

v0.x에서는 CLAUDE.md에 규칙을 적어두고 Claude가 이를 읽고 따르기를 기대했습니다. v2.0에서는 skill-rules.json + settings.json 훅 시스템이 규칙 실행을 기계적으로 강제합니다. Circuit Breaker가 동일 에러 3회 반복을 자동 차단하고, Prompt Injection Scanner가 MCP 응답을 실시간 검사하며, Skill Matcher가 프롬프트 패턴에 따라 스킬을 자동 활성화합니다.

태그라인: Harness Engineering이 자기 자신에게 적용되는 프레임워크

Features

Core Framework

파일	설명
CLAUDE.md	엔트리 포인트 및 언어 설정 (한국어)
FLAGS.md	행동 플래그 시스템 (`--think`, `--ultrathink`, `--uc` 등)
RULES.md	개발 규칙 및 자동화 트리거 (Karpathy Guidelines + Harness Engineering 통합)
PRINCIPLES.md	SOLID, DRY, KISS, YAGNI, Search Before Building 등 엔지니어링 원칙
MODES.md	상황별 행동 모드 (Brainstorming, Orchestration, Harness, Token Efficiency 등)
MCP_SERVERS.md	MCP 서버 통합 가이드 (Context7, Magic, Serena 등)
CONTEXTS.md	DEV/REVIEW/RESEARCH/PLANNING 컨텍스트 모드
CONVENTIONS.md	네이밍 컨벤션 + 패키지 관리 규칙 (uv/pnpm 필수)
PATTERNS.md	재사용 가능한 코드 패턴 모음
KNOWLEDGE.md	축적된 인사이트 및 트러블슈팅 가이드

Agent System (23개)

v2.0에서 에이전트는 AGENT.md frontmatter로 정의됩니다. model, tools, maxTurns, effort, isolation 등의 속성을 선언적으로 지정하여, 에이전트 행동이 프롬프트 의존이 아닌 시스템 수준에서 제어됩니다.

# 예시: agents/backend-architect.md
---
name: backend-architect
model: opus
tools: Read, Grep, Glob, Write, Edit, Bash, WebFetch
disallowedTools: Agent
maxTurns: 20
effort: high
skills: [api-design, db-design, security-audit]
---

Agent	역할	model	isolation
`backend-architect`	백엔드 시스템 설계	opus	-
`frontend-architect`	UI/UX 및 프론트엔드 아키텍처	sonnet	-
`system-architect`	시스템 아키텍처 설계	opus	-
`security-engineer`	보안 취약점 분석 (Read-only)	opus	-
`performance-engineer`	성능 최적화	sonnet	-
`quality-engineer`	테스트 및 QA	sonnet	-
`python-expert`	Python 전문가	sonnet	worktree
`refactoring-expert`	코드 리팩토링	sonnet	worktree
`deep-research-agent`	심층 리서치 (WebFetch/WebSearch)	opus	-
`root-cause-analyst`	근본 원인 분석 (Read-only)	opus	-
`codebase-gc`	코드베이스 정리 (dead code, import, doc-code 동기화)	haiku	-
`pm-agent`	프로젝트 관리	sonnet	-
`technical-writer`	기술 문서 작성	sonnet	-
`requirements-analyst`	요구사항 분석	sonnet	-
`devops-architect`	DevOps 및 인프라	sonnet	-
`learning-guide`	학습 가이드	haiku	-
`socratic-mentor`	소크라틱 멘토	sonnet	-
`business-panel-experts`	비즈니스 전략 분석 (9명의 전문가 패널)	opus	-
`generator`	Generator+Validator 쌍 - 코드 생성 담당	sonnet	worktree
`validator`	Generator+Validator 쌍 - Read-only 검증 담당	sonnet	-
`harness-worker`	Harness Mode worktree 워커	sonnet	worktree
`team-implementer`	Agent Teams 구현 담당	sonnet	worktree
`team-reviewer`	Agent Teams 리뷰 담당 (Read-only)	opus	-

Skills (120개)

모든 스킬은 skills/ 단일 디렉토리 아래 각각의 폴더에 SKILL.md로 정의됩니다. v0.x의 commands/ 디렉토리는 완전히 폐기되었으며, 모든 커맨드가 skills/로 통합되었습니다.

Core Skills

Skill	설명
`/confidence-check`	구현 전 신뢰도 평가 (>=90% 필요)
`/verify`	완료 후 6단계 검증 체크리스트 + Dynamic Context Injection
`/checkpoint`	위험 작업 전 복원 지점 생성
`/note`	컴팩션에서 살아남는 영구 메모 시스템
`/learn`	재사용 가능한 패턴 추출 및 저장
`/audit`	프로젝트 고유 규칙 검증 (비즈니스 로직, 아키텍처 패턴)
`/config-doctor`	SuperClaude++ 설정 유효성 검증 (v2.0 신규)

Development Skills

Skill	설명
`/react-best-practices`	React/Next.js 코드 리뷰 (40+ 규칙)
`/web-design-guidelines`	Vercel UI/UX 리뷰 (100+ 규칙) + AI Slop Detection
`/composition-patterns`	React Compound Components 패턴
`/python-best-practices`	Python 코드 리뷰 및 베스트 프랙티스
`/pytest-runner`	pytest 실행, 커버리지 분석
`/uv-package`	uv 패키지 관리
`/feature-planner`	기능 구현 계획 수립
`/gap-analysis`	설계-구현 비교, Match Rate 계산
`/tdd`	RED-GREEN-REFACTOR 주기 강제 + Git checkpoint
`/ui-ux-pro-max`	AI 디자인 인텔리전스 (67 스타일, 96 팔레트, 57 폰트)
`/fix-pr`	PR 코멘트 기반 자동 수정 (v2.0 신규)

Document Skills

Skill	설명
`/docx`	Word 문서 생성/편집 (OOXML 기반)
`/pdf`	PDF 폼 처리 및 조작
`/pptx`	PowerPoint 프레젠테이션 생성
`/xlsx`	Excel 스프레드시트 처리

Domain Skills

Architecture: /architecture, /api-design, /db-design, /design-patterns, /clean-arch, /hexagonal, /ddd, /cqrs
Security: /security-audit (OWASP + STRIDE + LLM Security), /auth, /error-handling
Performance: /perf-optimize, /caching, /scaling
Frontend: /react-best-practices, /nextjs, /vue, /svelte, /remix, /responsive, /a11y, /seo, /state
Backend: /fastapi, /nestjs, /graphql, /websocket, /queue, /pagination, /rate-limit
DevOps: /docker, /cicd, /monitoring, /env, /logging, /backup
Quality: /clean-code, /refactoring, /testing, /code-review, /code-smell, /naming, /solid

Automation

Skill Auto-Activation (v2.0 핵심)

v2.0에서 스킬 자동 활성화는 .claude/skill-rules.json에 선언적으로 정의되고, scripts/skill-matcher.py가 UserPromptSubmit 훅으로 실행하여 프롬프트 패턴을 매칭합니다. Claude의 판단에 의존하던 v0.x와 달리, 기계적으로 트리거됩니다.

// .claude/skill-rules.json (발췌) — 57 rules, 332 triggers (200 Korean + 132 English)
{
  "skill": "build-fix",
  "mode": "auto",
  "triggers": {
    "prompt_patterns": [
      "error TS\\d+", "Build failed",
      "빌드 에러", "빌드 실패", "에러 났어", "안 돌아가"
    ],
    "exit_codes": [1]
  },
  "cooldown": 300
}

Auto-Invoke 스킬 (확인 없이 즉시 실행):

build-fix - 빌드 에러 패턴 감지 시
confidence-check - 구현 키워드 + 난이도 Medium 이상
verify - 완료/커밋 키워드 감지 시
checkpoint - 리팩토링/삭제 키워드 감지 시
react-best-practices - .jsx/.tsx + 리뷰 키워드
python-best-practices - .py + 리뷰 키워드
debug - 테스트 실패 패턴 감지 시

Suggest 스킬 (확인 후 실행):

tdd - 버그 수정 + tests/ 디렉토리 존재 시
security-audit - 보안 관련 키워드/파일 패턴 감지 시
code-smell - 50줄 이상 함수 감지 시

전체 규칙은 .claude/skill-rules.json 참조.

Proactive Suggestions

작업 컨텍스트에 맞는 스킬/에이전트/MCP 서버를 적극 제안 (확인 후 실행):

상황	제안 도구	트리거 조건
복잡한 함수	`/code-review`, `/code-smell`	50줄+ 함수
API 설계	`/api-design`, `backend-architect`	endpoint, REST
성능 이슈	`performance-engineer`	느림, slow, optimize
보안 관련	`security-engineer`, `/security-audit`	로그인, JWT, 보안, LLM 보안
프레임워크	Context7 MCP	React, Next.js, Vue
UI 컴포넌트	Magic MCP	button, form, modal
복잡한 분석	Sequential MCP	디버깅 3회+, 설계
프로젝트 규칙 검증	`/audit`	commit, PR + `.claude/audit-rules/` 존재 시
테스트 가능 기능	`/tdd`	새 기능 + tests/ 존재, 버그 수정
UI/UX 디자인	`/ui-ux-pro-max`	landing page, 디자인 시스템

제안 강도 플래그: --suggest-all (기본) | --suggest-minimal | --suggest-off

Hook System (16개 타입)

config/settings.json에서 16개 훅 타입을 통해 자동화를 구성합니다.

Hook Type	역할
`UserPromptSubmit`	프롬프트 제출 시 skill-matcher 실행, 사전 노트 저장
`PostToolUse`	파일 작성 후 타입 체크, 포맷팅, 컨벤션 체크, injection 스캔
`PreToolUse`	편집 전 컴팩션 제안
`Stop`	TODO 미완료 방지, 세션 평가, circuit breaker
`SessionStart`	세션 시작 알림
`SessionEnd`	세션 종료 알림
`SubagentStart`	서브에이전트 시작 알림
`SubagentStop`	서브에이전트 종료 + 결과 품질 게이트
`TaskCompleted`	자동 Two-Stage Review 트리거
`PreCompact`	컴팩션 전 상태 보존
`Notification`	알림 이벤트
`PermissionRequest`	권한 요청 이벤트
`PostToolUseFailure`	도구 실행 실패 시 알림
`FileChanged`	.env 파일 등 민감 파일 변경 경고
`ConfigChange`	설정 변경 시 유효성 검증
`InstructionsLoaded`	프로젝트별 설정 자동 적용

v2.0 안전장치

기능	설명
Circuit Breaker	동일 에러 3회 반복 감지 시 자동 중단 + Architecture Alert (Stop 훅)
Prompt Injection Scanner	MCP 응답에서 instruction injection, data exfiltration 패턴 스캔 (PostToolUse 훅)
Skill Matcher	프롬프트 패턴 기반 스킬 자동 활성화 (UserPromptSubmit 훅)
Config Doctor	AGENT.md frontmatter, skill-rules.json, 훅 경로 유효성 검증

Sound Notifications (peon-ping)

peon-ping 연동으로 AI 코딩 에이전트 이벤트를 게임 캐릭터 음성으로 알림합니다.

기능	설명
오디오 알림	작업 완료, 에러, 입력 요청 시 게임 캐릭터 보이스 재생
데스크톱 오버레이	macOS JXA 기반 화면 상단 배너 (멀티스크린 지원)
모바일 푸시	ntfy.sh / Pushover / Telegram 연동
MCP 서버	Claude가 대화 중 `play_sound` tool로 직접 사운드 재생

설치된 사운드 팩: Orc Peon, Human Peasant, GLaDOS (Portal), Sarah Kerrigan (StarCraft), Battlecruiser

Quick controls:

peon toggle           # 음소거/해제
peon volume 0.7       # 볼륨 조절
peon packs use glados # 팩 변경
/peon-ping-toggle     # Claude Code 내에서 토글

Flags & Modes

Analysis Depth

Flag	토큰	용도
`--think`	~4K	중간 복잡도
`--think-hard`	~10K	아키텍처 분석
`--ultrathink`	~32K	시스템 재설계

MCP Server Flags

Flag	서버	용도
`--c7`	Context7	공식 문서 조회
`--magic`	Magic	UI 컴포넌트 생성
`--seq`	Sequential	다단계 추론
`--serena`	Serena	시맨틱 코드 이해
`--tavily`	Tavily	웹 검색/리서치

Context Modes

Flag	모드	특성
`--ctx dev`	개발	작동 > 완벽, 코드 먼저
`--ctx review`	리뷰	심층 분석, 심각도별 정리
`--ctx research`	리서치	완전성 > 속도, 증거 기반

Harness Mode

Flag	용도
`--harness`	에이전트 주도 구현 (5-Phase: Intent - Scaffold - Implement - Verify - Deliver)
`--harness --orchestrate`	병렬 에이전트 최대 활용
`--harness --safe-mode`	모든 Phase에서 사용자 확인

Proactive Suggestion Flags

Flag	설명
`--suggest-all`	모든 관련 도구 적극 제안 (기본값)
`--suggest-minimal`	핵심 도구만 제안
`--suggest-off`	자동 제안 비활성화
`--auto-agent`	에이전트 자동 제안 활성화
`--auto-mcp`	MCP 서버 자동 활성화 제안

Installation

Plugin Install (권장)

/plugin install github:excatt/superclaude-plusplus

Claude Code 내에서 위 명령어를 실행하면 plugin.json 매니페스트에 따라 스킬, 에이전트, 훅, 스크립트가 자동 설치됩니다.

Manual Install

git clone https://github.com/excatt/superclaude-plusplus.git
cd superclaude-plusplus
scripts/sync-global.sh

설치 후

Claude Code 재시작 - 변경 사항 적용
/config-doctor - 설정 유효성 검증
/note --show - 노트 시스템 확인
기존 settings.json이 있었다면 hooks 설정 병합 필요

Directory Structure

superclaude-plusplus/                # 프로젝트 저장소 (source of truth)
├── plugin.json                     # Plugin manifest (v2.0 설치 진입점)
├── CLAUDE.md                       # 메인 엔트리 포인트
├── FLAGS.md                        # 플래그 시스템
├── RULES.md                        # 행동 규칙
├── PRINCIPLES.md                   # 엔지니어링 원칙
├── MODES.md                        # 행동 모드
├── MCP_SERVERS.md                  # MCP 서버 가이드
├── CONTEXTS.md                     # 컨텍스트 모드
├── CONVENTIONS.md                  # 네이밍 컨벤션
├── PATTERNS.md                     # 코드 패턴
├── KNOWLEDGE.md                    # 인사이트/트러블슈팅
├── notepad.md                      # 영구 메모
├── skills/                         # 120개 스킬 (각각 SKILL.md)
│   ├── confidence-check/SKILL.md
│   ├── verify/SKILL.md
│   ├── tdd/SKILL.md
│   ├── config-doctor/SKILL.md      # v2.0 신규
│   ├── fix-pr/SKILL.md             # v2.0 신규
│   ├── ui-ux-pro-max/              # AI 디자인 인텔리전스 (BM25 검색)
│   ├── web-design-guidelines/      # UI/UX 리뷰
│   └── ...                         # 120개 스킬 디렉토리
├── agents/                         # 23개 에이전트 (AGENT.md frontmatter)
│   ├── backend-architect.md
│   ├── generator.md                # v2.0 신규 (Generator+Validator)
│   ├── validator.md                # v2.0 신규 (Generator+Validator)
│   ├── harness-worker.md           # v2.0 신규 (Worktree 워커)
│   ├── team-implementer.md         # v2.0 신규 (Agent Teams)
│   ├── team-reviewer.md            # v2.0 신규 (Agent Teams)
│   └── ...                         # 23개 에이전트 정의
├── scripts/                        # 17개 자동화 스크립트
│   ├── skill-matcher.py            # v2.0: UserPromptSubmit hook 핸들러
│   ├── circuit-breaker.sh          # v2.0: 에러 반복 자동 차단
│   ├── injection-scanner.py        # v2.0: MCP injection 방어
│   ├── statusline.sh               # 상태바 스크립트
│   ├── checklist.sh                # 프로젝트 검증 (P0-P4)
│   ├── convention-check.sh         # 네이밍 컨벤션 자동 체크
│   ├── type-check.sh               # 타입 체크
│   ├── auto-format.sh              # 자동 포맷팅
│   ├── session-summary.py          # 세션 요약 자동 생성
│   └── ...                         # 17개 스크립트
├── config/                         # 설정 파일
│   ├── settings.json               # 16개 hook 타입 + 권한 + MCP 설정
│   └── peon-ping.json              # peon-ping 설정 (포터블)
├── .claude/                        # Claude Code 내부 설정
│   ├── skill-rules.json            # v2.0: 스킬 자동 활성화 규칙
│   ├── settings.local.json         # 로컬 설정 오버라이드
│   ├── context.md                  # 프로젝트 컨텍스트
│   └── state/                      # 세션 상태 저장
├── optional/                       # 23개 선택적 로딩 문서
│   ├── MCP_*.md                    # MCP 서버별 상세 가이드 (7개)
│   ├── MODE_*.md                   # MODE별 상세 가이드 (8개)
│   ├── BUSINESS_PANEL_EXAMPLES.md  # 비즈니스 패널 예제
│   ├── BUSINESS_SYMBOLS.md         # 비즈니스 심볼
│   ├── REASONING_TEMPLATES.md      # 구조화된 추론 템플릿
│   ├── CONTEXT_BUDGET.md           # 컨텍스트 예산 관리
│   ├── WORKER_TEMPLATES.md         # 워커 에이전트 프롬프트 템플릿
│   └── ...                         # 23개 문서
├── docs/
│   └── PLAN-v2.0.md                # v2.0 마이그레이션 계획
└── templates/                      # PDCA 템플릿
    ├── plan.template.md
    ├── design.template.md
    ├── analysis.template.md
    └── report.template.md

Key Concepts

v2.0 Core: System-Enforced Automation

v2.0의 핵심은 Claude의 자율 판단 의존을 줄이고, 시스템이 규칙을 강제하는 것입니다.

영역	v0.x (prompt-dependent)	v2.0 (system-enforced)
스킬 트리거	CLAUDE.md 키워드 테이블	`skill-rules.json` + `UserPromptSubmit` hook
에이전트 설정	프롬프트 텍스트	AGENT.md frontmatter (model, effort, isolation)
검증 자동화	"리뷰해줘" 요청	`TaskCompleted` hook -> auto Two-Stage Review
안전장치	3회 실패 규칙 (Claude 판단)	Circuit breaker hook (기계적 중단)
스킬 컨텍스트	정적 텍스트	Dynamic Context Injection
병렬 작업	프롬프트 "background로"	Worktree 격리 + Agent Teams
배포	~~install.sh~~	Plugin manifest (`/plugin install`)
스킬 구조	~~commands/~~ + skills/ 분리	skills/ 단일 디렉토리 (120개)

Generator + Validator 패턴

v2.0에서 도입된 에이전트 쌍 패턴입니다. Generator가 Worktree에서 코드를 생성하고, Validator가 Read-only로 검증합니다.

Generator (worktree) -> 생성 완료 -> Validator (Read-only 검증) -> Pass/Fail -> 수정/완료

Generator는 Write/Edit 가능, Validator는 Read/Grep/Bash만 허용
생성과 검증의 관심사 분리로 품질 향상

Worktree Isolation

병렬 에이전트가 서로의 작업에 영향을 주지 않도록 Git worktree로 격리합니다.

Orchestrator (main context)
    |
    ├─ Agent(isolation: worktree) -> Feature A
    ├─ Agent(isolation: worktree) -> Feature B
    └─ Agent(isolation: worktree) -> Feature C
    |
    └─ Merge results -> Two-Stage Review

Agent Teams (실험적)

Claude Code의 Agent Teams 기능과 통합하여 팀 단위 자율 작업을 지원합니다.

Team Lead (Orchestrator)
    |
    ├─ Teammate: implementer (worktree, sonnet)
    ├─ Teammate: reviewer (Read-only, opus)
    └─ Teammate: tester (sonnet)

활성화: settings.json에서 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

PDCA Workflow

체계적인 개발 사이클을 위한 Plan-Do-Check-Act 워크플로우:

Plan -> Design -> Do -> Check -> Act -> Report

Match Rate 기반 품질 게이트: >=90% 통과, 70-89% 자동 수정, <70% 설계 재검토
Gap Analysis: 설계 문서와 구현 코드 자동 비교
템플릿 제공: plan.template.md, design.template.md, analysis.template.md, report.template.md

Two-Stage Review System

작업 완료 시 TaskCompleted 훅에 의해 자동 트리거됩니다.

Stage	목적	검증 항목
Stage 1: Spec Compliance	요구사항 준수	누락 기능, 과잉 구현, 스펙 일치
Stage 2: Code Quality	코드 품질	Critical/Important/Minor 이슈
Stage 3: Cascade Impact	연쇄 영향 (Complex 전용)	다른 모듈/기능 깨짐 여부

Reviewer 원칙: "DO NOT trust the implementer's report" - 실제 코드 직접 확인
Confidence Filter: 80% 미만 신뢰도 이슈는 Minor(informational)로 분류

Verification Iron Law

완료 주장 시 자동 검증 게이트:

"NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE"

검증 타입	필수 증거
테스트 통과	실제 출력 로그
기능 완료	각 요구사항 체크리스트
버그 수정	재현 테스트 결과

3+ Fixes Architecture Rule + Circuit Breaker

동일 버그 3회 수정 실패 시:

Circuit Breaker가 기계적으로 차단 (v2.0: Stop 훅에서 자동 감지)
아키텍처/설계 재검토
Agent Struggle Report 생성 (Failure Classification + Repo 개선 제안)
사용자에게 보고서와 함께 방향 확인

Failure Classification: Repo Gap / Architecture Issue / External Dependency / Requirement Issue / Capability Limit

Orchestrator/Worker Pattern

에이전트 역할 분리를 통한 효율적인 작업 분배:

역할	책임	도구
Orchestrator	작업 분해, 에이전트 스폰, 결과 합성	Task, AskUserQuestion, TaskCreate/Update
Worker	구체적 작업 실행, 결과 보고	Read, Write, Edit, Bash, Grep

Harness Engineering

OpenAI의 Harness Engineering 방법론에서 영감을 받은 에이전트 주도 개발 환경:

핵심 원칙:

Repository as Knowledge Base: 레포 자체가 에이전트의 도메인 지식 원천
Dependency Flow: Types -> Config -> Domain -> Service -> Runtime -> UI 단방향 강제
Struggle = Signal: 에이전트 실패 시 레포에 부족한 것을 진단 (자동 수정 금지)
Codebase GC: 주기적 dead code/import/doc 일관성 점검

Harness Mode (--harness):

Intent -> Scaffold -> Implement -> Verify -> Deliver
  (사용자)   (에이전트+확인)  (에이전트 자율)  (자동검증)   (합류)

Memory Management

Claude Code의 내장 Auto Memory를 활용한 세션 간 연속성:

Auto Memory (~/.claude/projects/<project>/memory/):

프로젝트 패턴, 디버깅 인사이트, 아키텍처 노트 자동 저장
세션 시작 시 MEMORY.md 자동 로드 (첫 200줄)

명시적 저장 요청:

"이 프로젝트는 pnpm 사용한다고 기억해"
"API 테스트는 로컬 Redis 필요하다고 저장해"

CLAUDE.md 계층:

용도	위치
팀 공유 규칙	`./CLAUDE.md`, `.claude/rules/`
개인 전역	`~/.claude/CLAUDE.md`
개인 프로젝트	`./CLAUDE.local.md`

Package Management Rules

프로젝트별 패키지 매니저 강제:

언어	필수	금지
Python	uv	pip, poetry, pipenv
Node.js	pnpm	npm, yarn

자동 감지: requirements.txt, poetry.lock, package-lock.json, yarn.lock 발견 시 마이그레이션 제안
Dockerfile/CI 패턴 예시 포함

Configuration

Language

기본값: 한국어

CLAUDE.md에서 변경:

## Language
- **ALWAYS respond in English**

Skill Rules Customization

.claude/skill-rules.json에서 스킬 자동 활성화 규칙을 편집할 수 있습니다.

Hooks Customization

config/settings.json의 hooks 섹션에서 훅 스크립트 추가/제거 가능.

StatusLine

scripts/statusline.sh를 수정하여 표시 항목 커스터마이즈.

Config Validation

/config-doctor    # 설정 유효성 검증

Updating

# Plugin 방식
/plugin update superclaude-plusplus

# Manual 방식
cd superclaude-plusplus
git pull
scripts/sync-global.sh

Uninstall

# Plugin 방식
/plugin uninstall superclaude-plusplus

# Manual 방식
rm -rf ~/.claude

Requirements

Claude Code CLI (>= 2.1.0)
Claude Max/Pro 구독 또는 Anthropic API 키
macOS/Linux (Windows는 WSL 권장)
Python 3 (skill-matcher.py, injection-scanner.py 실행용)
jq (선택사항, 일부 스크립트에서 사용)

Contributing

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes
Push to the branch
Open a Pull Request

Credits & Acknowledgements

Special Thanks

이 프로젝트는 SuperClaude Framework의 뛰어난 기반 위에 구축되었습니다. SuperClaude 팀의 혁신적인 접근 방식과 잘 설계된 아키텍처 덕분에 이 확장이 가능했습니다.

"거인의 어깨 위에 서서 더 멀리 본다" - SuperClaude가 그 거인입니다.

Inspirations & Integrations

SuperClaude Framework - 핵심 프레임워크 구조 및 모드 시스템
Karpathy Guidelines - LLM 코딩 행동 규칙 (Think Before Coding, Simplicity First, Surgical Changes, Goal-Driven Execution). Andrej Karpathy의 관찰에서 파생
Harness Engineering - OpenAI의 에이전트 주도 개발 방법론 (Repository as Knowledge Base, Dependency Flow, Struggle = Signal, Codebase GC). Martin Fowler의 분석 참조
UI UX Pro Max - BM25 기반 UI/UX 디자인 인텔리전스 (67 스타일, 96 팔레트, 57 폰트, 100 추론 규칙, 13 스택). MIT License
Antigravity Kit - Gemini 대상 AI 에이전트 프레임워크. Brainstorming Questioning Principles (결과 드러내는 질문, 트레이드오프 명시, 기본값 제공), 우선순위 기반 검증 파이프라인 (checklist.sh 영감). MIT License
oh-my-agent - 멀티 에이전트 하네스의 공유 프로토콜 (_shared/). 난이도 분기(difficulty-guide), 추론 템플릿(reasoning-templates), 컨텍스트 예산(context-budget/loading), 4요소 프롬프트(prompt-structure), Phase Gate 자동통과(phase-gates), Cascade Impact Review(multi-review-protocol), Clarification Debt(session-metrics). MIT License
oh-my-claudecode - 자동화 훅 및 워크플로우 아이디어
cc-statusline - 상태바 구현 참고
gstack - Garry Tan의 Claude Code 스킬팩. Search Before Building 원칙, AI Slop Detection 체크리스트, LLM Security Audit Phase (프롬프트 인젝션, 스킬 서플라이 체인). MIT License
everything-claude-code - Affaan Mustafa의 에이전트 하네스 시스템. TDD RED/GREEN Gate 워크플로우, 구조화된 Session Save (What Did NOT Work), Confidence-Based Review Filtering. MIT License
Business Panel - 클래식 비즈니스 문헌 기반 전문가 패널 방법론 (Christensen, Porter, Drucker 등)

What's New in v2.0

SuperClaude++ v2.0 = v0.x + 시스템 강제 패러다임:

Skill Auto-Activation: skill-rules.json + UserPromptSubmit 훅으로 스킬 자동 트리거
AGENT.md Frontmatter: model, tools, maxTurns, effort, isolation 선언적 정의
Circuit Breaker: 동일 에러 3회 반복 시 기계적 자동 차단
Prompt Injection Scanner: MCP 응답 실시간 보안 스캔
Worktree Isolation: 병렬 에이전트 Git worktree 격리 실행
Generator+Validator 패턴: 생성/검증 관심사 분리 에이전트 쌍
Agent Teams: 팀 단위 자율 작업 지원 (실험적)
Dynamic Context Injection: 스킬에 실시간 상태 주입
Plugin Manifest: /plugin install로 설치 자동화
120개 Skills: commands/ 통합으로 단일 디렉토리 체계
23개 Agents: Generator, Validator, Harness Worker, Team 에이전트 추가
16개 Hook Types: TaskCompleted, FileChanged, ConfigChange 등 전체 활용
신규 스킬: /fix-pr (PR 코멘트 자동 수정), /config-doctor (설정 검증)

What's Carried from v0.x

PDCA 워크플로우 및 Gap Analysis
Orchestrator/Worker 패턴 및 에이전트 에러 복구
Proactive Suggestion (스킬/에이전트/MCP 적극 제안)
Auto Memory 활용 (Claude Code 내장 기능)
Two-Stage Review, Verification Iron Law, 3+ Fixes Rule
oh-my-agent 프로토콜 (난이도 분기, 추론 템플릿, 컨텍스트 예산)
Karpathy Guidelines (가정 투명성, 수술적 변경, 코드 단순성)
Harness Engineering (Agent Struggle Report, Dependency Flow, codebase-gc)
Note 시스템, UI/UX Pro Max, peon-ping 사운드 알림
gstack 통합 (Search Before Building, AI Slop Detection, LLM Security Audit)
ECC 통합 (TDD RED/GREEN Gate, Session Save, Confidence-Based Review Filtering)
패키지 관리 규칙 강제 (uv/pnpm)
한국어 응답 지원 (config/skill 파일은 영어 - 토큰 효율 30-40% 향상)

참고 출처 (v2.0)

v2.0의 설계와 기능은 다음 소스에서 영감을 받았습니다:

커뮤니티 생태계

awesome-claude-code — Claude Code 생태계 큐레이션 리스트. 생태계 분석의 출발점.
Claude Code Infrastructure Showcase — Hook 기반 Skill Auto-Activation 패턴 (skill-rules.json 설계의 핵심 참조)
Trail of Bits Security Skills — Static analysis 통합, injection 방어 패턴 참조
cc-devops-skills — Generator + Validator 쌍 패턴 참조
Ralph for Claude Code — Circuit Breaker 패턴 참조
Superpowers — Subagent-Driven Development, Two-Stage Review 패턴 참조
Compound Engineering Plugin — Compound Learning 루프 참조
Dippy — AST 기반 auto-approve 패턴 참조
parry — Prompt injection scanner 설계 참조
Fullstack Dev Skills — /common-ground (가정 표면화) 패턴 참조

공식 Claude Code 기능 (2026년 4월 기준)

AGENT.md Frontmatter — model, tools, maxTurns, effort, isolation 시스템 강제
Agent Teams (실험적) — 팀원 간 직접 메시징, 공유 태스크 리스트
Worktree Isolation — 서브에이전트별 독립 git checkout
Dynamic Context Injection — ! backtick 구문으로 스킬에 실시간 상태 주입
Effort Level — low, medium, high, max 노력 수준 시스템
26 Hook Types — TaskCompleted, SubagentStop, FileChanged, ConfigChange 등
Plugin System — plugin.json manifest, /plugin install 배포
WebFetch/WebSearch — 내장 웹 도구 활용
/batch Built-in Skill — 대규모 병렬 변경 오케스트레이션

License

MIT License - see LICENSE for details.

Name		Name	Last commit message	Last commit date
Latest commit History 55 Commits
.claude		.claude
agents		agents
config		config
docs		docs
optional		optional
scripts		scripts
skills		skills
templates		templates
.gitignore		.gitignore
.superclaude-metadata.json		.superclaude-metadata.json
CHANGELOG.md		CHANGELOG.md
CLAUDE.md		CLAUDE.md
CONTEXTS.md		CONTEXTS.md
CONVENTIONS.md		CONVENTIONS.md
FLAGS.md		FLAGS.md
KNOWLEDGE.md		KNOWLEDGE.md
LICENSE		LICENSE
MCP_SERVERS.md		MCP_SERVERS.md
MODES.md		MODES.md
PRINCIPLES.md		PRINCIPLES.md
README.md		README.md
RULES.md		RULES.md
notepad.md		notepad.md
plugin.json		plugin.json

Folders and files

Latest commit

History

Repository files navigation

SuperClaude++ v2.0

About

v2.0 패러다임 전환

Features

Core Framework

Agent System (23개)

Skills (120개)

Core Skills

Development Skills

Document Skills

Domain Skills

Automation

Skill Auto-Activation (v2.0 핵심)

Proactive Suggestions

Hook System (16개 타입)

v2.0 안전장치

Sound Notifications (peon-ping)

Flags & Modes

Analysis Depth

MCP Server Flags

Context Modes

Harness Mode

Proactive Suggestion Flags

Installation

Plugin Install (권장)

Manual Install

설치 후

Directory Structure

Key Concepts

v2.0 Core: System-Enforced Automation

Generator + Validator 패턴

Worktree Isolation

Agent Teams (실험적)

PDCA Workflow

Two-Stage Review System

Verification Iron Law

3+ Fixes Architecture Rule + Circuit Breaker

Orchestrator/Worker Pattern

Harness Engineering

Memory Management

Package Management Rules

Configuration

Language

Skill Rules Customization

Hooks Customization

StatusLine

Config Validation

Updating

Uninstall

Requirements

Contributing

Credits & Acknowledgements

Special Thanks

Inspirations & Integrations

What's New in v2.0

What's Carried from v0.x

참고 출처 (v2.0)

커뮤니티 생태계

공식 Claude Code 기능 (2026년 4월 기준)

License

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages