프로젝트 컨텍스트 설계
4. 경계 확장과 흔적 정리7 / 9

접근을 넓히는 것과 설정을 상속하는 것은 다르다

추가 디렉토리의 로딩 비대칭, 자동 메모리의 범위, 로컬 상태 정리

개념 학습 45 XP 9분

모노레포나 사내 공통 패키지를 다루면 --add-dir로 작업 범위를 넓히게 됩니다. 이때 따라오는 것과 따라오지 않는 것이 비대칭입니다 — 그쪽 .claude/skills/의 Skills는 라이브 리로드까지 되며 자동 로드되지만, CLAUDE.md와 rules는 전용 환경 변수 없이는 로드되지 않고 hooks·commands·subagents는 아예 로드되지 않습니다. 자동 메모리도 마찬가지로 범위가 정해져 있습니다. git 저장소 단위로 산출되는 머신 로컬 데이터라 worktree끼리는 공유되고 팀원과는 공유되지 않습니다. 범위를 넓히는 결정과 흔적을 지우는 절차는 한 세트로 정해야 합니다.

설정 종류로드 여부비고
.claude/skills/로드됨라이브 리로드 포함, 보안 검토 필요
플러그인 설정일부만 로드enabledPlugins·extraKnownMarketplaces
CLAUDE.md·rules·CLAUDE.local.md환경 변수 필요CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1
Subagents·commands·output styles로드 안 됨cwd·상위·~/.claude·managed만
Hooks·기타 settings.json 키로드 안 됨cwd의 .claude와 사용자/managed만
--add-dir는 파일 접근 범위를 넓힐 뿐 설정 루트를 만들지 않습니다.
  1. 신뢰 확인붙일 디렉토리의 .claude/skills/를 열어 자동 로드될 스킬을 먼저 검토합니다.
  2. 규칙 로딩 결정그쪽 규칙이 필요하면 전용 환경 변수를 켜서 실행하고 팀 표준으로 문서화합니다.
  3. 메모리 감사자동 메모리 폴더를 열어 민감 정보와 팀에 공유해야 할 지식을 분류합니다.
  4. 흔적 정리claude project purge <path>를 --dry-run으로 확인한 뒤 path를 명시해 실행합니다.
이전