저장소 루트에 두면 에이전트가 작업을 시작할 때 항상 읽는 파일입니다. 빌드 명령, 코드 규칙, 디렉터리 구조처럼 '매번 설명하기 귀찮은 것'을 적어 둡니다.
언제 쓰나
팀이 공유하는 규칙이 있을 때 (예: 테스트는 vitest, 커밋은 한글)
에이전트가 자꾸 틀리는 프로젝트 고유 정보가 있을 때
주의할 점
길이가 길어질수록 뒷부분이 무시될 수 있습니다. 상황별 지식은 스킬로 빼세요.
자주 바뀌는 값(API 키, 일정)은 넣지 마세요.
설정
CLAUDE.mdmarkdown
# 프로젝트 규칙
## 명령
- 개발: `npm run dev`
- 검증: `npm run verify` (타입체크 + 린트 + 빌드)
## 코드 규칙
- 주석은 한국어로, "왜"를 설명한다
- DB 쿼리는 lib/ 아래에만 둔다
## 하지 말 것
- drizzle/ 폴더의 마이그레이션 SQL을 직접 수정하지 않는다