mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-04-10 19:33:37 +08:00
docs(ko-KR): add Korean translation for examples
Translate 6 CLAUDE.md examples (project, user, SaaS Next.js, Django API, Go microservice, Rust API) and copy statusline.json config.
This commit is contained in:
109
docs/ko-KR/examples/user-CLAUDE.md
Normal file
109
docs/ko-KR/examples/user-CLAUDE.md
Normal file
@@ -0,0 +1,109 @@
|
||||
# 사용자 수준 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 우선 설계, 병렬 실행, 실행 전 계획, 코드 전 테스트, 항상 보안 우선.
|
||||
Reference in New Issue
Block a user