본문으로 건너뛰기

빌더 스택 · 맥락

프로젝트 메모리 (CLAUDE.md / AGENTS.md)

모든 대화에 자동으로 실리는 프로젝트 설명서

저장소 루트에 두면 에이전트가 작업을 시작할 때 항상 읽는 파일입니다. 빌드 명령, 코드 규칙, 디렉터리 구조처럼 '매번 설명하기 귀찮은 것'을 적어 둡니다.

언제 쓰나

  • 팀이 공유하는 규칙이 있을 때 (예: 테스트는 vitest, 커밋은 한글)
  • 에이전트가 자꾸 틀리는 프로젝트 고유 정보가 있을 때

주의할 점

  • 길이가 길어질수록 뒷부분이 무시될 수 있습니다. 상황별 지식은 스킬로 빼세요.
  • 자주 바뀌는 값(API 키, 일정)은 넣지 마세요.

설정

CLAUDE.mdmarkdown
# 프로젝트 규칙

## 명령
- 개발: `npm run dev`
- 검증: `npm run verify` (타입체크 + 린트 + 빌드)

## 코드 규칙
- 주석은 한국어로, "왜"를 설명한다
- DB 쿼리는 lib/ 아래에만 둔다

## 하지 말 것
- drizzle/ 폴더의 마이그레이션 SQL을 직접 수정하지 않는다

짧게 유지하세요. 핵심만 담고 나머지는 스킬로 분리하는 편이 잘 지켜집니다.

공유

관련해서 올라온 자료

최근 60일 동안 수집된 뉴스·저장소 중 이 주제와 겹치는 것들입니다.