피드로 돌아가기
Dev.toDevOps
원문 읽기
Global-Project 계층 구조를 통한 AI Agent Context 최적화
CLAUDE.md: Global vs Project — What Goes Where
AI 요약
Context
사용자 개인의 작업 방식과 프로젝트 공통 규칙이 혼재되어 발생하는 AI Agent의 Context 오염 문제 분석. 규칙의 출처가 불분명할 때 발생하는 협업자 간 경험 불일치 및 설정 충돌이라는 기술적 제약 해결 필요.
Technical Solution
- 사용자 개인의 커뮤니케이션 스타일 및 환경 설정을 담은 ~/CLAUDE.md 글로벌 레이어 설계
- 프로젝트 스택 및 팀 합의 프로세스를 정의한 레포지토리 루트 CLAUDE.md 로컬 레이어 구축
- 글로벌 설정을 로컬 설정이 덮어쓰는 Stack-based Override 메커니즘 적용
- 상충하는 규칙 발생 시 추적 가능성을 확보하기 위한 'overrides ~/CLAUDE.md' 명시적 선언 규격 도입
- 글로벌 파일의 보편적 하드 룰과 로컬 파일의 아키텍처 결정 사항을 분리하여 Context 밀도 향상
실천 포인트
- ~/CLAUDE.md에 개인별 셸 환경, 툴 별칭, 커뮤니케이션 톤 정의 - 프로젝트 CLAUDE.md에 브랜칭 전략, 빌드 명령어, 아키텍처 제약 사항 명시 - 글로벌-로컬 간 규칙 충돌 시 프로젝트 파일 내에 명시적 Override 태그 추가 - grep을 활용해 양측 파일의 공통 명사를 추출하고 설정 모순 여부를 수동 검증