피드로 돌아가기
Dev.toAI/ML
원문 읽기
공개 CLAUDE.md 492개 분석 결과, AI 에이전트 행동 규칙 준수율 중앙값 25%에 불과
I scored 492 public CLAUDE.md files against a 12-rule baseline. Median: 3/12.
AI 요약
Context
AI 코딩 에이전트의 효율적인 동작을 위해 CLAUDE.md를 통한 행동 지침 제공이 증가하는 추세임. 그러나 대부분의 설정 파일이 단순 프로젝트 설명에 그치거나 필수적인 제어 규칙이 누락되어 에이전트의 무분별한 코드 수정 및 불투명한 실행 결과라는 한계점이 존재함.
Technical Solution
- Keyword-signal matching 기반의 12가지 행동 규칙(Behavior Rules) 베이스라인을 정의하여 준수 여부 정량 측정
- Scope 관리 규칙 도입을 통해 불필요한 코드 리포맷팅 및 대규모 Noise PR 생성 방지
- Tool call 결과의 단일 행 요약 강제를 통한 실행 컨텍스트 추적성 확보
- 에러 발생 시 원문 인용 및 즉시 중단(Stop-and-ask) 로직 설계를 통한 가짜 성공(False Success) 제거
- 코드 작성 전 인접 코드(Adjacent Code) 읽기 규칙을 통한 중복 함수 생성 및 스타일 불일치 해결
- 정규표현식 기반의 Secret Scanning 필터를 적용하여 API Key 등 민감 정보 유출 여부 검증
실천 포인트
- [ ] 버그 수정 시 지정된 Scope 외 파일 수정 금지 명시 - [ ] 모든 Tool call 직후 변경 사항과 대상 파일을 한 줄로 요약하도록 설정 - [ ] 에러 발생 시 패러프레이징 없이 에러 메시지 원문을 출력하고 중단하도록 강제 - [ ] 코드 작성 전 인접 20~40라인의 기존 코드를 우선 읽도록 지시