지속적인 지시 워크플로우

제 CLAUDE .md 파일을 작성하겠습니다. 지시 사항을 따르며, 한국어로 번역하고, 모든 자리 표시자, 브랜드/모델 이름, 매개변수 플래그, 코드/JSON 키, 인용된 이미지 내 텍스트를 그대로 보존하며, 구조는 1:1로 유지하고, 대시(-)는 사용하지 않으며(- 사용), 발음 구별 부호를 보존하겠습니다. 출력은 번역문만 제공합니다. --- # CLAUDE.md 이 파일은 Claude(및 유사 AI 어시스턴트)에게 이 프로젝트의 코드베이스에서 작업할 때 따라야 할 **상시 지침**을 제공합니다. ## 프로젝트 개요 이 저장소는 [프로젝트 이름]을(를) 포함합니다. 주요 목표는 [목표 설명]입니다. ## 일반 원칙 1. **정확성 우선**: 추측하지 마십시오. 불확실한 경우 명시적으로 질문하십시오. 2. **일관성 유지**: 기존 코드 스타일, 명명 규칙 및 구조를 따르십시오. 3. **최소 변경**: 요청된 작업에 필요한 최소한의 변경만 수행하십시오. 4. **테스트**: 변경 사항이 기존 테스트를 깨뜨리지 않는지 확인하십시오. 가능하면 새 테스트를 추가하십시오. ## 코드 스타일 - **언어**: [예: Python 3.11+] - **포맷터**: [예: Black, Prettier] - **린터**: [예: Ruff, ESLint] - **타입**: [예: mypy 엄격 모드 사용] ## 명령어 - **의존성 설치**: `pip install -r requirements.txt` - **테스트 실행**: `pytest` - **로컬 실행**: `python main.py` - **빌드**: `npm run build` ## 구조 - `src/`: 소스 코드 - `tests/`: 테스트 파일 - `docs/`: 문서 - `config/`: 구성 파일 (예: `config.yaml`, `.env.example`) ## 작업 흐름 1. **이해**: 요청 사항을 명확히 이해했는지 확인하십시오. 2. **계획**: 변경 사항의 영향을 분석하고 접근 방식을 계획하십시오. 3. **구현**: 코드를 작성하거나 수정하십시오. 4. **검증**: 테스트와 린터를 실행하십시오. 5. **요약**: 변경 사항과 이유를 간결하게 요약하십시오. ## 금지 사항 - `--force` 또는 `-f` 플래그를 사용하여 Git 히스토리를 덮어쓰지 마십시오. - 프로덕션 데이터베이스 또는 자격 증명을 절대 커밋하지 마십시오. - 명시적으로 요청되지 않은 한 코드를 리팩토링하지 마십시오. - `TODO` 또는 `FIXME` 주석을 남기지 마십시오. 대신 즉시 해결하거나 작업 항목으로 기록하십시오. ## 질문 처리 - 모호한 요청은 명확한 질문을 통해 해결하십시오. - 여러 해석이 가능한 경우, 가장 일반적인 해석을 선택하고 가정 사항을 명시하십시오. ## 출력 형식 - 모든 응답은 한국어로 작성하십시오. - 코드 블록과 명령어는 원본 언어(영어)를 유지하십시오. - 대시(-) 대신 하이픈(-)을 사용하십시오. --- 이 지침을 준수하여 일관되고 안전하며 고품질의 코드 기여를 보장하십시오.