Pillar I · 카테고리 2 · Context 지역화

3 Layer 구조 — 어떤 지식이 어디에?

"Deciding what knowledge belongs in the primary codebase versus local configuration files for specific developer workflows" — 모든 지식이 같은 layer에 살면 안 된다
Layer 1
팀 공통
커밋됨
CLAUDE.md
@docs/
모두에게 공통되는 지식
  • 디렉토리 정책
  • Golden Rules
  • 결제 정책 · 도메인 룰
  • 아키텍처 결정 (ADR)
Layer 2
프로젝트 로컬
프로젝트별
.claude/
.cursorrules
.cloud
프로젝트 환경에 종속
  • 빌드 명령어
  • 환경별 변수
  • 도구 제약사항
  • 워크플로우 설정
Layer 3
개인 로컬
GITIGNORE
.local/
.env
개인에게만 해당
  • API key · 시크릿
  • 개인 IDE 설정
  • 로컬 머신 경로
  • 개인 단축 명령
Localization된 layer 구조가 — agent의 context를 현재 작업 범위에 맞게 좁혀준다