피드로 돌아가기
Dev.toAI/ML
원문 읽기
불필요한 규칙 70% 제거를 통한 Agent 컨텍스트 최적화 및 기계적 검증 구조 설계
Creating the Perfect CLAUDE.md
AI 요약
Context
Agent 설정 파일인 CLAUDE.md가 무분별한 규칙 추가로 인해 비대해지며 컨텍스트 윈도우 낭비와 성능 저하 유발. 모호한 자연어 지침 중심의 작성 방식으로 인해 Agent의 일관된 동작 보장이 어려운 한계 존재.
Technical Solution
- Blank-file 접근법을 통한 '없을 때 깨지는 기능' 중심의 최소 규칙 집합 추출
- 모든 규칙을 CI/CD 훅 또는 검증 명령어로 연결하는 Machine-checkable 구조 설계
- 프로젝트 개요, Non-negotiables, Style, Gotchas, Principles 순의 계층적 정보 배치
- Architecture 문서 및 Onboarding 가이드를 분리하여 Agent의 Context Budget 낭비 방지
- AgentLint를 통한 모순된 규칙 및 오래된 경로의 자동 탐지 및 제거 프로세스 도입
- Advisory와 Enforceable 규칙을 명시적으로 구분하여 Agent의 행동 예측 가능성 확보
실천 포인트
1. CLAUDE.md 내의 모든 규칙이 CI 훅이나 스크립트로 검증 가능한지 확인
2. 2주간 사용되지 않거나 영향이 없는 규칙을 제거하는 Pruning 주기 설정
3. 단순 정보성 문서(ADR, README)를 제거하고 Agent가 세션 시작 시 반드시 알아야 할 '행동 강제 사항'만 유지
4. 규칙 개수를 최대 7개 이하의 핵심 원칙으로 제한하여 정보 밀도 유지