클로드 코드 대규모 프로젝트 컨텍스트 엔지니어링 - .claude/rules 규칙 쪼개기

Thu, 23 Apr 2026 08:54:52 +0000

CLAUDE.md 많은 규칙을 쌓았더니 클로드가 규칙을 무시합니다 — 80% 줄이고 해결한 방법

클로드 코드(Claude Code)에서 CLAUDE.md 파일에 규칙을 계속 추가하면 어느 순간 클로드가 규칙을 무시하기 시작합니다. 실제로 한 개발자는 모노레포 프로젝트에서 CLAUDE.md가 47,000단어까지 불어나면서 클로드가 점점 느려지고 규칙도 안 따르는 문제를 겪었는데요. 해결법은 단순히 파일을 쪼개는 게 아니라, .claude/rules/ 디렉터리의 프론트매터(frontmatter)를 활용해 필요한 규칙만 필요한 시점에 자동으로 로딩되게 설계하는 것이었습니다.

이 영상에서는 Trigger.dev, CockroachDB 등 실제 오픈소스 프로젝트의 조건부 규칙 구조를 분석하고, 쇼핑몰 예제를 통해 테스트·프론트엔드·API 규칙을 파일 패턴별로 분리하는 방법을 단계별로 보여드립니다. 지금 여러분의 CLAUDE.md에 파일 종류별 규칙이 섞여 있다면, 이 영상 하나로 클로드 코드 메모리 관리가 확실히 달라지는 걸 체감할 수 있습니다.

⏱️ 타임라인
00:00 CLAUDE.md 규칙이 무시되는 원인 분석
01:02 CLAUDE.md 메모리 파일 작성 핵심 원칙
01:31 프로젝트 규모가 커지면 규칙이 묻히는 이유
02:29 클로드 코드 메모리 관리 3가지 전략 소개
03:50 조건부 규칙 로딩: .claude/rules/ 디렉터리 활용법
05:11 프론트매터(frontmatter) 패턴 작성법
05:41 오픈소스 사례: Trigger.dev 조건부 규칙 구조
07:07 오픈소스 사례: CockroachDB 개인정보 보호 규칙
07:48 쇼핑몰 예제로 배우는 조건부 규칙 설계
09:00 조건부 규칙 전략 핵심 정리와 실천 팁
10:01 다음 영상 예고: 디렉터리별 CLAUDE.md 분리 전략

? [구독자 전용] 강의 특가 진행 중
? https://gymcoding.co/vip

? 관련 링크
클로드 코드 공식 문서: https://docs.anthropic.com/en/docs/claude-code
Trigger.dev GitHub: https://github.com/triggerdotdev/trigger.dev
CockroachDB GitHub: https://github.com/cockroachdb/cockroach