CLAUDE.md 계층 아키텍처
같은 이름의
CLAUDE.md가 폴더 위치에 따라 다른 스코프의 규칙으로 해석되는 설계 패턴. 기본(루트) 폴더의CLAUDE.md는 시스템 전체 규칙, 작업 공간(하위 폴더) 내부의CLAUDE.md는 그 공간 한정 규칙으로 자동 분리된다. 폴더 경로가 곧 권한·컨텍스트의 스코프가 되는 구조.
핵심 원칙
Claude Cowork는 매 세션을 시작할 때 현재 작업 폴더 안의 CLAUDE.md를 가장 먼저 확인한다. 이 동작이 두 계층을 자연스럽게 분리한다:
| 계층 | 위치 | 역할 |
|---|---|---|
| 전역(Root) | 코워크/CLAUDE.md | 메모리 시스템, 라우팅 맵, 작업 공간 생성 규칙, 참조 자료 위치 |
| 작업 공간(Workspace) | 코워크/{스튜디오}/CLAUDE.md | 해당 스튜디오의 워크플로우·검수·자동화 규칙 |
전역 CLAUDE.md 4대 섹션
- 메모리 시스템 —
memory.md를 항상 먼저 읽고, “이거 기억해”가 들어오면 누적. - 라우팅 맵 — 작업 유형 → 폴더 매핑. (예: 글톤 → 보이스 스튜디오, 주제·초안 → 블로그 스튜디오, 배포 → 공유 스튜디오)
- 작업 공간 생성 규칙 — “새 작업 공간 만들어 줘” 명령을 표준 폴더 패턴(
CLAUDE.md+memory.md+resources/)으로 자동 생성. - 참조 자료 위치 — 공통 자료가 모이는
라이브러리/경로 명시.
작업 공간 CLAUDE.md 패턴
각 스튜디오의 CLAUDE.md는 해당 도메인의 워크플로우만 다룬다. 전역 규칙을 중복 정의하지 않는다.
예시 (블로그 스튜디오):
- 블로그 정체성: 주제, 주독자, 발행 주기, 평균 글 길이.
- 글 작성 워크플로우: 보이스 원칙 로드 → 주제 중복 체크 → 초안 작성 → 제휴 링크 검토.
- 주제 발굴 규칙: 후보 3개 + 제목·메시지·제휴·검색량 형식.
- 제휴 마케팅 규칙: 글당 최대 3개, 고지문 자동 삽입, 후킹 표현 금지.
- 발행후 처리:
memory.md의 최근 발행 글 섹션에 자동 누적.
왜 분리하는가 — 관심사 분리
마이크로서비스 아키텍처에서 서비스마다 자체 설정과 권한을 갖는 것과 동일한 원칙. 전역에는 시스템 전체에 적용될 보편 규칙만, 작업 공간에는 도메인 특화 규칙만 둔다. 결과:
- 한 작업 공간의 규칙 변경이 다른 작업 공간에 부작용을 일으키지 않는다.
- 새 작업 공간을 추가해도 기존
CLAUDE.md를 건드릴 필요가 없다. - 디버깅 시 어느 계층의 규칙이 작동 중인지 폴더 경로로 즉시 파악된다.
빈 파일 정책
자동 생성되는 작업 공간 CLAUDE.md는 빈 파일로 두는 게 권장된다. 클로드가 임의로 내용을 추측해 채우지 않도록 막아, 사용자가 의도한 규칙만 들어가게 보장한다. (memory.md도 비슷한 이유로 빈 섹션 헤더만 가진 상태로 시작.)