피드로 돌아가기
Dev.toDevOps
원문 읽기
Namespace 격리로 Rule Drift를 원천 차단한 계층형 Harness 설계
Org rules and project rules need different homes
AI 요약
Context
프로젝트별 설정 파일(CLAUDE.md)에 조직 공통 규칙과 개별 프로젝트 규칙이 혼재되어 발생하는 관리 복잡도 증가. 수동 복제 방식의 규칙 전파로 인해 버전 관리 불능 및 설정 파일의 신뢰도 하락 문제 발생.
Technical Solution
- Level 2(Project)와 Level 3(Org)를 분리한 계층적 파일 시스템 구조 설계
harness/policies/경로에 Namespace 기반의 독립적 저장소 매핑으로 조직 규칙 격리- Lockfile 내 파일 해시 기록을 통한 로컬 수정 감지 및 업데이트 충돌 방지 로직 구현
- Guide(실행 규칙)와 Corpus(추론 근거)의 이원화를 통한 LLM Agent의 토큰 소비 최적화
- Installer 수준의 쓰기 권한 제한을 통해 Policy 파일의 임의 변경 및 오염 차단
- Strict 플래그 도입으로 준거성, 보안 등 타협 불가 규칙에 대한 강제적 우선순위 부여
실천 포인트
1. 공통 규칙과 개별 규칙이 동일 파일에 존재하는지 점검
2. 규칙의 전파 방식이 수동 복제인지 자동화된 배포 체계인지 확인
3. LLM 프롬프트 구성 시 '실행 지침'과 '상세 배경'을 분리하여 토큰 비용 최적화 검토
4. 정책 변경 시 강제 업데이트가 필요한 'Strict' 항목의 정의 여부 결정