user-CLAUDE.md
이것은 사용자 레벨의 CLAUDE.md 파일 예시입니다. ~/.claude/CLAUDE.md에 배치하세요.
사용자 레벨 설정은 모든 프로젝트에 전역적으로 적용됩니다. 다음 용도로 사용하세요:
- 개인적인 코딩 선호도 설정
- 항상 강제하고 싶은 범용 규칙
- 모듈화된 규칙들에 대한 링크
핵심 철학
당신은 Claude Code입니다. 저는 복잡한 작업을 위해 전문화된 에이전트와 스킬을 사용합니다.
주요 원칙:
- 에이전트 우선 (Agent-First): 복잡한 작업은 전문 에이전트에게 위임함
- 병렬 실행 (Parallel Execution): 가능할 경우 여러 에이전트와 함께 Task 도구 사용
- 실행 전 계획 (Plan Before Execute): 복잡한 작업에는 Plan 모드 사용
- 테스트 주도 (Test-Driven): 구현 전에 테스트 작성
- 보안 우선 (Security-First): 보안에 있어서는 절대 타협하지 않음
모듈형 규칙 (Modular Rules)
상세 가이드라인은 ~/.claude/rules/에 있습니다:
| 규칙 파일 | 내용 |
|---|---|
| security.md | 보안 점검, 비밀 정보 관리 |
| coding-style.md | 불변성, 파일 조직화, 에러 처리 |
| testing.md | TDD 워크플로우, 80% 커버리지 요구사항 |
| git-workflow.md | 커밋 형식, PR 워크플로우 |
| agents.md | 에이전트 오케스트레이션, 에이전트별 사용 시점 |
| patterns.md | API 응답, 리포지토리 패턴 |
| performance.md | 모델 선택, 컨텍스트 관리 |
사용 가능한 에이전트
~/.claude/agents/ 위치:
| 에이전트 | 목적 |
|---|---|
| planner | 기능 구현 계획 수립 |
| architect | 시스템 설계 및 아키텍처 |
| tdd-guide | 테스트 주도 개발 |
| code-reviewer | 품질/보안을 위한 코드 리뷰 |
| security-reviewer | 보안 취약점 분석 |
| build-error-resolver | 빌드 에러 해결 |
| e2e-runner | Playwright E2E 테스팅 |
| refactor-cleaner | 죽은 코드 정리 |
| doc-updater | 문서 업데이트 |
개인 선호도
코드 스타일
- 코드, 주석, 문서에 이모지 사용 금지
- 불변성 선호 - 객체나 배열을 절대 직접 수정하지 말 것
- 적은 수의 큰 파일보다 다수의 작은 파일을 지향함
- 파일당 보통 200-400 라인, 최대 800 라인 제한
Git
- 컨벤셔널 커밋:
feat:,fix:,refactor:,docs:,test: - 커밋 전 항상 로컬에서 테스트 수행
- 작고 집중된 커밋 지향
테스트
- TDD: 테스트를 먼저 작성할 것
- 최소 80% 이상의 커버리지 유지
- 핵심 흐름에 대해 유닛 + 통합 + E2E 테스트 수행
에디터 통합
저는 Zed를 기본 에디터로 사용합니다:
- 파일 추적을 위한 에이전트 패널(Agent Panel) 사용
- 명령 팔레트(Command palette)를 위한 CMD+Shift+R 사용
- Vim 모드 활성화
성공 지표
다음을 달성했을 때 당신은 성공적입니다:
- 모든 테스트 통과 (80% 이상 커버리지)
- 보안 취약점 없음
- 코드가 읽기 쉽고 유지보수 가능함
- 사용자의 요구사항 충족
철학: 에이전트 우선 설계, 병렬 실행, 행동 전 계획, 코드 전 테스트, 언제나 보안 우선.