feat: 위키 저장소 초기 커밋

- CLAUDE.md 운영 규칙
- wiki/ 정리된 지식 페이지 (Nuxt + Claude Code)
- raw/ 원본 자료
- reference/ Nuxt 4.x 공식 문서

Co-authored-by: Cursor <cursoragent@cursor.com>

raw/claude-code-full-stack-mcp-skills-subagents-hooks.md

@@ -0,0 +1,106 @@
+# Claude Code 전체 스택 이해: MCP, Skills, Subagents, Hooks
+
+> 출처: https://alexop.dev/posts/understanding-claude-code-full-stack/
+> 수집일: 2026-05-13
+
+---
+
+## 개요
+
+Claude Code는 CLI, VS Code, JetBrains, 데스크탑, 웹, iOS 등 다양한 플랫폼에서 AI 에이전트를 오케스트레이션하는 **프레임워크**다. 5개 핵심 컴포넌트가 서로 쌓여서 포괄적인 자동화 시스템을 만든다.
+
+---
+
+## 핵심 컴포넌트 5개
+
+### 1. MCP (Model Context Protocol) — 기반
+
+Claude Code를 외부 도구 및 데이터 소스와 연결하는 **범용 어댑터**.
+
+- `/` slash 명령어로 MCP 서버 기능에 접근
+- HTTP transport + OAuth 2.1 with PKCE 인증 지원 (remote server)
+- ⚠️ MCP 서버는 명시적으로 제공하지 않으면 Claude의 native 도구를 상속하지 않는다
+
+```bash
+claude mcp add  # MCP 서버 연결
+```
+
+### 2. Project Memory (CLAUDE.md) — 영속 컨텍스트
+
+마크다운 파일로 영속적인 프로젝트 컨텍스트 설정. 계층적으로 병합됨:
+**Enterprise → User → Project**
+
+- 코딩 표준, 아키텍처 패턴, 공통 명령어
+- `.claude/rules/`로 별도 파일 분리 가능
+- `CLAUDE.local.md`: 팀 공유 없는 개인 설정
+
+### 3. Skills — 통합 확장 모델
+
+재사용 가능한 워크플로우와 도메인 지식. CLAUDE.md의 모듈화 버전.
+
+frontmatter로 동작 제어:
+- `auto-invoke`: Claude가 컨텍스트 기반으로 자동 적용
+- 사용자가 `/slash-command`로 수동 트리거
+- `disable-model-invocation: true`: 수동 전용 (사이드 이펙트 있는 워크플로우)
+- `context: fork`: 독립 subagent로 실행
+
+### 4. Subagents — 독립 컨텍스트
+
+전문화된 AI 페르소나, 독립 컨텍스트 윈도우.
+
+- "컨텍스트 오염" 방지 (무거운 작업 격리)
+- 2026 업데이트: **worktree isolation** — 여러 subagent가 파일을 병렬 편집 가능
+- 내장 타입: Explore, Plan, General-purpose
+
+### 5. Hooks — 이벤트 기반 강제
+
+`.claude/settings.json`에 설정. 수동 호출 없이 자동 실행.
+
+이벤트 종류:
+- 도구 라이프사이클 (PreToolUse, PostToolUse)
+- 세션 관리
+- 파일 변경
+- 권한
+
+핸들러 타입: command, prompt, HTTP request, async
+
+> PreToolUse hooks는 도구 실행 전 인수를 수정할 수 있다.
+
+---
+
+## 지원 기능
+
+**Plugins**: skills, hooks, 메타데이터를 패키징해서 팀 배포.
+
+**Scheduled Tasks**: 클라우드 인프라에서 cron 스케줄로 실행 — 사용자 없이 반복 자동화.
+
+---
+
+## 용도별 선택 가이드
+
+| 기능 | 사용 시점 |
+|---|---|
+| CLAUDE.md | 영속이 필요한 정적 지식 |
+| Skills | 재사용 워크플로우 (자동/수동) |
+| Subagents | 병렬 실행 및 격리가 필요할 때 |
+| Hooks | 표준 강제, 이벤트 반응 |
+| MCP | 외부 시스템 연동 |
+| Scheduled Tasks | 사용자 없는 반복 작업 |
+
+---
+
+## 실전 워크플로우 예시 (통합)
+
+1. **CLAUDE.md**: 표준 수립
+2. **load-context skill**: 새 채팅 시작 시 컨텍스트 초기화
+3. **documentation skill** (auto-invoke): 구현 후 자동 문서 업데이트
+4. **hooks**: 린팅 강제
+5. **subagents**: 격리된 구현 작업 처리
+
+---
+
+## 핵심 인사이트
+
+> "대부분의 사람들은 기능 한두 개만 쓰고 어떻게 스택으로 연결되는지 보지 못한다."
+>
+> 이 컴포넌트들을 단순한 코딩 도구가 아니라 **컴퓨터 자동화를 위한 통합 시스템**으로 봐야 한다.