20. 확장 기능 개요¶

[기본 Claude Code]
  ↓
[컨텍스트 로드] CLAUDE.md, Skills
  ↓
[격리된 실행] Subagents, Teams
  ↓
[외부 연결] MCP, Hooks

✅ 언제 쓰나
- 코드리뷰 체크리스트
- 한국어 문법 검사
- 배포 전 확인사항

❌ 언제 안 쓰나
- 여러 파일 읽고 분석해야 할 때
- 다른 관점으로 재분석하고 싶을 때

✅ 언제 쓰나
- 20개 이상 파일 분석
- "이 방식이 맞나?" 다른 관점 필요
- 별도 컨텍스트에서 재분석

❌ 언제 안 쓰나
- 간단한 참조 (오버엔지니어링)
- 실시간 상호작용 필요

✅ 언제 쓰나
- 프로젝트 전역 규칙 ("항상 pnpm 사용")
- 코딩 컨벤션 ("한글 주석 금지")
- 팀 문화 ("커밋 전 검토 필수")

❌ 언제 안 쓰나
- 선택적 워크플로우 (필요할 때만)
- 매번 재협상하는 규칙

✅ 언제 쓰나
- 선택적 기능 (/review, /tdd)
- 커뮤니티 기여 도구
- 특정 상황의 체크리스트

❌ 언제 안 쓰나
- 항상 적용되어야 하는 규칙
- 모든 코드에 필수적인 처리

✅ 언제 쓰나
- "이 코드 리뷰해줘"
- "배포 시 체크할 점 뭐가 있나?"
- "이 PR 보안 취약점 찾아"

구성: Task 1개 → Subagent 1개

✅ 언제 쓰나
- 보안 / 성능 / 테스트 동시 리뷰
- 다각도 분석이 필요한 복잡한 작업
- 병렬 처리로 시간 단축

구성: Task N개 → Team N명 (병렬 실행)

예시:
- 팀1: 보안 검토
- 팀2: 성능 최적화
- 팀3: 테스트 전략
→ 동시 진행

✅ 언제 쓰나
- Figma 설계 조회 (Context7)
- Jira 이슈 생성/수정
- DB 쿼리 결과 필요
- 실시간 웹 검색

특징: Claude가 직접 외부 API 호출

✅ 언제 쓰나
- 한국어 문법 검사 (내부 규칙)
- 코드리뷰 체크리스트 (팀 규칙)
- 배포 전 확인사항 (프로세스)

특징: 외부 데이터 불필요, 프롬프트 기반

CLAUDE.md에서 설정:
- 항상 pnpm 사용
- 커밋 전 타입 체크
- 한국어 응답

Skills로 제공:
- /review: 코드리뷰 체크리스트
- /tdd: 테스트 우선 가이드
- /grammar: 한국어 문법 검사

Skill: "보안 리뷰"
  ├─ 보안 체크리스트 (Skill 내장)
  └─ Jira에 이슈 자동 생성 (MCP 호출)

결과: 보안 문제를 찾고 → Jira에 등록까지 한 번에

Step 1: /code-review (스킬)
  → 기본 체크리스트로 1차 검토

Step 2: 보안 문제 발견
  → Subagent에게 깊이 있는 분석 요청

CLAUDE.md:
- 한글 응답 필수
- 타입 안전성 중시

Subagent 호출:
→ 자동으로 CLAUDE.md 규칙 상속
→ 한글로 응답, 타입 안전한 코드 제시

작업이 들어왔어요
  ↓
[Q1] 모든 세션에 항상 적용되나?
  ├─ YES → CLAUDE.md
  └─ NO ↓
    [Q2] 사용자가 명시적으로 호출하나?
      ├─ YES → Skill
      └─ NO ↓
        [Q3] 다른 파일 많이 읽어야 하나?
          ├─ YES → Subagent
          └─ NO ↓
            [Q4] 여러 역할이 동시에 필요한가?
              ├─ YES → Agent Team
              └─ NO ↓
                [Q5] 외부 서비스 데이터 필요?
                  ├─ YES → MCP
                  └─ NO → 기본 기능으로 충분