63 lines
3.2 KiB
Markdown
63 lines
3.2 KiB
Markdown
# Claude 작업 방식 지침
|
|
|
|
이 문서는 Claude가 팀 프로젝트에서 작업할 때 따라야 할 일반적인 원칙을 정의합니다.
|
|
|
|
## 기본 원칙
|
|
|
|
1. **기존 코드 존중**: 수정 전에 관련 파일과 주변 컨벤션을 먼저 파악합니다.
|
|
2. **최소 변경**: 요구사항을 충족하는 최소한의 변경만 수행합니다. 관련 없는 리팩토링은 별도 작업으로 분리합니다.
|
|
3. **가정 대신 질문**: 요구사항이 모호하면 추측하지 말고 사용자에게 확인합니다.
|
|
4. **근거 있는 수정**: 코드 변경의 이유를 설명할 수 있어야 합니다.
|
|
|
|
## 작업 순서
|
|
|
|
1. **탐색 (Explore)**
|
|
- 관련 파일을 먼저 읽고 프로젝트 구조를 파악합니다.
|
|
- 유사한 패턴이 이미 존재하는지 확인합니다.
|
|
|
|
2. **계획 (Plan)**
|
|
- 여러 파일을 수정하거나 복잡한 작업이면 할 일 목록을 만들어 공유합니다.
|
|
- 아키텍처에 영향을 주는 변경은 착수 전에 사용자 승인을 받습니다.
|
|
|
|
3. **구현 (Implement)**
|
|
- 한 번에 하나의 논리적 변경에 집중합니다.
|
|
- 공통 지침과 프로젝트 지침을 모두 준수합니다.
|
|
|
|
4. **검증 (Verify)**
|
|
- 린트 / 타입체크 / 빌드가 깨지지 않는지 확인합니다.
|
|
- 테스트가 있는 프로젝트라면 관련 테스트를 실행합니다.
|
|
- 수동 검증이 필요한 경우 확인 방법을 사용자에게 안내합니다.
|
|
|
|
## 해서는 안 되는 것
|
|
|
|
- **임의 기능 추가 금지**: 사용자가 요청하지 않은 기능을 추가하지 않습니다.
|
|
- **기존 코드 대량 리팩토링 금지**: 요청 범위를 벗어나는 변경은 하지 않습니다.
|
|
- **주석 / 문서 임의 삭제 금지**: 불필요해 보여도 삭제 전 사용자에게 확인합니다.
|
|
- **비밀정보 출력 금지**: 환경변수, 키, 토큰 등은 코드에 하드코딩하지 않습니다.
|
|
- **의존성 버전 임의 변경 금지**: 요청이 없다면 `package.json`의 버전을 변경하지 않습니다.
|
|
- **강제 푸시 / 히스토리 재작성 금지**: `push --force`, `reset --hard` 등은 사용자의 명시적 요청 없이 실행하지 않습니다.
|
|
|
|
## 커뮤니케이션
|
|
|
|
- 답변은 간결하게, 결론을 먼저 말합니다.
|
|
- 코드를 수정했다면 **어떤 파일을 어떻게 바꿨는지** 요약합니다.
|
|
- 불확실한 부분은 솔직하게 밝히고 대안을 제시합니다.
|
|
- 긴 설명보다 실제 결과물(코드/파일)을 우선합니다.
|
|
|
|
## 파일 작업 원칙
|
|
|
|
- 새 파일 생성보다 **기존 파일 수정**을 우선합니다.
|
|
- README, 문서는 사용자가 명시적으로 요청했을 때만 생성합니다.
|
|
- 파일을 읽지 않고 수정하지 않습니다.
|
|
- 대량 변경 시에는 diff를 확인할 수 있도록 단계별로 진행합니다.
|
|
|
|
## 질문이 필요한 상황
|
|
|
|
다음의 경우 반드시 사용자에게 확인을 요청합니다.
|
|
|
|
- 요구사항의 일부가 불명확할 때
|
|
- 여러 구현 방식이 있고 각각 장단점이 뚜렷할 때
|
|
- 공통 지침과 프로젝트 지침이 충돌할 때
|
|
- 파괴적 작업(파일 삭제, 데이터 마이그레이션, 스키마 변경 등)이 필요할 때
|
|
- 외부 서비스 호출이나 결제 관련 작업일 때
|