참고) 공식문서 - https://code.claude.com/docs/ko/memory#claude/rules/로-규칙-구성

CLAUDE.md 파일 하나로 메모리를 관리하는 경우, 프로젝트가 커지면
1. 규칙 파일을 생성할 때마다 CLAUDE.md에 import 해줘야되는 파일이 많아져서 관리가 어렵다.
2. 특정 규칙을 API나 특정 디렉토리에만 적용이 불가하다.

특정한 상황에서만 적용할 규칙, Rule을 생성해보자!

Rule 설정

• 특정 프로젝트에만 적용한다면? .claude/rules/ 디렉토리에 마크다운 파일을 배치하자.
• 여기서 관리되는 모든(경로 옵션 설정이 되어있지 않은) .md 파일은 자동으로 프로젝트 메모리에 로드되며,
  .claude/CLAUDE.md와 동일한 우선순위를 갖는다. (경로옵션은 바로 아래에서 설명할 것이다!)

your-project/
├── .claude/
│   ├── CLAUDE.md           # 주 프로젝트 지침
│   └── rules/
│       ├── code-style.md   # 코드 스타일 가이드라인
│       ├── testing.md      # 테스트 규칙
│       └── security.md     # 보안 요구사항

• md 파일을 생성하면 아래와 같이 /memory 입력 시 생성한 지침이 로드된 것을 확인할 수 있다.
  

• 내 PC 전역에 적용한다면? ~/.claude/rules/ 디렉토리에 배치하자.

  • 프로젝트 규칙 전에 로드되어 더 높은 우선순위로 적용된다.
  • 개인적으로 선호하는 코딩 스타일, 선호하는 워크플로우 등을 여기에 작성하면 된다.

    ~/.claude/rules/
	├── preferences.md    # 개인 코딩 선호도
	└── workflows.md      # 선호하는 워크플로우

강력한 기능들

paths frontmatter

---
paths:
  - "src/api/**/*.ts" <-- 이것이 frontmatter. src/api/~ 하위 경로에만 해당 지침을 적용할거야!
---

# API 개발 규칙

- 모든 API 엔드포인트는 입력 검증을 포함해야 합니다
- 표준 오류 응답 형식을 사용합니다
- OpenAPI 문서 주석을 포함합니다

rules 관리 모범사례

1. 각 파일에서는 하나의 주제만 다루자. (예: testing.md, api-design.md)
2. 파일 이름은 직관적으로 짓자
3. 조건부 규칙 사용은 지양하자. (paths frontmatter은 꼭 필요할 때만! 많아지면 관리가 어려움)
4. 관련 규칙을 그룹화 하자 (예: frontend/~, backend/~)

메모리 관리, 언제 무엇을 쓰면 될까?

1. 대부분 프로젝트 메모리 하나면 됨 (./CLAUDE.md 혹은 ./.claude/CLAUDE.md)
2. 추가 지침 내용이 이미 프로젝트 내에 파일로 있다면, import를 통해 가져오기
3. 규칙이 많아져서 CLAUDE.md 파일 내용이 길어질 때에는 rules로 메모리 나누기
4. 특정 디렉토리에만 적용하고 싶다면 rules에 paths frontmatter 사용하기