Ccbuilder

Skill cathy-kim/ccbuilder/skills/ccbuilder

Build and deploy Claude Code extensions (skills, hooks, agents, agent teams, ralph loops, graph workflows, slash commands) and answer questions about Claude Code functionality. Use when (1) creating new Claude Code functionality, setting up .claude infrastructure, creating custom hooks (SessionStart, PreToolUse, PermissionRequest, SubagentStart, SubagentStop, PostToolUseFailure, TeammateIdle, Stop), developing specialized agents, implementing skills, coordinating agent teams, setting up Ralph Loops, or designing graph workflows, OR (2) asking questions about Claude Code features, agent teams, hook patterns, skill development, memory system, modular rules, MCP integration, ralph loop, graph workflow, agentic loop, fresh context pattern, .claude directory structure, progressive disclosure, 500-line rule, OR (3) building programmatic LLM systems with Agent SDK. Includes P1 official documentation references and implementation guides.From its SKILL.md

Install

npx -y skills add cathy-kim/ccbuilder --skill ccbuilder

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

55.5 KB, as published. Nobody here has run it

Claude Code Extension Builder

Version: 2.54.0 Last Updated: 2026-07-26

목적

Claude Code 확장 기능(Skills, Agents, Hooks, Agent Teams) 개발 질문 답변 및 구현 가이드 제공.

인자 처리 규칙

인자: $ARGUMENTS

$ARGUMENTS의 첫 번째 토큰으로 행동을 결정합니다.

(인자 없음) → Welcome

AskUserQuestion 도구로 다음 옵션을 제시하세요: 새 Skill 만들기 / 새 Hook 만들기 / 새 Agent 만들기 / Agent Team 구성 / Ralph Loop 설정 / Skill 평가/벤치마크 / 뭘 어디에 만들지 도와줘 / 질문하기 / 문서 보기

`skill <name>` → Skill 생성

Read references/skills-guide.md
Read references/official/skills.md
<name>용 SKILL.md 스캐폴딩 + references/ 디렉토리 생성
필요 시 references/github/repos/anthropics-skills/에서 공식 Skill 예시 검색

`hook <event>` → Hook 구현

Read references/hooks-guide.md
Read references/official/hooks.md
<event>에 맞는 Hook 코드 생성 + settings.json 등록 안내
필요 시 references/github/repos/hooks-mastery/에서 구현 예시 검색

`agent <name>` → Agent 정의

Read references/subagents-guide.md
Read references/official/subagents.md
<name>용 Agent 정의 파일(.claude/agents/<name>.md) 생성

`team <name>` → Agent Team 구성

Read references/agent-teams-guide.md
Team 아키텍처 설계 (역할 분담, 태스크 의존성)
TeamCreate → TaskCreate → Task 워크플로우 가이드

`ralph <project-name>` → Ralph Loop 설정

Read references/ralph-loop-guide.md
방식 선택 (Simple Bash Loop / Stop Hook / Ralph 프레임워크)
TASK.md, PROGRESS.md, loop.sh 스캐폴딩 생성
필요 시 .claude/hooks/ralph-stop.sh + settings.json Stop Hook 등록

`graph <name>` → Graph Workflow 설계/실행

자연어 → Graph 생성 → 실행까지 일괄 처리. 3단계 이상 + 분기/병렬/반복이 있을 때 사용.

Read references/graph-workflow-guide.md (스키마, 변환 패턴, v2 설계 체크리스트)
요청 분석 → Graph JSON 생성 (v2 체크리스트 필수: state, reads/writes, artifacts, autonomy, adversarial verification)
Graph를 사용자에게 보여주고 확인 → .omc/state/graph/{id}/ 초기화
flow 순서대로 노드 실행: reads 주입→Task()/LLM평가→writes append→artifacts 저장. [A,B]은 병렬, decision은 route_criteria 순서 평가
ralph.enabled면 SCAR 목표까지 Fresh Context 반복 + graph.json 자기 개선
최종 결과 반환

스키마: {id, goal, state, nodes:[{id, do, with, reads, writes, artifacts, autonomy}], flow, limits, ralph} 상세: references/graph-workflow-guide.md | 템플릿: references/graph-templates/

자연어 요구사항 → 컴포넌트 추천

사용자가 "~하고 싶어", "~해줘", "~를 만들어줘" 등 요구사항을 말하면:

Read references/what-goes-where-guide.md
결정 트리와 매핑 테이블을 참고하여 어떤 컴포넌트를 어디에 만들어야 하는지 추천
해당 컴포넌트의 작성 템플릿을 보여주고, 사용자 요구사항에 맞게 내용 채움
컴포넌트가 결정되면 해당 생성 흐름(skill/hook/agent 등)으로 이동

`eval <skill-path>` → Skill 평가

Read references/eval-guide.md
<skill-path> 스킬의 eval 워크플로우 실행 (테스트 → 채점 → 리뷰)

`improve <skill-path>` → Skill 개선

Read references/eval-guide.md
eval 피드백 기반 스킬 개선 → 재평가 루프

`benchmark <skill-path>` → 벤치마크 집계

Read references/eval-guide.md
다수 eval 실행 결과 집계 → pass_rate, 토큰, 시간 통계

`question <query>` 또는 자연어 질문 → 답변

<query>에서 키워드 추출 후 아래 매핑으로 관련 문서 Read:
- skills, skill → references/skills-guide.md + official/skills.md
- hooks, hook, event → references/hooks-guide.md + official/hooks.md
- agent, subagent → references/subagents-guide.md + official/subagents.md
- team, teammate → references/agent-teams-guide.md
- 통합, integration, skill team → references/skill-agent-teams-integration-guide.md
- mcp, server, transport → references/mcp-guide.md + official/mcp.md
- memory, rules, CLAUDE.md → references/memory-rules-guide.md + official/memory-rules.md
- 어디에, 뭘, 어떻게, 선택, 분류 → references/what-goes-where-guide.md
- tool, tools → references/official/tools.md
- orchestrator → references/orchestrator-principles.md
- ralph, loop, repl, fresh context, autonomous → references/ralph-loop-guide.md
- eval, evaluation, 평가, 벤치마크, benchmark → references/eval-guide.md
- graph, workflow, 그래프, DAG, 파이프라인 → references/graph-workflow-guide.md
키워드가 불명확하면 references/github/repos/에서 Grep으로 실제 코드 검색
문서 내용 기반으로 답변 (추측 금지, 근거 명시)

핵심 변경 사항 (v2.1.220)

MCP 확장 (v2.8 강화)

기능	설명
HTTP Transport	권장 transport (`--transport http`), SSE deprecated
Scope 계층	Local > Project (.mcp.json) > User
환경 변수 확장	`${VAR}`, `${VAR:-default}` in .mcp.json
claude mcp serve	Claude Code를 MCP 서버로 노출; `alwaysLoad`: 서버 모든 도구 tool-search 지연 없이 항상 로드 (v2.1.121); 시작 오류 시 최대 3회 자동 재시도 (v2.1.121); stdio 서버에 `CLAUDE_PROJECT_DIR` 자동 제공, plugin config `${CLAUDE_PROJECT_DIR}` 참조 가능 (v2.1.139); `workspace`는 예약된 서버 이름 — 기존 서버 경고 후 스킵 (v2.1.128); stdio 서버 서브프로세스에 `CLAUDE_CODE_SESSION_ID`·`CLAUDECODE=1` env 자동 제공 (v2.1.154); `claude mcp list`/`get` — 미승인 `.mcp.json` 서버 `⏸ Pending approval` 표시 (v2.1.154); `--resume` 시 stdio MCP 서버에도 `CLAUDE_CODE_SESSION_ID` 전달 (v2.1.163); headless stream-json init 이벤트 `mcp_server_errors` — `--mcp-config` 검증 실패로 스킵된 서버 목록, 터미널 실행 시 시작 경고 표시 (v2.1.219); `claude mcp list`/`/mcp` 연결 실패 시 HTTP 상태·오류 텍스트 표시, 값에 숨은 선행/후행 공백 경고 (v2.1.219)
Managed MCP	조직 차원 중앙 관리 (allowedMcpServers/deniedMcpServers/allowedChannelPlugins, v2.1.84); allowlist/denylist `${VAR}` 항목이 settings 파일 env 대신 시작 환경변수·managed-settings env에서 해석 (v2.1.219)
claude.ai MCP connectors	claude.ai MCP 커넥터 사용 (v2.1.46); `ENABLE_CLAUDEAI_MCP_SERVERS=false` 비활성화 (v2.1.63); 로컬 설정과 중복 시 로컬 우선 (v2.1.84); `allowAllClaudeAiMcps` — managed-mcp.json과 함께 claude.ai cloud MCP 커넥터 동시 로드 (v2.1.149)
--channels	MCP 서버가 세션에 메시지 푸시 / 채널 서버가 도구 승인 프롬프트 폰으로 릴레이 (v2.1.80-81)
oauth.authServerMetadataUrl	MCP OAuth 커스텀 메타데이터 URL 지정 (v2.1.69)
MCP OAuth	콜백 포트 충돌·재인증 수정 (v2.1.74); CIMD/SEP-991 (Client ID Metadata Document) 지원 (v2.1.81); RFC 9728 Protected Resource Metadata discovery — 인증 서버 자동 탐색 (v2.1.85)
CLAUDE_CODE_MCP_SERVER_NAME/URL	`headersHelper` 스크립트에서 서버 이름·URL 접근 — 하나의 헬퍼로 다중 서버 처리 (v2.1.85)
MCP 도구 호출 축소	read/search 호출 "Queried {server}" 단일 라인 표시, Ctrl+O 확장 (v2.1.81)
MCP Elicitation	MCP 서버가 세션 중 구조화된 입력 요청 (폼 필드·URL) (v2.1.76)
MCP 컨텍스트 제한	도구 설명·서버 지시문 2KB 상한 — OpenAPI 서버 컨텍스트 팽창 방지 (v2.1.84)
MCP 결과 크기 오버라이드	`_meta["anthropic/maxResultSizeChars"]` 어노테이션 — 도구 결과 최대 500K 확장, DB 스키마 등 대용량 결과 처리 (v2.1.91)
Hook → MCP 직접 호출	`type: "mcp_tool"` 훅으로 MCP 도구 직접 실행 (v2.1.118); 서브에이전트·SDK 재구성 시 서버 병렬 연결 (v2.1.119); MCP 도구 호출 2분 초과 시 자동 백그라운드 전환 — `CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS`로 임계값·비활성화 설정 (v2.1.212)

상세: references/mcp-guide.md

Memory 계층 확장 (v2.8 강화)

계층	설명
Managed Policy	조직 배포 (최고 우선순위); `managed-settings.d/` 드롭인 디렉토리 지원 (v2.1.83)
Project Memory	CLAUDE.md + `@path` imports (5hop 재귀)
Project Rules	`.claude/rules/*.md` + paths: + subdirs + symlinks
User Memory	`~/.claude/CLAUDE.md` + `~/.claude/rules/`
Project Local	`CLAUDE.local.md` (자동 gitignore)
HTML 주석	`<!-- -->` 자동 주입 시 Claude에게 숨김, Read 도구로는 표시 (v2.1.72)
autoMemoryDirectory	Auto Memory 저장 디렉토리 커스텀 경로 지정 (v2.1.74)
메모리 타임스탬프	메모리 파일 최종 수정 시각 자동 기록 — 신선도 판단 지원 (v2.1.75)

상세: references/memory-rules-guide.md

Agent Teams (실험적)

멀티 에이전트 팀 협업 시스템. Team Lead가 Teammate들을 조율하여 병렬 작업 수행. v2.1.72: 팀 에이전트 리더 모델 자동 상속. v2.1.114: 팀메이트 도구 권한 요청 시 권한 다이얼로그 크래시 수정.

TeamCreate → TaskCreate → Task(teammate) → SendMessage → TeamDelete

활성화: settings.json → env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS: "1"

상세: references/agent-teams-guide.md

Task Management (신규)

도구	용도
`TaskCreate`	작업 생성 (subject, description, activeForm)
`TaskUpdate`	상태 변경, 소유자 할당, 의존성 설정
`TaskList`	전체 작업 목록 조회
`TaskGet`	개별 작업 상세 조회

Memory & Modular Rules (신규)

기능	설명
Auto Memory	`~/.claude/projects/<project>/memory/` 영구 저장
MEMORY.md	매 세션 자동 로드 (200줄/25KB 제한, v2.1.83)
Modular Rules	`.claude/rules/*.md` + `paths:` frontmatter로 경로별 규칙 (YAML 리스트 지원, v2.1.84)
Worktree 공유	같은 레포의 git worktree 간 Project config/Auto memory 공유 (v2.1.63)

신규 Hook 이벤트

이벤트	용도
`TeammateIdle`	팀메이트 유휴 상태 (Agent Teams)
`SubagentStart`	서브에이전트 생성 시점
`PostToolUseFailure`	도구 호출 실패 후 — `duration_ms` 포함 (v2.1.119)
`Setup`	초기 설정 (--init, --init-only, --maintenance)
`WorktreeCreate`/`WorktreeRemove`	git worktree 생성/제거 시 (v2.1.50); Create: HTTP hook 지원 → `hookSpecificOutput.worktreePath` 반환 (v2.1.84)
`InstructionsLoaded`	CLAUDE.md / `.claude/rules/*.md` 로드 시 (v2.1.69)
`PostCompact`	컨텍스트 압축 완료 후 (v2.1.76)
`Elicitation`	MCP 서버 사용자 입력 요청 인터셉트 (v2.1.76)
`ElicitationResult`	Elicitation 응답 전송 전 오버라이드 (v2.1.76)
`StopFailure`	API 오류(rate limit·인증 실패)로 턴 종료 시 (v2.1.78)
`MessageDisplay`	어시스턴트 메시지 텍스트 변환·숨김 (v2.1.152)
신규 필드 (v2.1.69): `agent_id`, `agent_type`, `worktree` (모든 이벤트에 추가)	HTTP Hook (v2.1.63): `type: "http"` — URL로 JSON POST

Agent/CLI/Plugin 강화

Agent 필드: isolation: worktree (격리 실행), background: true (백그라운드), model (per-invocation 오버라이드 복원, v2.1.72); 전체 모델 ID (claude-opus-4-5 등) agent frontmatter에서 수용 (v2.1.74); initialPrompt — 에이전트 첫 턴 자동 제출 (v2.1.83)
CLI: claude agents, claude auth login [--console], claude auth status/logout, claude remote-control, --worktree (-w), Ctrl+F (에이전트 종료), --bare (-p 경량화: 훅/LSP/플러그인 비활성화·Auto-memory 끔, API key 필수, v2.1.81), rate_limits statusline 필드 (5시간/7일 rate limit 표시, v2.1.80); auto mode 거부 명령 알림 + /permissions Recent 탭에서 r로 재시도 (v2.1.89); Skill tool로 내장 슬래시 명령(/init, /review, /security-review) 자동 탐색·실행 (v2.1.108); /model 전환 전 미캐시 경고 (v2.1.108); /resume 피커 현재 디렉토리 기본 표시·Ctrl+A 전체 표시 (v2.1.108); 오류 메시지 개선 — rate limit vs plan limit 구분·5xx/529 → status.claude.com·미지원 명령 유사어 제안 (v2.1.108); thinking 표시기 로테이팅 힌트 개선 (v2.1.109); CLI 네이티브 바이너리 스폰으로 전환 (v2.1.113); xhigh effort — Opus 4.7 전용 (v2.1.111); auto mode --enable-auto-mode 플래그 불필요·Max 구독자 Opus 4.7 지원 (v2.1.111); /tui fullscreen 플리커 없는 풀스크린 (v2.1.110); /focus 포커스 뷰 토글 (Ctrl+O는 verbose 전용 분리, v2.1.110); /ultrareview 클라우드 병렬 코드리뷰 (v2.1.111); /less-permission-prompts 읽기 전용 허용 리스트 자동 제안 (v2.1.111); /effort 인터랙티브 슬라이더 (v2.1.111); plan 파일 프롬프트 기반 이름 (v2.1.111); Esc로 /loop wakeup 취소 (v2.1.113); 서브에이전트 스트림 정지 10분 타임아웃 (v2.1.113); Ctrl+U 전체 버퍼 클리어·Ctrl+Y 복원 (v2.1.111); Windows Git Bash 불필요 — 미설치 시 PowerShell 자동 사용 (v2.1.120); claude ultrareview [target] CI/스크립트 비대화형 실행 (--json raw output, exit 0/1, v2.1.120); AI_AGENT env var 서브프로세스 자동 설정 — gh 트래픽 Claude Code 귀속 (v2.1.120); claude project purge [path] — 프로젝트 전체 상태(트랜스크립트·태스크·파일 이력·설정) 삭제, --dry-run·-y·-i·--all 지원 (v2.1.126); /model 피커 게이트웨이 /v1/models 모델 목록 지원 (ANTHROPIC_BASE_URL 게이트웨이 설정 시, v2.1.126); claude auth login OAuth 코드 터미널 붙여넣기 — WSL2·SSH·컨테이너 대응 (v2.1.126); Windows: PowerShell 도구 활성화 시 기본 셸로 PowerShell 사용 (v2.1.126); v2.1.141: claude agents --cwd <path> — 세션 목록 디렉토리 범위 지정; 백그라운드 에이전트(/bg·←←) 현재 permission mode 유지(기본값 revert 방지); /feedback 최근 세션 포함(24시간·7일); Rewind 메뉴 "Summarize up to here" — 최근 컨텍스트 유지하며 이전 대화 압축; auto mode permission dialog permissions.ask 규칙 원인 설명 추가; v2.1.142: claude agents 신규 플래그 --add-dir, --settings, --mcp-config, --plugin-dir, --permission-mode, --model, --effort, --dangerously-skip-permissions — 백그라운드 세션 상세 설정; Fast Mode Opus 4.7 기본 전환 (CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1으로 Opus 4.6 고정 가능); v2.1.143: worktree.bgIsolation: "none" 설정 — 백그라운드 세션 직접 편집 (EnterWorktree 없이, git worktree 비실용적 환경용); CLAUDE_CODE_STOP_HOOK_BLOCK_CAP env var — stop hook 블록 반복 상한 오버라이드 (기본 8회); v2.1.144: /resume 백그라운드 세션 지원 (bg 마커 표시); /model 현재 세션만 적용 — 모델 피커 d로 신규 세션 기본값 설정; /extra-usage → /usage-credits 리네임 (구 명령 유지); v2.1.145: claude agents --json — 실행 중 세션 JSON 목록 출력 (스크립팅·tmux-resurrect·status bar); status line JSON에 GitHub 레포·PR 정보 포함 (감지 시); v2.1.146: /code-review [effort] — /simplify 리네임, 선택적 effort 레벨 지원; auto mode AskUserQuestion 사용자·스킬 명시 의존 시 억제 수정; v2.1.147: 핀된 백그라운드 세션(Ctrl+T) 유휴 시 유지·업데이트 in-place 재시작·메모리 압박 시에만 비핀 세션 후 제거; 자동 업데이트 재시도·상세 오류 카테고리·OS 에러 코드 보고; v2.1.149: /usage 카테고리별 분석(skills·subagents·plugins·MCP 서버별 비용); /diff 상세 뷰 키보드 스크롤; GFM task list 체크박스(- [ ] todo/- [x] done) 렌더링; v2.1.152: /reload-skills 명령 — 세션 재시작 없이 스킬 디렉토리 재스캔; Skills/슬래시 명령 disallowed-tools frontmatter — 스킬 활성 중 특정 도구 제거; Auto mode 옵트인 동의 불필요; v2.1.153: /model 선택 신규 세션 기본값 저장 (s로 현재 세션만 전환); v2.1.154: Opus 4.8 — xhigh effort 기본값, Fast Mode 2x 비용·2.5x 속도; Dynamic Workflows (/workflows) — 수십~수백 에이전트 백그라운드 오케스트레이션; claude agents ! <command> 셸 명령 백그라운드 세션 실행 (claude --bg --exec '<command>'); Lean system prompt 기본값 전환 (Haiku·Sonnet·Opus 4.7 이하 제외); CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE deprecated (2026-06-01 제거); v2.1.157: /terminal-setup VS Code/Cursor/Windsurf GPU 가속 비활성화 (텍스트 깨짐 방지); OTEL_LOG_TOOL_DETAILS=1 — tool_decision 이벤트에 tool_parameters 포함; Workflow keyword trigger 설정 추가 (/config); v2.1.158: Auto mode Bedrock·Vertex·Foundry 지원 (Opus 4.7·4.8, CLAUDE_CODE_ENABLE_AUTO_MODE=1 옵트인); v2.1.160: Dynamic Workflow 트리거 키워드 workflow → ultracode 리네임; acceptEdits 모드 빌드 도구 설정 파일(.npmrc, .yarnrc* 등) 쓰기 전 프롬프트; v2.1.163: requiredMinimumVersion/requiredMaximumVersion managed settings — 버전 범위 밖 시 시작 거부; /plugin list --enabled/--disabled 필터; Skills \$ 이스케이프 — 명령 본문 숫자 앞 리터럴 달러 기호; v2.1.166: fallbackModel 최대 3개 폴백 모델 순서 지정 (--fallback-model 대화형 세션 지원); deny rule tool-name 위치 glob 패턴 지원 ("*" 전체 도구 거부); MAX_THINKING_TOKENS=0/--thinking disabled — Claude API 기본 thinking 모델 비활성화; v2.1.169: --safe-mode/CLAUDE_CODE_SAFE_MODE — CLAUDE.md·플러그인·스킬·훅·MCP 서버 모두 비활성화 (트러블슈팅); /cd 명령 — 프롬프트 캐시 유지하며 세션 작업 디렉토리 변경; disableBundledSkills/CLAUDE_CODE_DISABLE_BUNDLED_SKILLS — 번들 스킬·워크플로우·내장 슬래시 명령 숨김; claude agents --json --all로 완료 세션 포함; id·state 신규 필드; API_FORCE_IDLE_TIMEOUT=0 — Vertex/Foundry 기본 5분 유휴 타임아웃 비활성화 옵트아웃; Claude Fable 5 출시 — Mythos 클래스 모델, 일반 사용 가능 (v2.1.170); Fable 5 모델명 [1m] 접미사 자동 제거 (1M 컨텍스트 기본 포함, v2.1.173); Amazon Bedrock ~/.aws config에서 AWS_REGION 미설정 시 리전 자동 읽기 (v2.1.172); v2.1.206: /cd 디렉토리 경로 자동완성 제안; /doctor CLAUDE.md 트리밍(코드에서 유추 가능한 내용 제거) 제안 체크; /commit-push-pr push 대상 remote 자동 허용 확장(remote.pushDefault 또는 유일 remote); EnterWorktree가 .claude/worktrees/ 외부 worktree 진입 시 확인 요청; v2.1.207: Auto mode Bedrock·Vertex·Foundry opt-in 불필요(disableAutoMode로 비활성화); Bedrock·Vertex·AWS Claude Platform 기본 모델 Opus 4.8로 전환; v2.1.208: 스크린리더 모드(claude --ax-screen-reader, CLAUDE_AX_SCREEN_READER=1, axScreenReader 설정) — 화면낭독기용 플레인 텍스트 렌더링; vimInsertModeRemaps 설정 — jj 등 2키 시퀀스를 Escape로 매핑; CLAUDE_CODE_PROCESS_WRAPPER — 기업 런처 통한 셀프스폰 강제; v2.1.210: 접힌 도구 요약 라인에 실시간 경과 시간 카운터; Write(path)/NotebookEdit(path)/Glob(path) 권한 규칙 시작 경고(Edit(path)/Read(path) 사용 권장); v2.1.211: --forward-subagent-text/CLAUDE_CODE_FORWARD_SUBAGENT_TEXT — 서브에이전트 텍스트·thinking을 stream-json 출력에 포함; "always allow" 권한 규칙이 레포 루트에 저장되어 worktree·세션 간 공유; /usage-credits 조직 관리자 발송 전 확인 요청; vim s/S(문자·라인 치환) NORMAL 모드 지원; v2.1.212: /fork 이제 대화를 새 백그라운드 세션(claude agents 자체 행)으로 복제 — 기존 인라인 서브에이전트 방식은 **/subtask**로 분리; claude auto-mode reset — 기본 auto-mode 설정 복원(확인 프롬프트, --yes 스킵); WebSearch 세션 한도(기본 200회, CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION); 서브에이전트 파견 세션 한도(기본 200회, CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION, /clear로 리셋); claude agents에서 /resume 입력 시 과거 세션(삭제된 세션 포함) 피커 오픈; v2.1.214: EndConversation 도구 — 심각한 악용·탈옥 시도 세션 자체 종료 가능; 장시간 도구 호출 진행 heartbeat 주기적 표시; CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH — OTel 콘텐츠 속성 트런케이션 한도(기본 60KB) 설정; docker(Podman docker shim 포함) 데몬 리다이렉트 플래그(--url, --connection, --identity 등) 명령 권한 프롬프트 추가; v2.1.215: Claude가 /verify·/code-review를 더 이상 자율적으로 실행하지 않음 — 명시적 호출 시에만 실행; v2.1.216: sandbox.filesystem.disabled 설정 — 네트워크 egress 제어는 유지하며 파일시스템 격리만 스킵; v2.1.217: 동시 실행 서브에이전트 상한(기본 20, CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS); emoji shortcode 자동완성(:heart: → ❤️, emojiCompletionEnabled 설정으로 비활성화); --max-budget-usd 한도 도달 시 신규 백그라운드 서브에이전트 스폰 거부 + 실행 중 에이전트 중단; v2.1.218: /code-review가 백그라운드 서브에이전트로 실행되어 대화 컨텍스트를 점유하지 않음(스택된 슬래시 명령을 리뷰 대상으로 유지); /deep-research는 수동 호출 시에만 시작(Claude 자율 실행 안 함); Skill·플러그인 frontmatter boolean 값에 yes/no/on/off/1/0(대소문자 무관) 허용; agent frontmatter 이름에 : 포함 시 거부(플러그인 네임스페이싱 예약 문자); v2.1.219: Claude Opus 5(claude-opus-5) 출시 — 신규 기본 Opus 모델, 1M 컨텍스트, Fast Mode $10/$50 per Mtok; Fast Mode Opus 4.7 제거 — /fast는 Opus 5·Opus 4.8에만 적용; sandbox.network.strictAllowlist 설정 — 미허용 호스트 프롬프트 없이 거부(샌드박스 명령); workflowSizeGuideline 설정 키 — Dynamic workflow 권장 크기를 모든 settings 파일에서 지정 가능(설정 시 /config 행 숨김); Dynamic workflow 기본 크기 가이드라인 medium(15개 미만 에이전트 권장)으로 변경; 실행 중 workflow 상태줄에 현재 기본 크기 표시 + /config 안내; --forward-subagent-text 설정 시 depth-2+ 중첩 서브에이전트도 스트림에 표시(파견한 Agent tool_use id로 키 지정); claude mcp list//mcp 서버 연결 실패 시 HTTP 상태·오류 텍스트 표시; claude --teleport 현재 체크아웃이 세션 레포와 다를 때 어떤 레포를 가리키는지 표시; claude-api 스킬 기본 모델 Opus 5로 전환(Opus 4.8 마이그레이션 경로 포함); 버그 수정: claude -p 중간 스트림 API 오류 발생 시 이미 생성된 텍스트 응답 유실 수정; Fable 모델 행이 stale 캐시로 "Requires usage credits" 오표시되던 버그 수정; /model 피커 병합 Opus 행이 "Opus"로만 표시되던 버그 수정("Opus (1M context)"로 복원); GNU screen 내 copy-on-select가 base64를 터미널에 출력하던 버그 수정; Remote Control 클라이언트 모델 전환·재연결·조직 확인 실패 후 stale fast-mode 상태 표시 버그 수정; Windows CLAUDE_CODE_GIT_BASH_PATH가 bash/sh 바이너리가 아닐 때 무시(경고와 함께) 수정; vim NORMAL 모드에서 빈 프롬프트 ← 키가 에이전트 뷰로 복귀하지 않던 버그 수정; 화면낭독기 모드가 매 키 입력마다 전체 줄을 재작성하던 버그 수정(타이핑 문자만 에코하도록 수정); v2.1.220: 버그 수정 및 안정성 개선
Plugin: settings.json 동봉, 커스텀 npm 레지스트리, macOS plist / Windows Registry managed settings; --plugin-dir 로컬 개발 사본이 마켓플레이스 동명 플러그인 오버라이드 (v2.1.74); ${CLAUDE_PLUGIN_DATA} 플러그인 영속 상태 변수 — 업데이트 후에도 유지 (v2.1.78); CLAUDE_CODE_PLUGIN_SEED_DIR 다중 시드 디렉토리 지원 (: Unix, ; Windows, v2.1.79); source: 'settings' 마켓플레이스 소스 — settings.json 내 플러그인 인라인 선언 (v2.1.80); ref-tracked 플러그인 매 로드 시 재클론으로 최신화 (v2.1.81); Skills/슬래시 명령 effort frontmatter — 모델 effort 레벨 오버라이드 (v2.1.80); 조직 정책(managed-settings.json) 차단 플러그인 설치·활성화 불가 및 마켓플레이스 숨김 (v2.1.85); 플러그인 bin/ 디렉토리 실행 파일 배포 — Bash 도구에서 bare command로 실행 가능 (v2.1.91); disableSkillShellExecution 설정 — Skills/슬래시 명령/플러그인 명령 인라인 셸 실행 비활성화 (v2.1.91); keep-coding-instructions frontmatter 필드 — 플러그인 output style 유지 (v2.1.94); "skills": ["./"] 선언 시 frontmatter name 필드로 호출명 결정 (v2.1.94); 플러그인 monitors 매니페스트 키 — 세션 시작/스킬 invoke 시 백그라운드 모니터 자동 실행 (v2.1.105); 스킬 설명 최대 길이 250 → 1,536자, 초과 시 시작 경고 (v2.1.105); claude plugin prune 고아 의존성 제거·uninstall --prune 연쇄 삭제 (v2.1.121); claude plugin validate $schema·version·description 최상위 허용 (v2.1.120); ${CLAUDE_EFFORT} Skill 콘텐츠에서 현재 effort 레벨 참조 (v2.1.120); /skills 필터 검색박스 (v2.1.121); 루트 레벨 SKILL.md 보유 플러그인 스킬로 자동 노출 (skills/ 서브디렉토리 없을 때, v2.1.142); /plugin 상세 패널·claude plugin details에서 제공 LSP 서버 목록 표시 (v2.1.142); v2.1.143: claude plugin disable 의존성 강제 — 다른 플러그인 의존 시 거부+disable-chain 힌트; claude plugin enable 전이적 의존성 자동 강제 활성화; /plugin 마켓플레이스 브라우즈 예상 컨텍스트 비용 표시; v2.1.145: /plugin Discover·Browse 설치 전 명령·에이전트·스킬·훅·MCP/LSP 상세 미리 보기; 마지막 업데이트 일시 표시; v2.1.152: pluginSuggestionMarketplaces managed 설정 — 조직 마켓플레이스 컨텍스트 팁 허용 리스트; v2.1.154: defaultEnabled: false — 플러그인/마켓플레이스 항목 기본 비활성화 선언; /plugin Discover 탭 디렉토리 연관 플러그인 고정 표시; v2.1.157: .claude/skills 디렉토리 플러그인 자동 로드 (마켓플레이스 불필요); claude plugin init <name> — .claude/skills 스캐폴딩 신규; /plugin 인자 자동완성 (서브커맨드·설치된 플러그인·마켓플레이스 목록); /plugin 마켓플레이스 플러그인 브라우저 검색창 (v2.1.172)
신규 명령: /loop <interval> <prompt> (v2.1.71), /reload-plugins (v2.1.69), /plan <description> 즉시 플랜 모드 (v2.1.72), /branch (v2.1.77, /fork alias 유지), /effort 레벨 설정 (v2.1.76), /copy N N번째 최근 응답 복사 (v2.1.77), /powerup 애니메이션 데모와 함께 Claude Code 기능 인터랙티브 학습 (v2.1.90), /team-onboarding 로컬 Claude Code 사용 이력 기반 팀원 온보딩 가이드 자동 생성 (v2.1.101), /proactive /loop 별칭 (v2.1.105), /recap 세션 복귀 시 컨텍스트 요약 (/config 설정·CLAUDE_CODE_ENABLE_AWAY_SUMMARY 강제, v2.1.108), /undo /rewind 별칭 (v2.1.108), /tui 풀스크린 렌더링 (v2.1.110), /focus 포커스 뷰 (v2.1.110), /ultrareview 클라우드 병렬 코드리뷰 (v2.1.111), /less-permission-prompts 허용 리스트 제안 (v2.1.111); /goal <condition> — 완료 조건 설정, 충족 시까지 자율 실행 (interactive·-p·Remote Control, v2.1.139); /scroll-speed 마우스 휠 속도 라이브 프리뷰 조정 (v2.1.139); /config key=value — 프롬프트에서 모든 설정 즉시 변경 (interactive·-p·Remote Control, v2.1.181)
신규 도구 · env: ExitWorktree (v2.1.72), CLAUDE_CODE_DISABLE_CRON (v2.1.72), CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS (v2.1.74), modelOverrides (v2.1.73), allowRead sandbox 설정 (v2.1.77), 토큰 한도 확대 (Opus 4.6 기본 64k·상한 128k, v2.1.77), CLAUDE_CODE_SUBPROCESS_ENV_SCRUB=1 (서브프로세스 자격증명 제거, v2.1.83), CLAUDE_STREAM_IDLE_TIMEOUT_MS (스트리밍 유휴 타임아웃, 기본 90s, v2.1.84), PowerShell 도구 (Windows 옵트인 프리뷰, v2.1.84), CLAUDE_CODE_MCP_SERVER_NAME/CLAUDE_CODE_MCP_SERVER_URL (headersHelper 다중 서버 구분, v2.1.85), Deep link claude-cli://open?q=… 최대 5,000자 지원 (v2.1.85), 트랜스크립트 /loop·CronCreate 실행 시 타임스탬프 마커 추가 (v2.1.85), CLAUDE_CODE_NO_FLICKER=1 (플리커 없는 alt-screen 렌더링, v2.1.88), MCP_CONNECTION_NONBLOCKING=true (-p 모드 MCP 연결 대기 생략; --mcp-config 서버 5s 제한, v2.1.89), CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE (git pull 실패 시 기존 마켓플레이스 캐시 유지 — 오프라인 환경용, v2.1.90), forceRemoteSettingsRefresh 정책 — CLI 시작 시 원격 managed settings 최신화 강제 (실패 시 종료, v2.1.92), --remote-control-session-name-prefix (Remote Control 세션 이름 호스트명 기반 기본값, v2.1.92), Monitor 도구 — 백그라운드 스크립트 이벤트 스트리밍 (v2.1.98), CLAUDE_CODE_PERFORCE_MODE — 읽기 전용 파일 편집 시 p4 edit 힌트 (v2.1.98), CLAUDE_CODE_USE_MANTLE=1 — Amazon Bedrock Mantle 지원 (v2.1.94), refreshInterval status line 재실행 주기 설정 (초 단위, v2.1.97), workspace.git_worktree status line JSON 필드 (linked worktree 시 설정, v2.1.97), --exclude-dynamic-system-prompt-sections print mode 플래그 (크로스유저 프롬프트 캐시 개선, v2.1.98), CLAUDE_CODE_CERT_STORE=bundled — OS CA 인증서 저장소 신뢰 비활성화 (기본: OS CA 신뢰, v2.1.101), EnterWorktree path 파라미터 — 기존 worktree로 전환 (v2.1.105), WebFetch <style>·<script> 콘텐츠 제거 — CSS 헤비 페이지 컨텍스트 예산 보호 (v2.1.105), ENABLE_PROMPT_CACHING_1H — API key·Bedrock·Vertex·Foundry 1시간 캐시 TTL 옵트인 (ENABLE_PROMPT_CACHING_1H_BEDROCK deprecated·honored, v2.1.108), FORCE_PROMPT_CACHING_5M — 5분 TTL 강제 (v2.1.108), CLAUDE_CODE_ENABLE_AWAY_SUMMARY — 텔레메트리 비활성화 시 recap 강제 (v2.1.108), sandbox.network.deniedDomains — 광역 허용 도메인 내 특정 도메인 차단 (v2.1.113), autoScrollEnabled — 풀스크린 자동 스크롤 비활성화 (v2.1.110), OTEL_LOG_RAW_API_BODIES — API 요청·응답 전체 OTEL 로그 (v2.1.111), CLAUDE_CODE_USE_POWERSHELL_TOOL — PowerShell 도구 옵트인 Linux/macOS (v2.1.111); /usage /cost+/stats 통합 (v2.1.118); custom themes — /theme 명령·~/.claude/themes/·플러그인 themes/ 디렉토리 (v2.1.118); --from-pr GitLab MR·Bitbucket PR·GitHub Enterprise URL 지원 (v2.1.119); prUrlTemplate 설정 — PR 배지 커스텀 URL (v2.1.119); CLAUDE_CODE_HIDE_CWD env var — 시작 로고 cwd 숨김 (v2.1.119); DISABLE_UPDATES env var — 수동 포함 전체 업데이트 차단 (v2.1.118); wslInheritsWindowsSettings 정책 — WSL Windows managed settings 상속 (v2.1.118); claude plugin tag — 버전 검증 포함 릴리스 git 태그 생성 (v2.1.118); status line stdin JSON에 effort.level·thinking.enabled 추가 (v2.1.119); PowerShell 도구 자동 승인 — Bash와 동일 권한 모드 (v2.1.119); vim visual mode v/V (선택·시각적 피드백, v2.1.118); ANTHROPIC_BEDROCK_SERVICE_TIER — Bedrock 서비스 티어 선택 (default·flex·priority), X-Amzn-Bedrock-Service-Tier 헤더 (v2.1.122); CLAUDE_CODE_SESSION_ID — Bash 서브프로세스에 세션 ID 자동 제공 (v2.1.132); CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1 — 풀스크린 렌더러 비활성화, 네이티브 스크롤백 유지 (v2.1.132); --plugin-url <url> — 세션 전용 플러그인 .zip URL 즉시 로드 (v2.1.129); worktree.baseRef (fresh|head) — worktree 브랜치 기준점; fresh 기본값 = origin/<default> (v2.1.133); sandbox.bwrapPath/sandbox.socatPath — Linux/WSL 커스텀 bubblewrap·socat 경로 (v2.1.133); parentSettingsBehavior — admin-tier 'first-wins' | 'merge' (v2.1.133); settings.autoMode.hard_deny — auto mode 무조건 차단 규칙 (v2.1.136); skillOverrides 정상 작동 수정 — off·user-invocable-only·name-only (v2.1.129); CLAUDE_CODE_FORCE_SYNC_OUTPUT=1 — 터미널 동기화 출력 강제 활성화 (v2.1.129); CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE — Homebrew/WinGet 자동 업그레이드 백그라운드 실행 (v2.1.129); ANTHROPIC_WORKSPACE_ID — workload identity federation 토큰 특정 워크스페이스 범위 지정 (v2.1.141); CLAUDE_CODE_PLUGIN_PREFER_HTTPS — SSH 키 없는 환경에서 GitHub 플러그인 HTTPS 클론 (v2.1.141); sandbox.allowAppleEvents — macOS 샌드박스 명령 Apple Events 전송 허용 opt-in (v2.1.181); CLAUDE_CLIENT_PRESENCE_FILE — 마커 파일로 모바일 푸시 알림 억제 (v2.1.181)
Agent: SendMessage — 중단 에이전트 자동 백그라운드 재개 (v2.1.77); Agent tool resume 파라미터 제거 → SendMessage({to: agentId}) 사용 (v2.1.77); --agent <name> built-in agent permissionMode 준수 (v2.1.119); agent frontmatter mcpServers — --agent 세션 MCP 서버 로드 (v2.1.117); 외부 빌드 forked subagents CLAUDE_CODE_FORK_SUBAGENT=1 (v2.1.117); subagent_type 대소문자·구분자 무관 매칭 — "Code Reviewer" → code-reviewer 자동 해석 (v2.1.140); agent view (Research Preview) claude agents — 실행 중·대기·완료 세션 단일 목록 (v2.1.139); /goal <condition> — 완료 조건 충족 시까지 자율 실행 (v2.1.139); 서브에이전트 API 요청에 x-claude-code-agent-id/x-claude-code-parent-agent-id 헤더 + OTEL agent_id/parent_agent_id span 속성 (v2.1.139); v2.1.157: settings.json agent 필드 — dispatched 세션 기본 에이전트 지정; --agent <name> 오버라이드; EnterWorktree Claude 관리 worktree 간 mid-session 전환 지원; Claude 관리 worktree 완료 후 잠금 해제 → git worktree remove/prune 가능; 서브에이전트 재귀 파견 최대 5레벨 — 서브에이전트가 자체 서브에이전트 파견 가능 (v2.1.172); v2.1.217부터 기본값 변경: 서브에이전트는 기본적으로 중첩 서브에이전트를 파견하지 않음 — CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH로 더 깊은 중첩 허용; Task tool mode 파라미터 제거(deprecated·무시) — 서브에이전트는 부모 세션 permission mode 기본 상속 (v2.1.212); v2.1.219부터 기본값 재변경: 서브에이전트가 기본적으로 depth 3까지 중첩 서브에이전트 파견 가능(v2.1.217 기본값 대체) — CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1로 중첩 비활성화

Breaking Changes

$ARGUMENTS.0 → $ARGUMENTS[0], npm install → claude install, SSE → HTTP, Sonnet 4.5 → 4.6, Opus 4/4.1 → 4.6, Effort max 제거 (○ ◐ ●), Agent tool resume 파라미터 제거 → SendMessage({to: agentId}) 사용 (v2.1.77), Windows managed settings 레거시 경로 제거 (v2.1.75), plan mode 컨텍스트 초기화 기본 숨김 ("showClearContextOnPlanAccept": true로 복원 가능, v2.1.81), Windows/WSL 응답 줄 단위 스트리밍 비활성화 (v2.1.81), showThinkingSummaries 기본값 비활성화 — 설정 복원: "showThinkingSummaries": true (v2.1.88), cleanupPeriodDays: 0 검증 오류 — 이전에는 트랜스크립트 영속 비활성화, 이제 명시적 오류 발생 (v2.1.89), --resume picker에서 claude -p/SDK 세션 제외 (v2.1.90), Get-DnsClientCache·ipconfig /displaydns 자동 허용 제거 — DNS 캐시 프라이버시 보호 (v2.1.90), /tag 명령 제거 (v2.1.92), /vim 명령 제거 → /config → Editor mode (v2.1.92), 기본 effort 레벨 medium → high 전환 — API키·Bedrock·Vertex·Foundry·Team·Enterprise 사용자 대상 (v2.1.94); /effort로 조정 가능, Bash deny 규칙 강화 — env/sudo/watch/ionice/setsid 래퍼 명령 매칭 (v2.1.113); Bash(find:*) allow 규칙이 find -exec/-delete 자동 승인 불가 (v2.1.113); macOS /private/{etc,var,tmp,home} 경로 Bash(rm:*) 위험 경로 처리 (v2.1.113); Ctrl+U — 전체 입력 버퍼 클리어로 변경 (Ctrl+Y로 복원, v2.1.111); --print 모드 agent frontmatter 준수 — tools:/disallowedTools: 인터랙티브 모드와 동일 동작 (v2.1.119); vim INSERT Esc 동작 변경 — 대기 메시지를 입력창으로 당기지 않음, 다시 Esc로 중단 가능 (v2.1.119); worktree.baseRef: "fresh" (기본값) — EnterWorktree·--worktree 브랜치 기준이 origin/<default> (v2.1.128의 로컬 HEAD 기반에서 복원, v2.1.133); 미푸시 커밋 유지 시 "head" 설정 필요; /simplify → /code-review [effort] 리네임 (v2.1.146); PowerShell 도구 -ExecutionPolicy Bypass 기본 전달 — 옵트아웃: CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY=1 (v2.1.143); modelPicker:setAsDefault → modelPicker:thisSessionOnly keybinding 리네임 (v2.1.153); Lean system prompt 기본값 전환 — Haiku·Sonnet·Opus 4.7 이하 제외 (v2.1.154); Dynamic Workflow 트리거 workflow → ultracode — 단어 "workflow"는 더 이상 트리거 안 함 (v2.1.160); CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE 제거 — no-op; 대안: /model claude-opus-4-6[1m] 후 /fast on (v2.1.160); acceptEdits 빌드 도구 설정 파일 프롬프트 — .npmrc, .yarnrc*, bunfig.toml, .bazelrc, .pre-commit-config.yaml, .devcontainer/ 등 (v2.1.160), 서브에이전트 기본 중첩 파견 비활성화 — CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH 설정 시에만 중첩 허용, 기존 5레벨 재귀 파견 기본 동작 대체 (v2.1.217), Task tool mode 파라미터 제거 — 서브에이전트가 부모 세션 permission mode 상속 (v2.1.212), /fork가 백그라운드 세션 생성으로 변경 — 기존 인라인 서브에이전트 launch 방식은 /subtask로 분리 (v2.1.212), Claude가 /verify·/code-review를 자동 실행하지 않음 — 명시적 슬래시 명령 호출 필요 (v2.1.215), context: fork 스킬 기본 백그라운드 실행 — opt out: background: false (v2.1.218), 서브에이전트 중첩 파견 기본 depth 3로 복원 — v2.1.217의 "기본 비활성화"를 대체, CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1로 비활성화 (v2.1.219), Fast Mode Opus 4.7 제거 — Opus 5·Opus 4.8에만 적용 (v2.1.219)

Deprecated (사용 중지)

Deprecated	대체 방법
`/output-style` 명령	`/config` 사용 (v2.1.74); 또는 `--system-prompt-file` / `plugins`
`legacy SDK entrypoint`	`@anthropic-ai/claude-agent-sdk`로 마이그레이션
`includeCoAuthoredBy` 설정	새 `attribution` 설정 사용
SSE MCP transport	HTTP (streamable-http) 사용
`TaskOutput` 도구	백그라운드 태스크 출력 파일 경로에 `Read` 사용 (v2.1.83)

확장 기능 유형 요약

유형	용도	컨텍스트	위치
Skill	지식/가이드 주입 + 슬래시 명령	현재 대화 (fork 시 별도)	`.claude/skills/`
Subagent	독립 에이전트 정의	별도 200k	`.claude/agents/`
Agent Team	멀티 에이전트 팀 협업 (신규)	각 Teammate 별도	`~/.claude/teams/`
Hook	워크플로우 제어	-	`settings.json`
Memory	세션 간 지식 영속 (신규)	자동 로드	`~/.claude/projects/*/memory/`
Rules	경로별 규칙 적용 (신규)	자동 로드	`.claude/rules/`
Ralph Loop	자율 개발 루프	매 반복 Fresh	`TASK.md` + `loop.sh`
Graph Workflow	구조화된 실행 계획 (신규)	파일 기반	`.omc/state/graph/`

Quick Reference

Skills 핵심

---
name: my-skill
description: "설명 + 자동 활성화 키워드"
userInvocable: true
argument-hint: "<topic>"
allowed-tools: [Read, Grep, Glob]
---

# My Skill

## 목적
스킬의 목적

## 지침
상세 내용은 references/ 참조

상세: references/skills-guide.md

Hooks 핵심

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Bash|Write",
      "hooks": [{
        "type": "command",
        "command": "./hooks/validate.sh"
      }]
    }],
    "Stop": [{
      "type": "command",
      "command": "./hooks/on-stop.sh"
    }]
  }
}

주요 이벤트: SessionStart, PreToolUse, PostToolUse, Stop, StopFailure, SubagentStop, TeammateIdle, InstructionsLoaded, PostCompact, Elicitation, ElicitationResult, CwdChanged, FileChanged, TaskCreated, PermissionDenied, MessageDisplay, DirectoryAdded (27개) 상세: references/hooks-guide.md

Agent Teams 핵심 (신규)

1. TeamCreate({ team_name: "my-team" })
2. TaskCreate({ subject: "Build API", description: "..." })
3. Task({ subagent_type: "backend", team_name: "my-team", name: "api-dev", prompt: "..." })
4. SendMessage({ type: "message", recipient: "api-dev", content: "..." })
5. TeamDelete()  // 작업 완료 후

활성화: settings.json → env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS: "1"

상세: references/agent-teams-guide.md

Subagents 핵심

---
name: frontend-developer
description: "React/Next.js 개발 전문"
model: sonnet
allowed-tools: [Read, Write, Edit, Bash(npm:*)]
permissionMode: acceptEdits
isolation: worktree            # 격리된 worktree 실행 (v2.1.50)
background: true               # 항상 백그라운드 실행 (v2.1.49)
---

# Frontend Developer Agent

내장 타입: Explore, Plan, general-purpose, Bash, claude-code-guide

CLI: claude agents — 설정된 에이전트 목록 조회

상세: references/subagents-guide.md

Ralph Loop 핵심 (신규)

cat TASK.md PROGRESS.md | claude -p "다음 미완료 작업 수행 후 PROGRESS.md 업데이트. 완료 시 LOOP_COMPLETE 추가"

핵심: 매 반복 Fresh Context(0%) + 파일/Git으로 상태 유지 + 이중 종료 조건

상세: references/ralph-loop-guide.md

시나리오 결정 가이드

조건	선택
장시간 자율 개발 (30분+, 컨텍스트 열화 방지)	Ralph Loop
복잡한 멀티스텝 워크플로우 (조건 분기, 병렬, 반복)	Graph Workflow
반복적으로 같은 지침 필요	Skill
여러 에이전트 병렬 협업	Agent Team
독립적 작업 실행 + 커스텀 에이전트	Subagent → Task
독립적 작업 실행 + 내장 타입	Task (Explore, Plan 등)
그 외	직접 대화에서 처리

프로젝트 구조 예시

.claude/
├── skills/<name>/ ─ SKILL.md (<500줄) + CHANGELOG.md + releases/ + references/
├── agents/<name>.md
├── rules/*.md
└── settings.json

Progressive Disclosure (500줄 규칙)

SKILL.md는 500줄 이하로 유지합니다:

my-skill/
├── SKILL.md          # < 500줄 (개요만)
├── CHANGELOG.md      # 변경 이력
├── releases/         # 버전별 스냅샷
└── references/       # 상세 가이드

상세 참조 문서

기능별 가이드

문서	설명
references/skills-guide.md	Skills 상세 가이드
references/hooks-guide.md	Hooks 상세 가이드
references/subagents-guide.md	Subagents + Plugin 가이드
references/agent-teams-guide.md	Agent Teams 상세 가이드
references/ralph-loop-guide.md	Ralph Loop (자율 개발 루프) 가이드
references/troubleshooting.md	트러블슈팅

Orchestrator Skill 개발

문서	설명
references/orchestrator-principles.md	핵심 원칙, Context Injection
references/orchestrator-skill-creation-guide.md	생성 가이드, 체크리스트

구현 및 품질

문서	설명
references/implementation-guide.md	구현 단계별 가이드
references/review-system.md	스킬 리뷰/검증 시스템
references/skill-subagent-task-guide.md	Skill/Subagent/Task 상세 비교
references/best-practices.md	모범 사례
references/eval-guide.md	Skill 평가, 벤치마크, 개선 루프 가이드
references/graph-workflow-guide.md	Graph Workflow 설계, 변환 패턴, 실행 프로토콜

시스템 가이드

문서	설명
references/mcp-guide.md	MCP 설정 및 활용 가이드
references/what-goes-where-guide.md	요청사항 → 어디에 뭘 적을지 가이드
references/memory-rules-guide.md	Memory & Rules 상세 가이드

공식 문서 레퍼런스 (official/)

문서	설명
references/official/skills.md	Skills 공식 문서 요약
references/official/hooks.md	Hooks 공식 문서 요약 (16 events)
references/official/subagents.md	Sub-agents 공식 문서 요약
references/official/mcp.md	MCP 공식 문서 요약
references/official/memory-rules.md	Memory & Rules 공식 문서 요약
references/official/tools.md	Built-in Tools 레퍼런스 (토큰, 위험도, 권장 조합)

GitHub 레포 & 유즈 케이스 (github/)

문서	설명
references/github/README.md	Tier별 레포 인덱스 (Top 10)
references/github/official-repos.md	Anthropic 공식 레포 (T1)
references/github/ecosystem-collections.md	종합 컬렉션 10k+ (T2)
references/github/specialized-tools.md	특화 도구 & 유즈 케이스 (T3/T4)
references/github/patterns.md	크로스 레포 검증 패턴 10가지

로컬 Submodule 레포 (github/repos/)

Skill, Subagent, Hook 구현 시 아래 로컬 레포에서 실제 코드를 검색하여 참고합니다:

레포	로컬 경로	검색 대상
anthropics/skills	`references/github/repos/anthropics-skills`	공식 Skill 구현 (DOCX, PDF 등)
obra/superpowers	`references/github/repos/obra-superpowers`	TDD, 디버깅, Subagent 워크플로우
everything-claude-code	`references/github/repos/everything-claude-code`	15 agents, 30+ skills, hooks
wshobson/agents	`references/github/repos/wshobson-agents`	112 agents, 16 orchestrators
awesome-claude-code	`references/github/repos/awesome-claude-code`	생태계 디렉토리
awesome-subagents	`references/github/repos/awesome-subagents`	126+ 서브에이전트
awesome-claude-skills	`references/github/repos/awesome-claude-skills`	Skills 비교표, 튜토리얼
awesome-agent-skills	`references/github/repos/awesome-agent-skills`	339+ 멀티에이전트 호환 Skills
hooks-mastery	`references/github/repos/hooks-mastery`	13 Hook events 구현
claude-code-showcase	`references/github/repos/claude-code-showcase`	GitHub Actions, JIRA 워크플로우
claude-code-system-prompts	`references/github/repos/claude-code-system-prompts`	시스템 프롬프트 원문, Tool 스펙

검색 방법:

방법	도구	용도
키워드 검색	`Grep`	정확한 패턴/문자열 매칭
파일 탐색	`Glob`	파일명/경로 패턴 매칭
깊은 분석	`Task(Explore)`	멀티 라운드 탐색 + 관계 파악
시맨틱 검색	`claude-context MCP`	자연어 코드 검색 (설치 필요)

시맨틱 코드 검색 설치 (선택): claude mcp add claude-context (Gemini+Zilliz 또는 Ollama+Milvus)

기타 참조

문서	설명
references/external-resources.md	커뮤니티, 포럼, 블로그 링크

공식 문서 URL (P1 참조)

Skills: https://code.claude.com/docs/en/skills
Hooks: https://code.claude.com/docs/en/hooks
Subagents: https://code.claude.com/docs/en/sub-agents
Slash Commands: https://code.claude.com/docs/en/slash-commands
MCP: https://code.claude.com/docs/en/mcp
Memory: https://code.claude.com/docs/en/memory
Settings: https://code.claude.com/docs/en/settings

Status: 2026-06-18 | Claude Code: v2.1.220+ | Sync: version-sync.md | check-updates.sh