# 사용자 수준 CLAUDE.md 예제

사용자 수준 CLAUDE.md 파일 예제입니다. `~/.claude/CLAUDE.md`에 배치하세요.

사용자 수준 설정은 모든 프로젝트에 전역으로 적용됩니다. 다음 용도로 사용하세요:
- 개인 코딩 선호 설정
- 항상 적용하고 싶은 범용 규칙
- 모듈식 규칙 파일 링크

---

## 핵심 철학

당신은 Claude Code입니다. 저는 복잡한 작업에 특화된 agent와 skill을 사용합니다.

**핵심 원칙:**
1. **Agent 우선**: 복잡한 작업은 특화된 agent에 위임
2. **병렬 실행**: 가능할 때 Task tool을 사용하여 여러 agent를 동시에 실행
3. **실행 전 계획**: 복잡한 작업에는 Plan Mode 사용
4. **테스트 주도**: 구현 전에 테스트 작성
5. **보안 우선**: 보안에 대해 절대 타협하지 않음

---

## 모듈식 규칙

상세 가이드라인은 `~/.claude/rules/`에 있습니다:

| 규칙 파일 | 내용 |
|-----------|------|
| security.md | 보안 점검, 시크릿 관리 |
| coding-style.md | 불변성, 파일 구성, 에러 처리 |
| testing.md | TDD 워크플로우, 80% 커버리지 요구사항 |
| git-workflow.md | 커밋 형식, PR 워크플로우 |
| agents.md | Agent 오케스트레이션, 상황별 agent 선택 |
| patterns.md | API 응답, repository 패턴 |
| performance.md | 모델 선택, 컨텍스트 관리 |
| hooks.md | Hooks 시스템 |

---

## 사용 가능한 Agent

`~/.claude/agents/`에 위치합니다:

| Agent | 용도 |
|-------|------|
| planner | 기능 구현 계획 수립 |
| architect | 시스템 설계 및 아키텍처 |
| tdd-guide | 테스트 주도 개발 |
| code-reviewer | 품질/보안 코드 리뷰 |
| security-reviewer | 보안 취약점 분석 |
| build-error-resolver | 빌드 에러 해결 |
| e2e-runner | Playwright E2E 테스트 |
| refactor-cleaner | 불필요한 코드 정리 |
| doc-updater | 문서 업데이트 |

---

## 개인 선호 설정

### 개인정보 보호
- 항상 로그를 삭제하고, 시크릿(API 키/토큰/비밀번호/JWT)을 절대 붙여넣지 않음
- 공유 전 출력 내용을 검토하여 민감한 데이터 제거

### 코드 스타일
- 코드, 주석, 문서에 이모지 사용 금지
- 불변성 선호 - 객체나 배열을 직접 변경하지 않음
- 큰 파일 소수보다 작은 파일 다수를 선호
- 일반적으로 200-400줄, 파일당 최대 800줄

### Git
- Conventional commits: `feat:`, `fix:`, `refactor:`, `docs:`, `test:`
- 커밋 전 항상 로컬에서 테스트
- 작고 집중된 커밋

### 테스트
- TDD: 테스트를 먼저 작성
- 최소 80% 커버리지
- 핵심 흐름에 대해 단위 + 통합 + E2E 테스트

### 지식 축적
- 개인 디버깅 메모, 선호 설정, 임시 컨텍스트 → auto memory
- 팀/프로젝트 지식(아키텍처 결정, API 변경, 구현 런북) → 프로젝트의 기존 문서 구조를 따름
- 현재 작업에서 이미 관련 문서, 주석, 예제를 생성하는 경우 동일한 지식을 다른 곳에 중복하지 않음
- 적절한 프로젝트 문서 위치가 없는 경우 새로운 최상위 문서를 만들기 전에 먼저 질문

---

## 에디터 연동

저는 Zed을 기본 에디터로 사용합니다:
- 파일 추적을 위한 Agent Panel
- CMD+Shift+R로 명령 팔레트 사용
- Vim 모드 활성화

---

## 성공 기준

다음 조건을 충족하면 성공입니다:
- 모든 테스트 통과 (80% 이상 커버리지)
- 보안 취약점 없음
- 코드가 읽기 쉽고 유지보수 가능
- 사용자 요구사항 충족

---

**철학**: Agent 우선 설계, 병렬 실행, 실행 전 계획, 코드 전 테스트, 항상 보안 우선.
