mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-04-01 22:53:27 +08:00
526a9070e6
Translate 6 CLAUDE.md examples (project, user, SaaS Next.js, Django API, Go microservice, Rust API) and copy statusline.json config.
110 lines
3.6 KiB
Markdown
110 lines
3.6 KiB
Markdown
# 사용자 수준 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 우선 설계, 병렬 실행, 실행 전 계획, 코드 전 테스트, 항상 보안 우선.
|