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

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

"어떤 지식을 공통 코드베이스에 둘지, 어떤 건 특정 개발 워크플로우용 로컬 설정 파일에 둘지 가른다" — 모든 지식이 같은 계층에 살면 안 된다
계층 1
팀 공통
커밋됨
CLAUDE.md
@docs/
모두에게 공통되는 지식
  • 디렉토리 정책
  • Golden Rules
  • 결제 정책 · 도메인 룰
  • 아키텍처 결정 (ADR)
계층 2
프로젝트 로컬
프로젝트별
.claude/
.cursorrules
.cloud
프로젝트 환경에 종속
  • 빌드 명령어
  • 환경별 변수
  • 도구 제약사항
  • 워크플로우 설정
계층 3
개인 로컬
GITIGNORE
.local/
.env
개인에게만 해당
  • API 키 · 시크릿
  • 개인 IDE 설정
  • 로컬 머신 경로
  • 개인 단축 명령
지역화된 계층 구조가 — agent의 context를 현재 작업 범위에 맞게 좁혀준다